For Developers

AI UGC Generation, Built For Developers.

Skip the dashboards. Generate AI UGC video ads from your terminal, code, or AI agent. REST API on $39/month, CLI with 30 commands, TypeScript + Python SDKs, MCP server for Claude Code, webhooks. Apache-2.0.

View API Docs GitHub

How developers use it

Three patterns shipping today.

CI/CD ad refresh

GitHub Action calls /v1/generate/ugc_video on every product copy change. Webhook posts the URL to your Slack #marketing channel.

AI-agent-driven generation

Add @agentmedia/mcp-server to Claude Code. Tell your assistant "make 10 launch ad variants" — it writes, generates, and reports URLs back into your editor.

In-product video generation

Let your customers click "make a UGC ad of this" in your dashboard. Use webhook callbacks to deliver the finished MP4 back to their account.

Code example

Drop-in for your stack.

github-action.yml · YAML

name: Generate ad on copy change
on:
  push:
    paths: ['marketing/copy.md']

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm install -g agent-media-cli
      - run: |
          SCRIPT=$(cat marketing/copy.md)
          agent-media ugc "$SCRIPT" \
            --actor sofia \
            --duration 10 \
            --style hormozi \
            --webhook-url ${{ secrets.MARKETING_WEBHOOK }}
        env:
          AGENT_MEDIA_API_KEY: ${{ secrets.AGENT_MEDIA_API_KEY }}

FAQ

Frequently Asked Questions

Is there an AI UGC video API I can use as a developer?

Yes. agent-media has a production REST API at https://api.agent-media.ai/v1/generate/ugc_video, native TypeScript SDK (@agentmedia/sdk on npm), Python SDK (agent-media on PyPI), 30-command CLI, and an MCP server (@agentmedia/mcp-server) for Claude Code, Cursor, and Windsurf. Available on the $39/month Creator plan.

Are the SDKs and CLI open source?

Yes. Apache-2.0. Source on GitHub. PRs welcome. The TypeScript SDK, Python SDK, CLI, and MCP server are all open packages on npm and PyPI.

Does the API support webhooks?

Yes. Pass webhook_url in any submit call. agent-media POSTs a job-completion event to that HTTPS endpoint when the video is ready. URLs are SSRF-validated.

How do I integrate with Claude Code, Cursor, or Windsurf?

Add the agent-media MCP block to your client's MCP config (~/.claude.json or equivalent). 6 tools become available: create_video, show_your_app, product_acting_ugc, laptop_ugc, list_actors, get_video_status. Your AI assistant can then generate UGC ads directly from conversations.

What's the rate limit?

10 generate requests per minute, 60 read requests per minute, keyed on user ID inside the JWT or API key. Higher limits available on enterprise plans.

Start shipping in under a minute.

See pricing