npm release: https://www.npmjs.com/package/agent-media-cli agent-media cli github: https://github.com/gitroomhq/agent-media official website: https://agent-media.ai

agent-media — AI Video & Image Generation

Generate AI-powered videos and images from the terminal using the agent-media CLI.

Prerequisites

The agent-media CLI must be installed and authenticated:

npm install -g agent-media-cli
agent-media login

Verify with agent-media whoami. If not logged in, run agent-media login and follow the OTP flow.

Available Models

Core Commands

Generate media

# Video generation
agent-media generate kling3 -p "A robot walking through a neon-lit city" --sync

# Image generation
agent-media generate flux2-pro -p "Cyberpunk samurai portrait" --sync

# Image-to-video (provide input image)
agent-media generate seedance1 -p "Make it dance" --input ./photo.jpg --sync

# With options
agent-media generate sora2 -p "Ocean waves at sunset" -d 10 -r 1080p --aspect-ratio 16:9 --sync

Flags:

• -p, --prompt — Generation prompt (required)
• -d, --duration — Video duration in seconds
• -r, --resolution — Output resolution (720p, 1080p)
• --aspect-ratio — Aspect ratio (16:9, 9:16, 1:1, etc.)
• --input — Input image for image-to-video
• --sync, -s — Wait for completion and print the output URL
• --json — Output as JSON (for parsing)

Check credits and status

# Credit balance
agent-media credits

# Current plan
agent-media plan

# Job status
agent-media status <job-id>

# List recent jobs
agent-media list
agent-media list --status completed --limit 5

Model info and pricing

# List all models
agent-media models

# Detailed pricing
agent-media pricing
agent-media pricing --model kling3

Job management

# Download a completed job
agent-media download <job-id>

# Retry a failed job
agent-media retry <job-id>

# Cancel a running job
agent-media cancel <job-id>

# Delete a job
agent-media delete <job-id>

Account