视频与素材
查询任务(火山兼容)
查询 Seedance 兼容任务的状态和结果。
概览
使用创建响应返回的 cgt-... ID 查询任务。任务处于 queued 或 running 时每隔几秒轮询一次;到 succeeded、failed、cancelled 或 expired 就停止。
v3 与 /v1/tasks/{id} 的状态名称不同,不要复用 v1 的枚举或响应结构体。v3 JSON 中的 duration 是字符串,error 是可选的错误详情字段。Go 客户端可将 Duration 声明为 string,JSON tag 使用 duration,omitempty,并在每个 v3 终态停止轮询。
另见 Seedance 2.0 视频模型 和 视频生成。
状态值
queued:已接受,等待执行。running:正在生成。succeeded:结果已就绪,content.video_url可用。failed:生成失败,请查看error.code和error.message。cancelled:任务在完成前被取消。expired:任务在完成前过期。
响应字段
id:以cgt-开头的任务 ID。model:创建任务时你发送的model值。status:上述状态之一。content.video_url:成功后的最终视频 URL,是 TokenLab 结果链接,有效期 30 天,见数据保留。content.last_frame_url:仅在请求且可用时返回。usage:可用时返回completion_tokens和total_tokens;使用联网搜索工具时还有tool_usage.web_search。created_at和updated_at:Unix 时间戳(秒)。error:有错误详情时为{ code, message },不要仅根据status推断该字段是否存在。- 任务设置过的请求值在可用时原样返回:
seed、resolution、ratio、duration(字符串)、generate_audio、service_tier、execution_expires_after、safety_identifier、tools、draft、draft_task_id、frames、framespersecond。
该响应不包含 progress、return_last_frame、watermark、priority 或 camera_fixed。
任务 ID 不存在或已过期时返回 404;属于其他组织的任务 ID 返回 403。
示例
curl https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
-H "Authorization: Bearer $TOKENLAB_API_KEY"{
"id": "cgt-20260102030405-a1b2c",
"model": "seedance-2.0",
"status": "succeeded",
"content": {
"video_url": "https://api.tokenlab.sh/v1/media-results/3f2b8c1e-6d4a-4e9b-8a7c-2d5e1f0b9c4a.mp4?token=…"
},
"usage": {
"completion_tokens": 123456
}
}type SeedanceTask struct {
ID string `json:"id"`
Status string `json:"status"`
Duration string `json:"duration,omitempty"`
}
func isTerminal(status string) bool {
switch status {
case "succeeded", "failed", "cancelled", "expired":
return true
default:
return false
}
}curl -X GET "https://example.com/api/v3/contents/generations/tasks/string"{ "id": "string", "model": "string", "status": "queued", "content": { "video_url": "http://example.com", "last_frame_url": "http://example.com" }, "seed": 0, "resolution": "string", "ratio": "string", "duration": "string", "frames": 0, "framespersecond": 0, "generate_audio": true, "tools": { "type": "web_search" }, "safety_identifier": "string", "draft": true, "draft_task_id": "string", "service_tier": "string", "execution_expires_after": 0, "usage": { "completion_tokens": 0, "total_tokens": 0, "tool_usage": { "web_search": 0 } }, "error": { "code": "string", "message": "string" }, "created_at": 0, "updated_at": 0}授权
BearerAuth AuthorizationBearer <token>
API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
路径参数
id*string
创建端点返回的兼容性任务 ID。ID 以 cgt- 开头。
响应
application/json
application/json
application/json
application/json
application/json
application/json