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

| Slug | Name | Type | Notes |

|------|------|------|-------|

| kling3 | Kling 3.0 Pro | Video | text-to-video/image-to-video, 5-10s, 1080p |

| veo3 | Veo 3.1 | Video | text-to-video/image-to-video, 4-8s, up to 4K |

| sora2 | Sora 2 Pro | Video | text-to-video/image-to-video, 4-25s, 1080p |

| seedance1 | Seedance 1.0 Pro | Video | text-to-video/image-to-video, 2-12s, 1080p |

| flux2-pro | Flux 2 Pro | Image | text-to-image |

| flux2-flex | Flux 2 Flex | Image | text-to-image |

| grok-image | Grok Imagine | Image | text-to-image |

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

agent-media whoami          # Current user
agent-media credits         # Credit balance
agent-media plan            # Current subscription
agent-media subscribe              # Interactive plan/credits menu (waits for confirmation)
agent-media subscribe --plan starter  # Subscribe to a plan directly
agent-media subscribe --credits 500   # Buy a credit pack directly
agent-media subscribe --manage        # Open Stripe billing portal
agent-media apikey list     # List API keys
agent-media apikey create   # Create new API key

Tips

• agent-media subscribe opens Stripe Checkout in the browser then polls for up to 2 minutes until the payment is confirmed, showing the new plan/credits on success.
• Always use --sync when you want to wait for the result and get the output URL.
• Use --json when you need to parse the output programmatically.
• Check agent-media credits before generating to ensure sufficient balance.
• For video, default duration is 5s and default resolution is 720p if not specified.
• Image models don't need duration — just prompt and optionally resolution.
• The --sync flag prints the public URL of the completed media.