创建图像生成任务
创建图像生成任务，提交异步图像生成请求，返回任务ID及初始任务状态。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
模型名称，当前支持：o1-base。
任务类型，当前支持的任务类型包括：全功能 omni（一期内容），支持模型范围：o1-base。
不同任务类型可用参数不同，特定任务类型的可用参数集合。
显示子属性
隐藏子属性
文本提示词，可包含正向描述和负向描述，可将提示词模板化以满足不同的图像生成需求。不能超过 2500 个字符。通过 <<<>>> 的格式来指定某张图片，如：<<<image_1>>>。
参考图列表，用 key:value 承载，格式如："image_list":[{"image":"image_url"}]。支持传入图片 Base64 编码或图片 URL（确保可访问）。图片格式支持 .jpg / .jpeg / .png。图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间。参考主体数量与参考图片数量之和不得超过 10。image_url 参数值不得为空。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
图片 URL 或 Base64 编码字符串。
主体参考列表，基于主体库中主体的 ID 配置，用 key:value 承载，格式如："element_list":[{"element_id":long}]。参考主体数量与参考图片数量之和不得超过 10。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
主体库中的主体 ID。
生成图片的清晰度。可选值：1k（1K 标清）、2k（2K 高清）。
生成图片数量，取值范围：[1, 9]。
生成图片的画面纵横比（宽:高）。可选值：16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、auto。其中 auto 为根据传入内容智能生成；以视频参考原图横纵比生成新图时，当前参数无效。
用户自定义任务 ID。传入后不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询。请注意，单用户下需要保证唯一性。
POST /beta/image/qianfan-image-v1 HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "o1-base",
"type": "omni",
"model_parameters": {
"prompt": "蓝色的杯子换成红色的杯子，小猫头上加一定可爱的帽子",
"image_list": [
{
"image": "image_url"
}
],
"element_list": [
{
"element_id": 123456
}
],
"resolution": "1k",
"n": 2,
"aspect_ratio": "16:9",
"external_task_id": "your_custom_task_id"
}
}示例代码
创建一个图像生成任务，指定模型、任务类型及生成参数。
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": "o1-base",
"type": "omni",
"model_parameters": {
"prompt": "蓝色的杯子换成红色的杯子，小猫头上加一定可爱的帽子",
"image_list": [
{
"image": "image_url"
}
],
"resolution": "1k",
"n": 2,
"aspect_ratio": "16:9"
}
}'返回响应
接口返回状态码，0 表示成功。
接口返回状态描述。
请求唯一标识，用于问题追踪。
任务相关数据。
显示子属性
隐藏子属性
任务唯一 ID，用于后续查询任务状态。
任务状态。可选值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。
任务附加信息，当前为空对象。
显示子属性
隐藏子属性
暂无参数
任务创建时间，Unix 时间戳，单位：毫秒。
任务最近更新时间，Unix 时间戳，单位：毫秒。
{
"code": 0,
"message": "SUCCEED",
"request_id": "xxxx",
"data": {
"task_id": "xxxx",
"task_status": "submitted",
"task_info": {},
"created_at": 1769497893841,
"updated_at": 1769497893841
}
}