agent-media 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.

Create your ad for $1

What you can build

CI/CD ad refresh

GitHub Action calls POST /v2/generate/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.

github-action.yml

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)
          job_id=$(agent-media selfie \
            --description "startup founder, direct energetic tone, studio background" \
            --script "$SCRIPT" \
            --duration 10)
          agent-media status "$job_id" --watch
          curl -X POST "${{ secrets.MARKETING_WEBHOOK }}" -d "job_id=$job_id"
        env:
          AGENT_MEDIA_API_KEY: ${{ secrets.AGENT_MEDIA_API_KEY }}

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/v2/generate/video, a 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 hosted connector (https://api.agent-media.ai/mcp — browser sign-in, no key) or the agent-media MCP block to your client's MCP config. Nine tools become available — generate_video, generate_image, generate_audio, quote, list_models, list_characters, get_run_status, upload_image, rate_run — so your assistant writes the prompt, picks the model from the catalog (or lets model auto pick from recent scored runs) and generates 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.