> ## 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.

# Edit a talking-head video

> Retakes and pauses cut, hook landed, captions on

`POST /api/v1/runs` with `"recipe": "talking-head-edit"` · MCP `run_recipe`

Retakes and pauses cut, hook landed, captions on

![The same talking-head, no text](https://mediamonster.app/skill-stills/talking-head-edit-before.jpg)

Before

![Talking-head video with the hook NO MORE DEAD AIR in lime and red stacked boxes under her chin](https://mediamonster.app/skill-stills/talking-head-edit.jpg)

After

## What it does

* **Takes:** a video or a recording.
* **Makes:** a video.
* **Price:** 25 credits per minute of the 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. Silence remover](https://docs.mediamonster.app/skills/reference/remove-silences.md)
>
> `remove-silences`

> [card] [2. Cut to a brief](https://docs.mediamonster.app/skills/reference/cut-to-brief.md)
>
> `cut-to-brief`

> [card] [3. Animated text](https://docs.mediamonster.app/skills/reference/animated-text.md)
>
> `animated-text`

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

> [card] [5. Normalise the loudness](https://docs.mediamonster.app/skills/reference/normalise-loudness.md)
>
> `normalise-loudness`

| # | Step | Tool | Settings |
| - | - | - | - |
| 1 | [Silence remover](https://docs.mediamonster.app/skills/reference/remove-silences.md) | `remove-silences` | defaults |
| 2 | [Cut to a brief](https://docs.mediamonster.app/skills/reference/cut-to-brief.md) | `cut-to-brief` | `prompt: Cut false starts, retakes and repeated lines, keeping the best take of each` |
| 3 | [Animated text](https://docs.mediamonster.app/skills/reference/animated-text.md) | `animated-text` | `moments: hook`, `look: auto` |
| 4 | [Add captions](https://docs.mediamonster.app/skills/reference/captions.md) | `captions` | `output: burned`, `style: template-030` |
| 5 | [Normalise the loudness](https://docs.mediamonster.app/skills/reference/normalise-loudness.md) | `normalise-loudness` | `target: streaming` |

## 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/talking-head-edit` 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": "talking-head-edit",
  "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: "talking-head-edit",
    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("talking-head-edit", { 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": "talking-head-edit",
        "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(
    "talking-head-edit",
    url="https://example.com/clip.mp4",
)
print(run)
```

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

## See also

* [`GET /api/v1/recipes/talking-head-edit`](https://mediamonster.app/api/v1/recipes/talking-head-edit) — this recipe live
* [Edit a talking-head video in the app](https://mediamonster.app/recipes/talking-head-edit)
* [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.