用途:通过字节跳动火山引擎 Ark 的豆包 Seedance 系列视频模型生成或编辑视频,接口为 Ark contents/generations/tasks。支持文生视频、图生视频(单图/多图参考)。
主要能力与默认值:默认模型 doubao-seedance-1-5-pro-251215(可用 --model 覆盖),默认时长 5 秒,默认比例 16:9。多图参考目前仅在 doubao-seedance-1-0-lite-i2v-250428 等 lite i2v 模型下生效。
使用方式:需设置 ARK_API_KEY 环境变量。文生视频示例:uv run {baseDir}/scripts/generate_video.py --prompt "一个在草地上奔跑的小狗视频,阳光明媚,电影感" --filename "奔跑小狗.mp4"。也可用 YAML 配置文件,通过 --config 传入,支持 prompt、filename、images、ratio、duration、model、api_key 等字段;命令行参数优先级高于配置文件。图生视频用 -i 传入参考图,URL 直接透传,本地文件自动转为 base64;可多次传入形成多图参考。至少需要提示词或参考图其一,否则脚本报错。
结果与轮询:Ark 视频生成通常为异步任务,脚本调用 POST /contents/generations/tasks,成功时解析 id/task_id;若响应直接含 video_url 则尝试下载保存。未指定目录时默认保存到仓库 outputs/,无后缀默认补 .mp4。若仅返回任务 ID,可用轮询脚本:uv run {baseDir}/scripts/get_video_task_status.py cgt-20260226184301-4h8v6 --filename "示例视频.mp4" --interval 5。轮询脚本定期调用 GET /contents/generations/tasks/{task_id},状态为 succeeded/completed 且拿到 video_url 时自动下载;interval 默认 10 秒,timeout 默认 600 秒,超时报错退出。
限制:时长由模型/Endpoint 实际支持区间决定;文件名建议不含实现细节,语言与 Prompt 一致且简短。其余收费、价格、平台细节暂未提供。