video-generate 属于命令行 AI 视频生成工具，用途是根据文本提示词生成视频，或将一张静态图片动画化为视频（图生视频）。
主要能力：支持文生视频与图生视频；可指定时长，取值为 6、8、10、12、14、16、18、20 秒，默认 6 秒；可指定分辨率 720p、1080p、1440p、2160p，默认 720p；可指定帧率 25 或 50，默认 25；可通过 --audio 生成音轨；可指定输出路径、文件名或目录，默认 ./。
使用方式：通过 npx 命令调用，基本形式为 npx agent-media@latest video generate --prompt <text> [options]。其中 --prompt 为必填，用于描述要生成的视频；--in 可选，传入图片路径或 URL 以进行图生视频；其余选项包括 --duration、--resolution、--fps、--audio、--out、--provider、--model。执行后返回 JSON 对象，包含生成的视频路径等信息，例如 ok、media_type、action、provider、output_path、mime、bytes 字段。
示例：npx agent-media@latest video generate --prompt "a cat walking in a garden"；或使用 --duration 10 --resolution 1080p；图生视频示例为 npx agent-media@latest video generate --in portrait.png --prompt "the person waves hello and smiles"；生成音频示例加 --audio；指定服务商示例加 --provider replicate。
服务商与限制：该操作依赖外部服务商。fal 需要 FAL_API_KEY，使用 LTX-2 模型；replicate 需要 REPLICATE_API_TOKEN，使用 lightricks/ltx-video 模型。本地 provider 不支持视频生成。资料未提供价格、免费额度、可用模型完整列表及平台限制等信息。