/v1/tasks/{task_id}Used to poll async video, audio, or 3D tasks. Task ownership is determined by the tenant of the API key.
Back to Task endpoint listRequest parameters
FieldTypeRequiredDescription
task_idpathYesTask ID.waitqueryNoOptional wait seconds for short polling until task status changes.Response fields
FieldTypeRequiredDescription
idstringYesTask ID.objectstringYes固定为 task。statusstringYesTask status.progressnumberYes任务进度，0 到 1。progress_detailobjectNo细分进度信息。typestringYes任务类型。capabilitystringNoTask capability tag.modelstringYesModel ID used by the task.inputobjectYes任务输入快照。outputarrayNoArtifact list after task success.resultobjectNoProvider 结果摘要。errorobjectNoError information when the task fails.usageobjectNo用量与计费明细。attemptobjectYes重试次数摘要，包含 current 和 max。linksobjectNoQuery, cancellation, or event subscription URL.providerstringNo实际执行 Provider。cost_usdnumberNo任务成本。billing_model_keystringNo计费models键。discount_idstringNo折扣 ID。discount_factornumberYes折扣因子。list_costnumberYes折前标价成本。discount_amountnumberYes折扣金额。actual_costnumberYes实际扣费。webhook_urlstringNo任务回调 URL。metadataobjectNoApplication metadata.priorityintegerYes任务优先级。started_atstringNo任务开始时间。finished_atstringNo任务结束时间。completed_atstringNo任务完成时间。canceled_atstringNo任务取消时间。created_atstringYes任务create时间。updated_atstringYes任务update时间。Errors
401
UNAUTHORIZEDMissing or invalid Authorization Bearer token.
403
FORBIDDENThe current API key is not allowed to call this scope or model.
429
RATE_LIMITED请求过快或异步任务队列已满，请降低并发或稍后重试。