获取文生图任务详情
说明
根据任务唯一 ID 查询单个文生图任务详情。
RPM 10/min
请求地址
http
GET /open/v1/aigc/photo/taskHeader
http
access_token: {{access_token}}请求参数 Query
| 字段 | 类型 | 是否必传 | 示例 | 说明 |
|---|---|---|---|---|
| unique_id | string | 是 | 2d681fd7-d9ad-4645-86b4-3b5e30430705 | 创建任务时返回的任务 ID |
响应示例
json
{
"trace_id": "e74f8d4dfd2bb4cc1d81f748fd74882a",
"code": 0,
"msg": "success",
"data": {
"id": 3945,
"unique_id": "2d681fd7-d9ad-4645-86b4-3b5e30430705",
"create_time": 1750061854,
"type": 1,
"progress_desc": "Success",
"err_msg": "",
"aspect_ratio": 0,
"output_url": ["https://example.com/xxx.png"],
"photo_info": {},
"motion_info": {},
"waiting_num": 0
}
}响应字段说明
| 一级字段 | 二级字段 | 说明 |
|---|---|---|
| code | 响应状态码 | |
| msg | 响应消息 | |
| data | 响应数据 | |
| id | 任务 ID | |
| unique_id | 任务唯一 ID | |
| create_time | 创建时间（时间戳） | |
| type | 任务类型，1=photo，2=motion | |
| progress_desc | 任务状态：Ready / Generating / Queued / Error / Success / Fail | |
| err_msg | 错误信息 | |
| aspect_ratio | 宽高比，0=9:16，1=16:9 | |
| output_url | 输出地址（photo 可能为多图，motion 为单视频） | |
| waiting_num | 等待调度排队数 | |
| photo_info | 文生图任务详细信息 | |
| motion_info | 图生视频任务详细信息 |
响应状态码说明
| code | 说明 |
|---|---|
| 0 | 响应成功 |
| 400 | 传入参数格式错误 |
| 10400 | AccessToken 验证失败 |
| 40000 | 参数错误 |
| 40001 | 超出 RPM 限制 |
| 50000 | 系统内部错误 |