Developer Hub
Build with agent-media
REST API, TypeScript & Python SDKs, CLI, MCP server for AI agents, OpenAPI spec, and webhooks. Pick your path.
Quick Start
Choose how you want to integrate.
I want to use the API
REST endpoints with OpenAPI spec and interactive docs.
I want to use the CLI
Generate videos from your terminal in one command.
I want to use the SDK
TypeScript or Python — typed clients with polling built in.
I want to build an AI agent
MCP server for Claude Code, Cursor, and Windsurf.
Resources
API Docs
Interactive reference with Scalar.
TypeScript SDK↗
Typed client on npm.
Python SDK↗
Sync + async on PyPI.
CLI↗
30 commands, one install.
MCP Server↗
6 tools for AI coding assistants (Claude Code, Cursor, Windsurf).
OpenAPI Spec
Auto-generate SDKs in any language.
Webhooks
Async delivery with HTTPS callback.
Changelog
Version history and breaking changes.
Status
Real-time API health.
Code Examples
Real-world snippets you can copy-paste.
Generate a SaaS Review video
TypeScriptimport { 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
Pythonfrom 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
curlcurl -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
donePublished Packages
All packages are open source and available on public registries.
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.