> Documentation

Install the CLI

Install agent-media globally via npm.

npm install -g agent-media-cli

Authenticate

Log in with your account. This opens your browser for a one-time password (OTP) verification.

agent-media login

Your first generation

Generate a video with a single command. The --sync flag waits for the result and returns the download URL.

agent-media generate video -p "robot dancing" --sync

Check your credits

View your remaining credit balance and current plan.

agent-media credits

Account

Jobs

Models & Info

Billing

UGC & Subtitles

System

Basic generation

Provide a model slug and a prompt with the -p flag.

agent-media generate <model> -p "your prompt here"

Synchronous mode

Add --sync to wait for the job to complete and receive the download URL directly in your terminal.

agent-media generate video -p "ocean waves at sunset" --sync

Image-to-video

Use --input to provide a reference image for image-to-video generation.

agent-media generate video -p "camera zoom out" --input photo.jpg --sync

Generation options

Fine-tune your generation with additional flags.

Examples

agent-media generate video -p "cinematic drone shot of a forest" --duration 5 --sync

agent-media generate video -p "timelapse of city traffic" --duration 10 --sync

agent-media generate video -p "slow pan right" --input landscape.jpg --sync

Basic UGC generation

Provide a script and the pipeline handles the rest.

agent-media ugc "Ever wonder why some videos go viral? It's not luck..." --sync

AI Script Writer

Skip the script — describe your product and let GPT-4o write it. Costs +5 credits on top of the standard pipeline price.

agent-media ugc -g "A yoga mat with extra grip for hot yoga" --sync

agent-media ugc -g "Sleep tracker app" --product-url https://example.com --sync

With face photo

Add a face photo for talking head scenes. The TTS voice is auto-detected from the face photo when no --voice is specified.

agent-media ugc "Your script here..." --face-url ./photo.png --sync

With persona

Use a saved persona for consistent voice and face across videos.

agent-media ugc "Your script here..." --persona my-brand-voice --sync

Examples

agent-media ugc "Your script text here..." --sync

agent-media ugc "script..." --face-url ./photo.png --sync

agent-media ugc "script..." --broll-images "https://img1.jpg,https://img2.jpg" --sync

agent-media ugc "script..." --dub-language es --sync

agent-media ugc "script..." --face-url ./photo.png --style hormozi --duration 15 --aspect 9:16 --music chill --cta "Follow for more" --sync

UGC options

Add subtitles to any video

Use the subtitle command to add animated subtitles to an existing video or completed job.

agent-media subtitle <video-or-job-id> --style bold --sync

Available styles: hormozi (yellow karaoke highlight), minimal, bold (neon cyan), karaoke (green pop animation), clean (white on dark box), tiktok (huge white text, thick black stroke), neon (cyan text with magenta karaoke glow).

Persona management

Create and manage personas for consistent voice and face across UGC videos.

agent-media persona create --name "brand-voice" --voice ./sample.mp3 --face ./photo.png

agent-media persona list

agent-media persona delete <persona-id>

List your keys

agent-media apikey list

Create a new key

agent-media apikey create --name "my-key"

Revoke a key

agent-media apikey revoke <key-id>

Use in scripts

Set the AGENT_MEDIA_API_KEY environment variable to authenticate without interactive login.

AGENT_MEDIA_API_KEY=ma_xxx agent-media generate video -p "automated render" --sync

Install the Skill

Install using the skills CLI (works with Claude Code, Cursor, Copilot, Cline, and more):

npx skills add yuvalsuede/agent-media-skill

Or install manually — download the SKILL.md and add it to your project:

# Download the skill
curl -o SKILL.md https://raw.githubusercontent.com/yuvalsuede/agent-media-skill/main/SKILL.md

# Add to your Claude Code project
mkdir -p .claude/skills
mv SKILL.md .claude/skills/agent-media.md

What you can do

Once the skill is active, talk to Claude naturally:

How it works

The skill gives Claude full knowledge of every agent-media command, model, and flag. Claude picks the right actor and model for your request, counts script words to match the duration, checks your credits, runs the generation with --sync, and presents the result — all within your coding session.

What Claude does for you

The skill handles the full UGC workflow automatically:

Example session

You: "Make a 10-second UGC review of Postiz with screenshots from their site"

Claude: I'll create a UGC review video for Postiz.
  1. Fetching screenshots from postiz.com...
  2. Picking actor naomi with energetic tone
  3. Writing 25-word script for 10s duration
  4. Running: agent-media ugc "..." --actor naomi --broll --broll-images ... --sync

✓ Video ready: https://...ugc-final.mp4