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

# UGC ad from a product photo

> A product photo to a captioned vertical video ad

`POST /api/v1/runs` with `"recipe": "ugc-ad-from-a-photo"` · MCP `run_recipe`

A product photo to a captioned vertical video ad

## What it does

* **Takes:** a picture.
* **Makes:** a video.
* **Price:** 5 credits per minute of the file, plus 325 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. UGC ad](https://docs.mediamonster.app/skills/reference/ugc-ad.md)
>
> `ugc-ad`

> [card] [2. B-roll generator](https://docs.mediamonster.app/skills/reference/b-roll.md)
>
> `b-roll`

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

| # | Step | Tool | Settings |
| - | - | - | - |
| 1 | [UGC ad](https://docs.mediamonster.app/skills/reference/ugc-ad.md) | `ugc-ad` | `length: 30`, `frame: 9:16`, `quality: standard` |
| 2 | [B-roll generator](https://docs.mediamonster.app/skills/reference/b-roll.md) | `b-roll` | defaults |
| 3 | [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/ugc-ad-from-a-photo` 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": "ugc-ad-from-a-photo",
  "url": "https://example.com/photo.jpg"
}'
```

```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: "ugc-ad-from-a-photo",
    url: "https://example.com/photo.jpg",
  }),
});
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("ugc-ad-from-a-photo", { url: "https://example.com/photo.jpg" });
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": "ugc-ad-from-a-photo",
        "url": "https://example.com/photo.jpg",
    },
)
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(
    "ugc-ad-from-a-photo",
    url="https://example.com/photo.jpg",
)
print(run)
```

```json MCP theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "name": "run_recipe",
  "arguments": {
    "recipe": "ugc-ad-from-a-photo",
    "url": "https://example.com/photo.jpg"
  }
}
```

## See also

* [`GET /api/v1/recipes/ugc-ad-from-a-photo`](https://mediamonster.app/api/v1/recipes/ugc-ad-from-a-photo) — this recipe live
* [UGC ad from a product photo in the app](https://mediamonster.app/recipes/ugc-ad-from-a-photo)
* [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.