Seedance Public API
Seedance 视频与图片生成 API 私有测试文档。
私有测试 — API Key 由管理员审核发放。API 与 PC 端共用积分余额、定价函数、任务记录和失败退款逻辑，不建立独立 API 钱包，也不要求数据库 migration。
用户入口
- 文档：
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、取消、用量列表、自助 Key、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 模型的图生视频或多模态生视频，并要求权利确认和客户侧同意凭证编号；安全开关始终由服务端控制。