API 参考Seedance
查询任务
通过 task_id 查询 Seedance 视频生成任务状态和结果。建议每 3-5 秒轮询一次。
任务状态：
| 状态 | 含义 | 处理方式 |
|---|---|---|
queued | 排队中 | 继续轮询 |
in_progress | 生成中 | 继续轮询 |
completed | 已完成 | 从 metadata.url 取视频地址 |
failed | 失败 | 读取 error.message |
Authorization
BearerAuth AuthorizationBearer <token>
Authorization: Bearer <你的 API 密钥>
In: header
Path Parameters
task_id*string
任务 ID（来自创建任务接口的返回值）
Response Body
application/json
curl -X GET "https://api.3hei.com/v1/videos/task_xxxxxxxxxxxx"{
"id": "task_xxxxxxxxxxxx",
"task_id": "task_xxxxxxxxxxxx",
"object": "video",
"model": "doubao-seedance-2-0",
"status": "completed",
"progress": 100,
"metadata": {
"url": "https://storage.example.com/xxx.mp4"
},
"error": {
"message": "string",
"code": "string"
},
"created_at": 1781099053,
"completed_at": 1781099158
}