API 参考
API 总览
了解 Seedance 2.0 Open API 的认证方式、提交流程、状态查询和 Webhook 回调。
API 总览
Seedance 2.0 Open API 支持你从自己的产品中异步提交视频生成任务，并在处理完成后获取结果。
Base URL
https://www.seedance2.ink认证方式
所有 Open API 请求都使用在 Seedance 控制台中创建的 Bearer Token。
Authorization: Bearer sd2_live_your_api_key如果 API Key 缺失、失效、过期或不正确，服务端会返回：
{
"success": false,
"error": {
"code": "unauthorized",
"message": "Invalid API key"
}
}接入流程
- 在 Seedance 控制台创建 API Key。
- 使用
POST /api/open/v1/video/generations提交生成任务。 - 保存返回的
requestId。 - 轮询
GET /api/open/v1/video/generations/{requestId}，直到任务进入终态。 - 如有需要，可通过 Webhook 接收完成通知。
核心接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/open/v1/models | 获取可用模型、时长、比例、分辨率和计费元数据。 |
POST | /api/open/v1/video/generations | 创建新的视频生成任务。 |
GET | /api/open/v1/video/generations/{requestId} | 查询任务状态，并在完成后拿到输出视频地址。 |
POST | /api/open/v1/video/generations/{requestId}/cancel | 取消处于排队或生成中的任务。 |
可用模型
| 模型 | 适用场景 | 支持时长 | 分辨率 |
|---|---|---|---|
seedance-2.0 | 最高质量、多模态生成 | 4-15 秒 | 480p, 720p, 1080p |
seedance-2.0-fast | 更快出结果 | 4-15 秒 | 480p, 720p, 1080p |
seedance-1.5-pro | 更低成本的任务 | 5 或 10 秒 | 480p, 720p, 1080p |
支持的画幅比例：
16:99:161:1
状态值
| 状态 | 含义 |
|---|---|
queued | 请求已接收，正在排队等待处理。 |
processing | 视频正在生成中。 |
succeeded | 任务已成功完成，output.url 可用。 |
failed | 任务执行失败，可查看 error 字段。 |
cancelled | 任务在完成前已取消。 |
模型接口示例
curl https://www.seedance2.ink/api/open/v1/models{
"success": true,
"data": [
{
"id": "seedance-2.0",
"type": "video_generation",
"mode": "image_to_video",
"durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"aspectRatios": ["16:9", "9:16", "1:1"],
"resolutions": ["480p", "720p", "1080p"],
"usdPerSecond": {
"480p": 0.05,
"720p": 0.1,
"1080p": 0.2
}
}
]
}Webhook
你可以通过两种方式接收任务完成通知：
- 在单次请求里传入
webhookUrl - 在控制台为 API Key 配置默认回调地址
如果两者同时存在，则单次请求中的 webhookUrl 优先。
如果该 API Key 配置了 Webhook Secret，回调请求还会带上：
x-seedance-signature: <hex_sha256_hmac>完成回调示例：
{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}错误码
| HTTP 状态码 | 错误码 | 含义 |
|---|---|---|
400 | invalid_request | 请求体不符合接口要求。 |
401 | unauthorized | API Key 缺失或无效。 |
402 | insufficient_credits | 账户积分不足，无法创建任务。 |
404 | not_found | 当前 API Key 下找不到对应任务。 |
429 | rate_limited | 超出每分钟频率限制或月度配额。 |
500 | internal_error | 服务端出现未预期错误。 |