Seedance 2.0 文生视频/参考生成视频（byted-ind-ecom-prompt-to-video）

本 skill 用于调用火山方舟上的 Seedance 2.0 视频生成能力，支持：

• 文生视频（仅 prompt）
• 图生视频（首帧/首尾帧）
• 多参考生成（参考图片最多 9 张、参考视频最多 3 个）

使用方式

在 skill 目录下执行 scripts/generate.py。

参数

• --prompt：视频文本提示词
• --first_frame：首帧图片（URL 或本地路径）
• --last_frame：尾帧图片（URL 或本地路径）
• --reference_images：参考图片（URL 或本地路径，最多 9 张）
• --reference_videos：参考视频（URL 或本地路径，最多 3 个）
• --resolution：分辨率（如 720p、1080p）
• --ratio：画幅（如 16:9、9:16、1:1、adaptive）
• --duration：时长（秒）

示例

文生视频：

python3 scripts/generate.py --prompt "A cute cat playing with a ball of yarn in a sunny room" --ratio 16:9 --duration 5

图生视频（首帧）：

python3 scripts/generate.py --prompt "The cat jumps" --first_frame "/path/to/cat.jpg" --ratio 16:9 --duration 5

多参考图片：

python3 scripts/generate.py --prompt "A scenic landscape" --reference_images "/path/to/img1.jpg" "/path/to/img2.jpg" --ratio 16:9

本地素材处理逻辑（重要）

• 本地图片：
  • 在“可用 TOS”时会先上传到 TOS，再使用公网 URL 参与生成。
  • 若无可用 TOS，则自动转为 data:<mime>;base64,... 形式提交。
• 本地参考视频：建议直接提供公网 URL；如提供本地视频，需要可用 TOS 才能先上传转为公网 URL。
• 视频输出：
  • 若可用 TOS，会尝试将生成视频转存到 TOS 并输出 TOS URL。
  • 否则直接返回模型原始视频 URL（通常有时效，建议尽快下载或转存）。

环境变量

最低必需：

• ARK_API_KEY
• SEEDANCE_EP_ID
• ARK_BASE_URL（可选，默认 https://ark.cn-beijing.volces.com/api/v3）

如需启用 TOS 上传/转存：

• VOLC_ACCESS_KEY
• VOLC_SECRET_KEY
• TOS_ENDPOINT
• TOS_REGION
• TOS_BUCKET
• TOS_UPLOAD_ENABLED（可选，默认 true）

输出

脚本会轮询任务直到结束，并在终端输出：

• Final Video URL: <url>