Developer Hub

Build with agent-media

REST API, TypeScript & Python SDKs, CLI, MCP server for AI agents, OpenAPI spec, and webhooks. Pick your path.

Code Examples

Real-world snippets you can copy-paste.

Generate a SaaS Review video

TypeScript
import { AgentMedia } from '@agentmedia/sdk';

const client = new AgentMedia({ apiKey: 'ma_YOUR_KEY' });
const job = await client.submitSaasReview({
  product_url: 'https://linear.app',
  prompt: 'Create a concise founder-style review.',
  actor_slug: 'sofia',
  tone: 'excited',
});
console.log(job.job_id);

Batch generate from a list

Python
from agent_media import AgentMedia

client = AgentMedia(api_key="ma_YOUR_KEY")
scripts = [
    "Stop scrolling. This tool changed everything.",
    "I tried every app out there. This one won.",
    "Here's why 10,000 teams switched this month.",
]

jobs = [client.create_video(script=s, actor_slug="sofia") for s in scripts]
for job in jobs:
    print(job["video_url"])

Webhook + downstream processing

curl
curl -X POST https://api.agent-media.ai/v1/generate/ugc_video \
  -H "Authorization: Bearer ma_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "Your ad script here...",
    "actor_slug": "sofia",
    "webhook_url": "https://your-app.com/api/video-ready"
  }'

Generate from CLI in a shell script

bash
#!/bin/bash
# Generate 5 variants with different actors
for actor in sofia marcus adaeze jake emma; do
  agent-media ugc "This product is incredible." \
    --actor "$actor" --style hormozi --sync
done

Published Packages

All packages are open source and available on public registries.

Package
@agentmedia/sdkView →
agent-mediaView →
agent-media-cliView →
@agentmedia/mcp-serverView →
@agentmedia/schemaView →

Frequently Asked Questions

Is agent-media built for developers?

Yes. agent-media is API-first: REST endpoints, TypeScript and Python SDKs, an npm-installable CLI with 30 commands, and an MCP server for Claude Code. None of the major UGC video competitors (MakeUGC, Arcads, Creatify) ship this stack.

What languages can I use to call the API?

Anything that speaks HTTP. Native SDKs for TypeScript and Python. Generate clients for Go, Rust, Java, Ruby, PHP, and others from the OpenAPI spec.

Is there a free tier for developers?

Free API keys with sandbox credits on signup. Production usage starts at $39/mo with the API, CLI, and SDKs all included.

Are the SDKs and MCP server open source?

Yes. Apache-2.0. The TypeScript SDK, Python SDK, CLI, and MCP server are all on GitHub.

Does agent-media work with Claude Code, Cursor, or Windsurf?

Yes. Add the MCP server to any MCP-compatible client and UGC video generation becomes a tool your assistant can call directly.

Ready to build?

Get your API key and generate your first video in under a minute.