创建智能补全主体图任务
更新时间：2026-03-16
POST
https://qianfan.baidubce.com/beta/image/qianfan-image-v1
创建智能补全主体图任务，提交异步图像生成请求，返回任务ID及初始任务状态。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
指定的图像生成模型。
固定值：multi-shot。
必选
type
string
任务类型。
multi-shot：支持智能补全主体图，模型范围：multi-shot
必选
model_parameters
object {1}
必选
显示子属性
隐藏子属性
element_frontal_image
string
主体正面参考图，支持传入图片Base64编码或图片URL（确保可访问）。
图片格式支持：.jpg / .jpeg / .png
尺寸要求：图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间。
可选
请求结构
POST /beta/image/qianfan-image-v1 HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "multi-shot",
"type": "multi-shot",
"model_parameters": {
"element_frontal_image":"https://xxx.com/my_pic.jpg"
}
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/beta/image/qianfan-image-v1" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "multi-shot",
"type": "multi-shot",
"model_parameters": {
"element_frontal_image":"https://xxx.com/my_pic.jpg"
}
}返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
接口返回状态码，0 表示成功。
可选
message
string
接口返回状态描述。
可选
request_id
string
请求唯一标识，用于问题追踪。
可选
data
object {5}
任务相关数据。
可选
显示子属性
隐藏子属性
task_id
string
任务唯一 ID，用于后续查询任务状态。
可选
task_status
string
任务状态。可选值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。
可选
task_info
object {0}
任务附加信息，当前为空对象。
可选
显示子属性
隐藏子属性
暂无参数
created_at
integer
任务创建时间，Unix 时间戳，单位：毫秒。
可选
updated_at
integer
任务最近更新时间，Unix 时间戳，单位：毫秒。
可选
响应示例
{
"code": 0,
"message": "",
"request_id": "as-****qpyfk",
"data": {
"task_id": "6981b*****01bca6a099ec",
"task_status": "submitted",
"created_at": 1770107249000,
"updated_at": 1770107249000,
"task_info": {}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
生图模型通用错误码
| 分类 | 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 |
评价此篇文章