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

# Social video from a topic

> A topic to a vertical, captioned talking video

`POST /api/v1/runs` with `"recipe": "social-video-from-a-topic"` · MCP `run_recipe`

A topic to a vertical, captioned talking video

> [!NOTE]
>
> Read the script before you post — it's written for you, so check every claim.

## What it does

* **Takes:** nothing — it makes its own file.
* **Makes:** a video.
* **Price:** 5 credits per minute of the file, plus 56 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. Avatar video](https://docs.mediamonster.app/skills/reference/avatar-video.md)
>
> `avatar-video`

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

| # | Step | Tool | Settings |
| - | - | - | - |
| 1 | [Avatar video](https://docs.mediamonster.app/skills/reference/avatar-video.md) | `avatar-video` | `prompt: \{\{topic\}\}`, `script: topic`, `vibe: casual`, `length: 30`, `frame: 9:16`, `avatar: \{\{avatar\}\}` |
| 2 | [Add captions](https://docs.mediamonster.app/skills/reference/captions.md) | `captions` | `output: burned`, `style: pop`, `motion: pop`, `position: bottom` |

## Inputs

Send these as `inputs` on the run. Each `{{name}}` in the steps above is filled with its value.

| Input | Kind | Required | Default |
| - | - | - | - |
| `topic` | long text | yes | — |
| `avatar` | text | yes | — |

`avatar` is an id from `GET /api/v1/avatars` (`list_avatars` over MCP).

## 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/social-video-from-a-topic` 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": "social-video-from-a-topic",
  "inputs": { "topic": "<topic>", "avatar": "<avatar>" }
}'
```

```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: "social-video-from-a-topic",
    inputs: { topic: "<topic>", avatar: "<avatar>" },
  }),
});
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("social-video-from-a-topic", {
  inputs: { topic: "<topic>", avatar: "<avatar>" },
});
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": "social-video-from-a-topic",
        "inputs": {"topic": "<topic>", "avatar": "<avatar>"},
    },
)
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(
    "social-video-from-a-topic",
    inputs={"topic": "<topic>", "avatar": "<avatar>"},
)
print(run)
```

```json MCP theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "name": "run_recipe",
  "arguments": {
    "recipe": "social-video-from-a-topic",
    "inputs": { "topic": "<topic>", "avatar": "<avatar>" }
  }
}
```

## See also

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