API字节跳动Seedance 系列模型
查询任务
按 id 或 task_id 查询任务状态。
请求
GET /ai/api/v3/contents/generations/tasks/{id}
Authorization: Bearer <TUIWO_API_TOKEN>{id} 可以是创建响应中的 id（兼容任务 ID）或 task_id（平台任务 ID）。
响应
{
"id": "cgt-xxxxxxxx",
"task_id": "task_xxxxxxxx",
"model": "<seedance-model-id>",
"status": "succeeded",
"content": {
"video_url": "https://..."
},
"usage": {},
"created_at": 1760000000,
"updated_at": 1760000100
}返回完整兼容字段集；不会返回 service_* 字段。
状态
queued、running、succeeded、failed、cancelled、expired。
部分模型服务由平台轮询更新状态，查询结果可能略有延迟。service_tier 会返回，但不支持作为过滤条件。
错误
| HTTP | code | 说明 |
|---|---|---|
| 401 | AuthenticationError | 令牌无效 |
| 404 | NotFound | 任务不存在、不属于当前用户/分组或已删除 |
| 502 | TaskResponseUnavailable | 任务响应暂不可用 |
媒体地址
content.video_url 与 content.last_frame_url：直连媒体渠道返回原生媒体地址；其他渠道返回平台签名代理地址，约 24 小时有效；过期后重新查询任务获取新地址。