---
title: "UGC video ad API for AI agents | Cuppa AI"
url: https://cuppa.ai/use-cases/ugc-video-ad-api-for-ai-agents
description: "Generate a talking-head UGC-style video ad from a character still, a short voice clip and a 45 to 75 word script, and shortlist real creators for outreach. Studio plan and up."
updated: 2026-11-18
mcp_server: @cuppa-ai/mcp-server@0.2.0
cli: @cuppa-ai/cli@0.1.8
---
# UGC video ad API for AI agents | Cuppa AI

Generate a talking-head UGC-style video ad from a character still, a short voice clip and a 45 to 75 word script, and shortlist real creators for outreach. Studio plan and up.

Prompt: "Use Cuppa to quote a UGC video ad for our protein bar using this character image, voice clip and script, then render it."

## How to do it

- MCP tools: `generate_ugc_ad`, `find_creators`
- CLI: `cuppa brand ugc --script "<45-75 words>" --character <image-url> --voice <voice-url> [--confirm]`
- REST: POST /v1/brand/ugc, POST /v1/brand/creators

1. **Prepare inputs.** A character still URL, a 2 to 15 second voice reference URL and a 45 to 75 word script.
2. **Quote.** Call generate_ugc_ad without confirm_paid; it returns status "quoted" and quote_usd.
3. **Render.** Call generate_ugc_ad again with confirm_paid=true to enqueue it.

Output: A 720p talking-head UGC video, ready for paid social. It is not published automatically.

## Keys and cost

- Provider keys: None to request a quote. Rendering uses Seedance 2.0 Fast at 720p.
- Cost: Every request returns a USD quote first (about $0.07 per second of video); nothing renders until you confirm. Studio, Scale and Enterprise only.
- API, CLI and MCP access is included on every plan, including Solo. Plans from $99/month billed annually.

## FAQ

**Which plans include UGC video?**

Studio, Scale and Enterprise.

**Will it spend money without asking?**

No. It quotes first and only renders with confirm_paid=true (CLI: --confirm).

## Connect an agent



Claude Code:

```bash
claude mcp add cuppa -e CUPPA_API_KEY=cpa-your-key -- npx -y @cuppa-ai/mcp-server
```

Codex:

```bash
codex mcp add cuppa --env CUPPA_API_KEY=cpa-your-key -- npx -y @cuppa-ai/mcp-server
```

Cursor, Claude Desktop, Windsurf (mcp.json):

```json
{
  "mcpServers": {
    "cuppa": {
      "command": "npx",
      "args": [
        "-y",
        "@cuppa-ai/mcp-server"
      ],
      "env": {
        "CUPPA_API_KEY": "cpa-your-key"
      }
    }
  }
}
```

CLI:

```bash
npm i -g @cuppa-ai/cli
cuppa auth login --key cpa-your-key
cuppa auth status
```

REST:

```bash
curl -s https://api.cuppa.ai/v1/sites \
  -H "X-API-KEY: cpa-your-key"
```

Verify: `cuppa auth status` prints your team and key status. In MCP, ask the agent to call `list_sites`; it should return your brands.

---

Index of every Markdown page: https://cuppa.ai/llms.txt · Setup: https://cuppa.ai/developers.md · Pricing: https://cuppa.ai/pricing.md
