seedance

name	seedance
description	调用火山方舟 Seedance API 生成视频（文生视频、带参考图的图生视频、多段生成拼接），含 prompt 写法约束、报错处理和抽帧质检。当用户要"生成视频/文生视频/跑 Seedance/doubao-seedance"时使用。
compatibility	需要 python3、ffmpeg（质检与拼接）、火山方舟 ARK_API_KEY；按量计费

Seedance 视频生成

流程：写分镜 prompt → 组装请求体 JSON → scripts/submit_seedance.py 提交并下载 → 抽帧质检 →（多段时）拼接。

前置

• ARK_API_KEY：环境变量或 ~/.ark_api_key 文件（chmod 600，建议后者，不进对话记录）。若 key 曾出现在对话记录中，提醒用户到控制台作废重建。
• 开通门槛：Seedance 2.0 系列需账户余额 >200 元或购买资源包。
• 模型选择：doubao-seedance-2-0-mini-260615 上限 720p，便宜；要 1080p 换 doubao-seedance-2-0-260128（prompt 无需改动）。2.0 系列不支持 seed。

请求体

每段视频写成一个 req_<名字>.json，{{FILE:相对路径}} 占位符会被脚本替换为 base64 data URI：

{
  "model": "doubao-seedance-2-0-mini-260615",
  "content": [
    {"type": "text", "text": "<分镜prompt>"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "{{FILE:ref.png}}"}}
  ],
  "resolution": "720p", "ratio": "9:16", "duration": 15,
  "generate_audio": true, "watermark": false
}

参考图要求：宽高比 [0.4, 2.5]，边长 [300, 6000]px；带噪点背景或水印的图先清理再喂，否则污染画面；参考图/参考视频禁含真人人脸（Seedance 2.0 硬限制）。

Prompt 写法约束

• 结构：整体风格一句 + 按【镜头N，起-止秒】逐镜写，中文 <500 字
• 口播台词放双引号内（驱动 generate_audio 输出同步人声）
• 需要参考图元素入画的镜头写「参考图1的…」
• 不要在画面里要求小字文本（手机屏幕、竖排花字必乱码）；大号横排花字 4~8 字可以

提交生成

python3 scripts/submit_seedance.py req_segA.json req_segB.json

放后台跑（720p/15s 每段约 2~3 分钟），成片自动下载到 JSON 同目录。注意事项：

• SetLimitExceeded：账户「安全体验模式」限额 → 用户去开通管理对该模型调高/关闭，改完直接重跑（可挂 60s 间隔自动重试兜底生效延迟）
• 任务 ID 仅存 7 天；视频 URL 有时效，脚本已做完成即下载

抽帧质检

对成片做 3×3 contact sheet，用 Read 逐张检查：

dur=$(ffprobe -v error -show_entries format=duration -of csv=p=0 "$f")
ffmpeg -y -v error -i "$f" -vf "fps=9/$dur,scale=320:-1,tile=3x3" -frames:v 1 out.jpg

检查项：人物跨镜头一致性、参考图元素还原度、花字错字、物体畸变。中文小字乱码属模型通病 → 记录时间点，后期压字幕覆盖，不值得重跑；分镜结构错误才重跑对应段。

多段拼接

单任务时长有限，长视频拆成多段生成；相邻段的分镜用天然场景切换衔接，避免依赖尾帧串联。拼接：

ffmpeg -y -i segA.mp4 -i segB.mp4 -filter_complex \
"[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]" \
-map "[v]" -map "[a]" -c:v libx264 -crf 18 -c:a aac -b:a 128k final.mp4