查询图像生成任务状态
更新时间：2026-03-13
GET
https://qianfan.baidubce.com/beta/image/qianfan-image-v1
查询图像生成任务状态，根据 task_id 获取图像生成任务的当前状态及相关详情信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
task_id
string
图像生成任务的 task_id，用于查询对应任务的状态及结果。
必选
请求结构
GET /beta/image/qianfan-image-v1?task_id={task_id} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
curl
curl -X GET "https://qianfan.baidubce.com/beta/image/qianfan-image-v1?task_id=xxx" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，0 表示成功，非 0 表示失败。
必选
message
string
错误信息或状态描述。
必选
request_id
string
请求唯一 ID，用于问题排查。
必选
data
object {7}
任务详情数据。
必选
显示子属性
隐藏子属性
task_id
string
任务 ID，由系统生成。
必选
task_status
string
任务状态。可选值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。
必选
task_status_msg
string
任务状态描述信息，任务失败时返回失败原因。
可选
task_info
object {0}
任务创建时的参数信息。
必选
显示子属性
隐藏子属性
暂无参数
task_result
object {1}
任务结果，仅在任务状态为成功时返回。
可选
显示子属性
隐藏子属性
images
array
生成结果图片列表。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
index
integer
图片序号，范围 0 ~ 9。
可选
url
string
图片访问 URL（防盗链）。为保障信息安全，生成的图片/视频资源会在 30 天后自动清理，请及时下载并自行存储。
可选
created_at
integer
任务创建时间，Unix 时间戳，单位为毫秒（ms）。
必选
updated_at
integer
任务更新时间，Unix 时间戳，单位为毫秒（ms）。
必选
usage
object {4}
本次请求的用量/消耗详情。
必选
显示子属性
隐藏子属性
model_name
string
模型名称。
必选
mode
string
生成模式。
必选
resolution
string
生成分辨率。
必选
credits
integer
本次任务消耗的算力/积分数量。
必选
返回示例
{
"code": 0,
"message": "",
"request_id": "xxx",
"data": {
"task_id": "xxx",
"task_status": "succeed",
"task_status_msg": "",
"task_info": {
},
"task_result": {
"images": [
{
"index": 0,
"url": "xxx"
}
]
},
"created_at": 1722769557708,
"updated_at": 1722769557708,
"usage": {
"model": "xxx",
"duration": "xxx",
"resolution": "xxx",
"credits": xxxxx
}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
生图模型通用错误码
| 分类 | HTTP状态码 | type | code | message |
|---|---|---|---|---|
| 内部错误 | 500 | internal_error | image_generation_internal_error | image generation service internal error |
| 参数错误 | 400 | invalid_request_error | invalid_lipsync_argument | xxx |
| 并发度超限 | 429 | rate_limit_exceeded | image_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| prompt不合法 | 403 | unsafe_request | image_generation_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章