> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediamonster.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Podcast to clips

> The best moments, vertical and captioned

`POST /api/v1/runs` with `"recipe": "podcast-to-clips"` · MCP `run_recipe`

The best moments, vertical and captioned

![The same talking-head still with no captions](https://static.mediamonster.app/cdn-cgi/image/format=auto,fit=scale-down,width=1024/gallery-captions.jpg)

Before

![Gen Z YouTuber in a dark RGB-lit studio with Arcade pixel captions, WAIT FOR IT](https://static.mediamonster.app/cdn-cgi/image/format=auto,fit=scale-down,width=1024/gallery-captions-arcade.jpg)

After

## What it does

* **Takes:** a video.
* **Makes:** a video.
* **Price:** 25 credits per minute of the file, plus 63 credits per file. Steps below one that makes several files run once on each, so a dry run is the exact figure.

## The steps

Run top to bottom; each step is handed what the step above made.

> [card] [1. Clips](https://docs.mediamonster.app/skills/reference/clips.md)
>
> `clips`

> [card] [2. Add captions](https://docs.mediamonster.app/skills/reference/captions.md)
>
> `captions`

| # | Step | Tool | Settings |
| - | - | - | - |
| 1 | [Clips](https://docs.mediamonster.app/skills/reference/clips.md) | `clips` | defaults |
| 2 | [Add captions](https://docs.mediamonster.app/skills/reference/captions.md) | `captions` | `output: burned`, `style: pop`, `motion: pop`, `position: bottom` |

## Run it

Run it by name and you get the recipe as it is today. To change a setting, send the `steps` from `GET /api/v1/recipes/podcast-to-clips` with your edits instead. Add `dry_run=true` to price it first.

```bash curl theme={"theme":{"light":"github-dark","dark":"github-dark"}}
# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
curl https://mediamonster.app/api/v1/runs \
  -H "Authorization: Bearer $MEDIAMONSTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "recipe": "podcast-to-clips",
  "url": "https://example.com/clip.mp4"
}'
```

```typescript TypeScript (fetch) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const res = await fetch("https://mediamonster.app/api/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MEDIAMONSTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    recipe: "podcast-to-clips",
    url: "https://example.com/clip.mp4",
  }),
});
const run = await res.json();
console.log(run);
```

```typescript TypeScript (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import { Mediamonster } from "@mediamonster/sdk";

// Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
const mm = new Mediamonster({ apiKey: process.env.MEDIAMONSTER_API_KEY });

const run = await mm.recipes.run("podcast-to-clips", { url: "https://example.com/clip.mp4" });
console.log(run);
```

```python Python (requests) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
import os

import requests

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
res = requests.post(
    "https://mediamonster.app/api/v1/runs",
    headers={"Authorization": f"Bearer {os.environ['MEDIAMONSTER_API_KEY']}"},
    json={
        "recipe": "podcast-to-clips",
        "url": "https://example.com/clip.mp4",
    },
)
print(res.json())
```

```python Python (SDK) theme={"theme":{"light":"github-dark","dark":"github-dark"}}
from mediamonster import Mediamonster

# Try it free with a test key (mm_test_...) from https://mediamonster.app/keys
# Reads MEDIAMONSTER_API_KEY from the environment.
mm = Mediamonster()

run = mm.recipes.run(
    "podcast-to-clips",
    url="https://example.com/clip.mp4",
)
print(run)
```

```json MCP theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "name": "run_recipe",
  "arguments": {
    "recipe": "podcast-to-clips",
    "url": "https://example.com/clip.mp4"
  }
}
```

## See also

* [`GET /api/v1/recipes/podcast-to-clips`](https://mediamonster.app/api/v1/recipes/podcast-to-clips) — this recipe live
* [Podcast to clips in the app](https://mediamonster.app/recipes/podcast-to-clips)
* [Recipes over the API](https://docs.mediamonster.app/api/runs.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.