> 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 kling3 -p "robot dancing" --sync

Check your credits

View your remaining credit balance and current plan.

agent-media credits

Account

Jobs

Models & Info

Billing

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 kling3 -p "ocean waves at sunset" --sync

Image-to-video

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

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

Generation options

Fine-tune your generation with additional flags.

Examples

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

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

agent-media generate flux2-pro -p "portrait of a cyberpunk samurai" --sync

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

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 kling3 -p "automated render" --sync

Install the skill

Copy the SKILL.md file from the agent-media-skill repo into your project:

mkdir -p .claude/skills
cp 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 model for your request, checks your credits, runs the generation, and presents the result — all within your coding session.

Quick setup

Add the MCP server to your Claude Code configuration:

// .claude/settings.json or ~/.claude/settings.json
{
  "mcpServers": {
    "agent-media": {
      "command": "npx",
      "args": ["agent-media-mcp"]
    }
  }
}

Available tools

The MCP server exposes 9 tools:

How it works

The MCP server runs as a stdio process and shells out to the agent-media CLI with the --json flag. It reuses the CLI's authentication, caching, and error handling — no separate configuration needed.