| name | aigc-cli-openrouter-video |
| description | Use "aigc-cli video" with OpenRouter to generate videos via the dedicated video API. Supports text-to-video, image-to-video (first frame), aspect ratio, resolution, and duration control. Uses async submit → poll → download pattern. |
aigc-cli-openrouter-video
通过 aigc-cli video 调用 OpenRouter 的专用视频 API(POST /api/v1/videos)生成视频。支持 Google Veo、Minimax 等视频模型。
自动兼容:当 --api-base 或 OPENAI_BASE_URL 指向 openrouter.ai 时,工具自动使用 OpenRouter 视频 API(而不是 APIMart 异步任务模式)。
前置条件
- 项目已安装
aigc-cli(go install 或 make build)
- 已配置 OpenRouter API Key:
export OPENAI_API_KEY="sk-or-xxx"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
- 或在
~/.config/aigc-cli/config.yaml 中配置:
api_key: "sk-or-xxx"
base_url: "https://openrouter.ai/api/v1"
何时使用
- 用户需要根据文本描述生成视频(走 OpenRouter)
- 用户需要图生视频(首帧图片)
- 用户需要使用 Google Veo、Minimax 等 OpenRouter 支持的视频模型
- 用户需要指定分辨率、宽高比、时长
- 用户已经配置了 OpenRouter API Key
使用流程
1. 基本文生视频
export OPENAI_API_KEY="sk-or-xxx"
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
aigc-cli video --prompt "a golden retriever playing fetch on a sunny beach" \
--model "google/veo-3.1"
提交后自动轮询(30 秒间隔),直到生成完成并下载视频。
2. 指定参数
aigc-cli video \
--prompt "City nightscape timelapse" \
--model "google/veo-3.1" \
--resolution "720p" \
--size "16:9" \
--duration 8
3. 图生视频
aigc-cli video \
--prompt "The kitten stands up and walks toward the camera" \
--model "google/veo-3.1" \
--image-url https://example.com/cat.jpg
4. 生成带音频的视频
aigc-cli video \
--prompt "A man speaks to the camera: Hello everyone" \
--model "minimax/video" \
--generate-audio
常用 OpenRouter 视频模型
| 模型 ID | 说明 |
|---|
google/veo-3.1 | Google Veo 3.1 |
google/veo-3.0 | Google Veo 3.0 |
minimax/video | MiniMax 视频模型 |
使用 aigc-cli models 查看完整模型列表。
视频生成流程
1. POST /api/v1/videos → 返回 job_id + polling_url (立即返回)
2. GET {polling_url} → 每 30 秒轮询一次 (30秒-几分钟)
3. GET {unsigned_url} → 下载 MP4 视频 (自动保存)
调试技巧
aigc-cli video --prompt "test" --model "google/veo-3.1" --duration 4 -v
aigc-cli video --prompt "test" --model "google/veo-3.1" --dry-run
aigc-cli video --prompt "test" --model "google/veo-3.1" --output ./downloads
注意事项
- 视频生成是异步的,通常需要 30 秒到几分钟
- 提交后自动轮询,每 30 秒检查一次状态,最长等待 5 分钟
- 视频自动下载到当前目录(或用
--output 指定目录)
--generate-audio 会增加处理时间
- 不同模型支持的参数(分辨率、时长、宽高比)不同,请参考 OpenRouter 文档
- 首次使用建议
--dry-run 确认请求参数
- 不要多次调用 API 重复测试,避免产生不必要的费用