首批通过分布式安全可靠测评,为关键业务系统打造
Retrieve Task Status - 查询异步任务
更新时间:2026-06-08 15:05:40
功能说明
查询图片或视频异步生成任务状态;终态且有缓存结果时返回上游结果并补充 task_id 与 task_status。
调用说明
接口约束
- 调用者需要拥有 API Key,详情请参见 管理 AI API Key。
请求路径
GET {BASE_URL}/api/v1/tasks/{task_id}
请求头
| 名称 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|
| Authorization | 是 | Bearer {token} | 鉴权信息 |
| Content-Type | 否 | application/json | 请求体格式 |
请求参数
Path 参数
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| task_id | string | 是 | 无 |
Query 参数
无
Body 参数
无
返回结果
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| success | boolean | 请求是否成功 |
| code | string | 返回码 |
| message | string | 返回信息 |
| data | object | 业务返回数据 |
data 字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
| task_id | string | 任务 ID |
| task_status | string | 任务状态 |
请求示例
curl --request GET '{BASE_URL}/api/v1/tasks/{task_id}' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json'
返回示例
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"task_id": "example-task-id",
"task_status": "SUCCESS"
}
}