Ernie-Image-Turbo
更新时间：2026-04-22
POST
https://qianfan.baidubce.com/v2/ernie-image/images/generations
本接口调用 Ernie-Image-Turbo 大模型，支持通过文本提示词（Prompt）生成高质量图像，并返回图片访问链接。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID，固定值为：ernie-image-turbo。
必选
prompt
string
文本提示词，用于描述预期生成的图像内容。
长度限制：不超过 2048 个字符。
必选
size
string
自定义生成图片的输出分辨率。
支持以下分辨率：
1024×1024
848×1264
768×1376
896×1200
1264×848
1376×768
1200×896
推荐使用分辨率：1376×768，仅支持以上固定值，传入其他内容将自动默认输出 1376×768 分辨率图片
可选
watermark
boolean
是否显示水印，默认关闭
true：开启水印false：关闭水印
可选
请求结构
POST /v2/ernie-image/images/generations HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "ernie-image-turbo",
"prompt": "一只可爱的猫",
"size": "1376x768",
"watermark": false
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/v2/ernie-image/images/generations" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "ernie-image-turbo",
"prompt": "一只可爱的猫",
"size": "1376x768",
"watermark": false
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
本次请求的唯一标识，可用于排查问题
可选
created
integer
时间戳
可选
data
array
生成图片的结果列表
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
url
string
生成的图片链接，有效期为 24 小时
可选
JSON
{
"id": "as-2d08zf9zgm",
"created": 1776827546,
"data": [
{
"url": "http://qianfan-modelbuilder-img-gen.bj.bcebos.com/ernie-image-turbo/a1c5679a050145f5ba8e56c39b2f796c/a1c5679a050145f5ba8e56c39b2f796c/img-31871595-7d95-4cd7-4eec-ac5a8548a126.jpeg?authorization=bce-auth-v1%2FALTAKEDe5Wum0DnGzeUzScVC94%2F2026-04-22T03%3A12%3A43Z%2F86400%2Fhost%2F8fe568f87c9df66400fc7c3007d4f11642aace6c4e67f709b5185c1a20911f46"
}
]
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。
评价此篇文章