创建图像omni生成任务
创建图像生成任务，提交异步图像生成请求，返回任务ID及初始任务状态。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
指定的图像生成模型。
固定值：o1-base、v3o。
任务类型。
omni：支持所有功能，模型范围：o1-base、v3o
显示子属性
隐藏子属性
文本提示词，用于描述预期生成的图像内容。可同时包含正向与负向描述。
长度限制：不超过 2500 个字符。
支持通过 <<<>>> 格式引用某个图片（例：<<<image_1>>>）。
参考图列表。
支持 .jpg, .jpeg, .png。
尺寸限制：单张图片大小 ≤ 10MB，单边分辨率 ≥ 300px，宽高比介于 1:2.5 至 2.5:1 之间。
参考主体数量和参考图片数量之和不得超过10。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
参考图片的访问 URL 或完整的 Base64 编码数据。
主体参考列表。基于主体库中的主体ID配置。
参考主体数量和参考图片数量之和不得超过10。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
主体ID。
生成图片的清晰度。
枚举值：
1k：标清质量（默认）。
2k：高清质量。
生成结果单图/组图切换开关。
枚举值：
single：单图（默认）。
series：多图。
生成图像个数。
取值范围：2 ~ 9
当result_type值为single时，当前参数无效。
单次请求生成的图片数量。
取值范围：1 ~ 9。
目标图像的宽高比例。
支持：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto（由模型基于 Prompt 智能推断）。
注：参考原图宽高比生成新图时，当前参数无效。
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_1>>> 里的蓝色杯子换成红色的杯子，并在小猫头上加一顶可爱的帽子",
"image_list": [
{
"image": "https://xxx.com/my_pic.jpg"
}
],
"resolution": "1k",
"n": 2
}
}示例代码
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_1>>> 里的蓝色杯子换成红色的杯子，并在小猫头上加一顶可爱的帽子",
"image_list": [
{
"image": "https://xxx.com/my_pic.jpg"
}
],
"resolution": "1k",
"n": 2
}
}'返回响应
接口返回状态码，0 表示成功。
接口返回状态描述。
请求唯一标识，用于问题追踪。
任务相关数据。
显示子属性
隐藏子属性
任务唯一 ID，用于后续查询任务状态。
任务状态。可选值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）。
任务附加信息，当前为空对象。
显示子属性
隐藏子属性
暂无参数
任务创建时间，Unix 时间戳，单位：毫秒。
任务最近更新时间，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 |
评价此篇文章