Seedance Public API
Seedance 视频与图片生成 API 文档。
正式开放 — 已验证邮箱的用户可在 设置 → API 密钥 创建
sd_live_...Key。API 与 PC 端共用积分、定价、任务和失败退款逻辑；所有自助 Key 均可在严格的请求级合规控制下逐请求选择真人模式。
用户入口
- 文档：
https://seedance2video.io/docs/api - 账户入口：
/settings/public-api - Base URL：
https://api.seedance2video.io/v1 - OpenAPI：
https://api.seedance2video.io/v1/openapi.json
OpenAPI 可导入 Postman、Insomnia、Bruno 或服务端生成器。v1 不开放浏览器 CORS，Live Key 不能放在前端代码中。
首期接口
| 能力 | 接口 |
|---|---|
| 查询 Key 可用模型 | GET /models |
| 创建视频任务 | POST /videos |
| 创建图片任务 | POST /images |
| 轮询生成状态 | GET /generations/{id} |
| 查询 PC 积分余额 | GET /credits/balance |
| 下载 OpenAPI | GET /openapi.json |
首期不提供文件上传、Webhook、取消、用量列表、Test Key 和独立 API 积分钱包。
核心约定
- 使用
Authorization: Bearer sd_live_...。 - 创建任务必须发送稳定的
Idempotency-Key。 - 生成是异步任务，只轮询返回的
status_url。 - 完成地址位于
output.urls，视频另有output.video_url，图片另有output.image_urls。 - 输入必须是已为该客户配置白名单的公开 HTTPS 存储域名；拒绝 base64、
data:、localhost、IP 地址和任意第三方域名。 - 不返回 Provider、Provider Task ID、原始 Provider 响应或内部模型值。
开放模型为 seedance-2.0-pro、seedance-2.0-fast、seedance-2.0-mini、kling-3.0、gpt-image-2、nano-banana-2 和 nano-banana-pro。不提供 Veo 和 Lite。
所有具备生成权限的 Key 均可逐请求选择真人模式；该模式只支持三个 Seedance 模型的图生视频或多模态生视频，并要求权利确认和客户侧同意凭证编号。安全开关始终由服务端控制。
请求必须明确传入 parameters.real_person_mode: true、compliance.rights_confirmed: true，并在 compliance.consent_reference 中提供不含个人信息的客户审计编号。