Seedance 本地测试工具

一个用于调用移动云 AICC Doubao Seedance 2.0 视频生成 SDK 的本地 CLI + Web 工具。

功能

• 通过 YAML/JSON 任务文件创建视频生成任务
• 轮询任务状态、下载生成结果
• 本地 Web 页面管理任务和查看输出
• 自动校验常见请求参数

安装

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

如果 maas-seedance-sdk 不在公开 PyPI 中，请按你的服务商文档安装对应 wheel 包；不要把 wheel 包提交到 GitHub。

配置

cp .env.example .env
# 编辑 .env，填入自己的 MAAS_API_KEY

.env 已被 .gitignore 排除，请不要提交 API Key、私钥或其它敏感信息。

CLI 使用

# 创建并等待任务完成，完成后下载
python seedance_cli.py run --spec jobs/demo_text.yaml --wait --download

# 仅创建任务
python seedance_cli.py create --spec jobs/demo_multimodal.yaml

# 继续轮询并下载
python seedance_cli.py watch --task-id <TASK_ID> --download

# 查询任务
python seedance_cli.py show --task-id <TASK_ID>

# 列出本地记录
python seedance_cli.py list

# 列出远端任务
python seedance_cli.py list --remote --status succeeded

Web 页面

python seedance_cli.py serve --host 127.0.0.1 --port 8765

打开 http://127.0.0.1:8765。

目录说明

• seedance/: 核心配置、任务规范、校验、运行器、CLI
• webapp/: Flask Web 应用和模板
• jobs/: 示例任务配置
• outputs/, tmp/, uploads/, logs/: 运行时生成目录，已排除在 Git 之外

安全提醒

提交前建议执行：

git status --short
git grep -n "APIKEY\|MAAS_API_KEY\|Bearer \|Authorization" -- . ':!README.md' ':!.env.example'

确认没有真实密钥、签名 URL、日志、输出视频或临时上传文件被纳入提交。