video-generate

name	video-generate
description	Generates video from text prompts or animates static images. Use when you need to create videos from descriptions, animate images, or produce video content using AI.
compatibility	Requires Node.js 18+. Run via npx agent-media@latest or npm install -g agent-media.

Video Generate

Generates a video from a text prompt using AI video generation models. Supports both text-to-video and image-to-video (animating a static image).

Command

npx agent-media@latest video generate --prompt <text> [options]

Inputs

Option	Required	Description
--prompt	Yes	Text description of the video to generate
--in	No	Input image path or URL for image-to-video
--duration	No	Duration in seconds (6, 8, 10, 12, 14, 16, 18, 20; default: 6)
--resolution	No	Video resolution (720p, 1080p, 1440p, 2160p; default: 720p)
--fps	No	Frame rate (25 or 50; default: 25)
--audio	No	Generate audio track
--out	No	Output path, filename or directory (default: ./)
--provider	No	Provider to use (default: auto-detect)
--model	No	Model to use (overrides provider default)

Output

Returns a JSON object with the generated video path:

{
  "ok": true,
  "media_type": "video",
  "action": "video-generate",
  "provider": "fal",
  "output_path": "generated_abc123.mp4",
  "mime": "video/mp4",
  "bytes": 12345678
}

Examples

Generate a video from text:

npx agent-media@latest video generate --prompt "a cat walking in a garden"

Generate a longer video with higher resolution:

npx agent-media@latest video generate --prompt "ocean waves crashing on a beach" --duration 10 --resolution 1080p

Animate an existing image (image-to-video):

npx agent-media@latest video generate --in portrait.png --prompt "the person waves hello and smiles"

Generate with audio:

npx agent-media@latest video generate --prompt "fireworks exploding in the night sky" --audio

Use a specific provider:

npx agent-media@latest video generate --prompt "a rocket launching" --provider replicate

Providers

This action requires an external provider:

• fal - Requires FAL_API_KEY (uses LTX-2 model)
• replicate - Requires REPLICATE_API_TOKEN (uses lightricks/ltx-video model)

The local provider does not support video generation.