利用火山引擎 Ark API（Seedance 系列模型）实现链式续拍，自动生成长视频的 Python 工具集。

A Python toolkit for chained video generation using Volcano Engine Ark API (Seedance models), automating long-form video production through sequential shot continuation.

Seedance 2.0 的 agent 模式尚未开放 API，本项目在 Seedance 1.5 Pro 基础上实现了类似的半自动化导演工作流：

• 链式续拍：自动提取上一段视频尾帧作为下一段首帧，保证画面连续性
• API 优势：相比网页端，API 调用在内容审核上限制更少，可实现更多风格化创作
• 批量自动化：一键提交多段镜头，自动轮询等待、下载、拼接，省去大量手动操作

flowchart LR A[首帧图片] --> B[提交 Seedance API] B --> C[生成视频片段] C --> D[提取尾帧] D --> E{还有下一段?} E -->|是| F[尾帧作为下一段首帧] F --> B E -->|否| G[ffmpeg 拼接] G --> H[完整影片 final_film.mp4] 

• 支持 Seedance 1.5 Pro / 1.0 Pro / 1.0 Pro Fast / 1.0 Lite 全系列模型
• 链式续拍模式（--chain）：尾帧自动衔接下一段首帧
• 草稿预览模式（--draft）：480p 快速验证构图和动作
• 批量并发控制：可配置每批提交数量（--batch-size）
• 自动 ffmpeg 拼接：重编码 + 去重复帧处理衔接跳帧
• 支持首帧/尾帧/参考图多种输入方式
• 音频生成支持（Seedance 1.5 Pro）
• 命令行参数灵活控制生成范围

python -m venv venv source venv/bin/activate pip install 'volcengine-python-sdk[ark]'

在火山引擎方舟控制台获取 API Key： https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey

然后在方舟控制台 → 模型广场搜索 seedance，开通所需模型。

创建 .env 文件（参考 .env.example）：

cp .env.example .env # 编辑 .env，填入你的 API Key

或直接修改 seedance_video.py 中的 ARK_API_KEY 变量。

在 seedance_video.py 中编辑 SHOTS 列表，定义每个镜头的参数：

SHOTS = [ { "id": "S01", "name": "开场", "prompt": "你的提示词...", "first_frame": "/path/to/first_frame.png", # 可选 "duration": 12, "generate_audio": True, }, # ...更多镜头 ]

# 链式续拍，逐段串行 python seedance_video.py --chain --batch-size 1 # 只生成指定镜头 python seedance_video.py --chain --batch-size 1 S01 S02 S03 # 草稿快速预览 python seedance_video.py --chain --batch-size 1 --draft # 生成全部镜头（非续拍，可并发） python seedance_video.py

jimeng-api/ ├── seedance_video.py # 主脚本（Ark API，支持链式续拍） ├── jimeng_video.py # 旧版脚本（Visual API，即梦 3.0 Pro） ├── storyboard_script.py # 分镜脚本定义（镜头+台词+提示词） ├── Seedance_API_经验手册.md # 详细踩坑记录与经验总结 ├── .env.example # API Key 配置模板 ├── .gitignore ├── storyboard/ # 分镜首帧图素材 ├── output/ # 生成结果 │ ├── S01.mp4 ~ SXX.mp4 # 各段视频 │ ├── S01_last_frame.png # 末帧图片（续拍用） │ ├── S01_video_url.txt # 视频下载地址 │ └── final_film.mp4 # 拼接后完整影片 └── venv/ # Python 虚拟环境 

• API Key 安全：请勿将 API Key 提交到公开仓库，使用 .env 文件管理
• 模型开通：首次使用需在火山引擎方舟控制台手动开通 Seedance 模型
• 续拍链必须串行：--chain 模式下建议 --batch-size 1，否则无法获取上一段尾帧
• Seedance 2.0：截至 2026 年 2 月，2.0 API 尚未开放，仅控制台体验中心可用
• 内容合规：请遵守火山引擎平台的内容使用规范

MIT

Seedance 2.0's agent mode is not yet available via API. This project implements a semi-automated director workflow on top of Seedance 1.5 Pro, achieving similar chained video generation capabilities:

• Chain continuation: Automatically extracts the last frame of each video segment as the first frame of the next, ensuring visual continuity
• API advantages: Compared to the web interface, API calls have fewer content moderation restrictions, enabling more stylized creative work
• Batch automation: Submit multiple shots at once, with automatic polling, downloading, and concatenation

flowchart LR A[First Frame Image] --> B[Submit to Seedance API] B --> C[Generate Video Segment] C --> D[Extract Last Frame] D --> E{More segments?} E -->|Yes| F[Last frame becomes next first frame] F --> B E -->|No| G[ffmpeg Concatenation] G --> H[Final Film final_film.mp4] 

• Supports full Seedance model lineup: 1.5 Pro / 1.0 Pro / 1.0 Pro Fast / 1.0 Lite
• Chain continuation mode (--chain): Automatic last-frame-to-first-frame handoff
• Draft preview mode (--draft): Quick 480p validation of composition and motion
• Configurable batch concurrency (--batch-size)
• Automatic ffmpeg concatenation with re-encoding and duplicate frame trimming
• Supports first frame / last frame / reference image inputs
• Audio generation support (Seedance 1.5 Pro)
• Flexible CLI argument control

python -m venv venv source venv/bin/activate pip install 'volcengine-python-sdk[ark]'

Obtain your API Key from the Volcano Engine Ark console: https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey

Then enable the Seedance models you need in the Ark console Model Marketplace.

cp .env.example .env # Edit .env with your API Key

Or modify the ARK_API_KEY variable directly in seedance_video.py.

Edit the SHOTS list in seedance_video.py:

SHOTS = [ { "id": "S01", "name": "Opening", "prompt": "Your prompt here...", "first_frame": "/path/to/first_frame.png", # optional "duration": 12, "generate_audio": True, }, # ...more shots ]

# Chain mode, sequential python seedance_video.py --chain --batch-size 1 # Generate specific shots only python seedance_video.py --chain --batch-size 1 S01 S02 S03 # Draft preview python seedance_video.py --chain --batch-size 1 --draft # Generate all shots (non-chain, concurrent) python seedance_video.py

• API Key security: Never commit your API Key to public repositories; use .env files
• Model activation: First-time users must manually enable Seedance models in the Ark console
• Chain mode must be sequential: Use --batch-size 1 with --chain to ensure last frame availability
• Seedance 2.0: As of February 2026, the 2.0 API is not yet available; only accessible via the console
• Content compliance: Please follow the Volcano Engine platform's content usage policies

MIT