图像生成
调用本接口，可根据用户输入的文本或图片生成图片。
支持模型列表
支持模型列表请参考千帆ModelBuilder-模型列表-图像生成。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
用于生图的模型，说明：
（1）预置服务，可选值请参考千帆ModelBuilder-模型列表-图像生成，表格中model入参列
模型
（2）平台训练模型或预置模型，可以通过查看服务详情获取该字段值，详情请查看千帆控制台-在线推理：model值为服务详情中对应的API名称，如下图所示：
所需生成图片的描述，
（1）irag-1.0说明如下
· 可支持中文、英文
· 长度不超过220个字符
（2）flux.1-schnell：最大为512，可支持英文
参考图图片链接，可基于该图进行参考生成，说明：
（1）图片限制说明：
· 大小：10MB以内
· 格式：支持PNG、JPG、JPEG、WEBP、BMP、ICO
· 长宽比例不超过不超过4倍
· 长或宽不低于128像素值
（2）仅支持irag-1.0
（3）支持以下：
· 传入图片链接，输入为图像 URL 时，URL 链接在UTF-8编码下最大不超过1024个字节，超出限制后图片无法下载
· 图片的Base64编码，传入 Base64 编码格式时，传入的格式需为：data:image/<图片格式>;base64,<Base64编码>
终端用户的唯一标识符
生成图片数量，说明：
· 默认值为1
· 取值范围为1-4
· 单次生成的图片较多及请求较频繁可能导致请求超时
支持自定义输出图片分辨率：
· 最小尺寸为512x512
· 最大尺寸为2048x2048
默认输出分辨率为1024x1024，建议输出分辨率为：
· 适用头像： ["768x768", "1024x1024", "1536x1536", "2048x2048"]
· 适用文章配图 ：["1024x768", "2048x1536"]
· 适用海报传单：["768x1024", "1536x2048"]
· 适用电脑壁纸：["1024x576", "2048x1152"]
· 适用海报传单：["576x1024", "1152x2048"]
说明：用户可在512x512-2048x2048之间入参图片输出分辨率，建议长宽比不要过大，分辨率尽可能在1024x1024左右，出图更清晰。输出分辨率过大或长宽比过大，会导致图片出图效果差
采样步数，说明：
（1）采样步数（steps）数值越大，效果更精细，运行时间更长，取值范围为1-50
（2）仅支持flux.1-schnell
随机种子，说明：
（1） 不设置时，自动生成随机数，取值范围 [0, 4294967295]
（2）仅支持flux.1-schnell
指导密度值，说明：用于在图像生成过程中调整模型的创造性与文本指导的紧密度。较高的值会使得生成的图像更忠于文本提示，但可能减少多样性；较低的值则允许更多创造性，增加图像变化。
（1）默认值为3.5，取值范围0-30
（2）仅支持flux.1-schnell
是否以流式接口的形式返回数据，说明：
（1）默认值为false
（2）仅支持irag-1.0 model 入参
控制是否添加水印标识，说明：
（1）默认为false
（2）若改为true，生成的图片右下角会自动添加“AI生成”字样的可见水印
POST /v2/images/generations HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "irag-1.0",
"prompt": "画一只小狗"
}示例代码
curl --location 'https://qianfan.baidubce.com/v2/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model": "irag-1.0",
"prompt": "画一只小狗"
}'import requests
import json
def main():
url = "https://qianfan.baidubce.com/v2/images/generations"
payload = json.dumps({
"model": "irag-1.0",
"prompt": "画一只小狗"
})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer bce-v3/ALTAK-*********/614fb**********'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
if __name__ == '__main__':
main()返回响应
本次请求唯一标识，可用于排查问题
时间戳
生成的图片列表
（1）当strem=false时模型响应列表仅包含url
（2）当strem=true时模型会在最后一个chunk返回生成的图片url
显示子属性
隐藏子属性
图片信息
显示子属性
隐藏子属性
图片链接，有效期24h
任务id
任务进度
任务状态，包括RUNNING, FAILED, SUCCESS三种状态
任务失败错误码，如：
image_generation_output_image_unsafe：输出图审不通过
{
"id": "as-p5vuu9vgsn",
"created": 1735264326,
"data": [
{
"url": "http://qianfan-modelbuilder-img-gen.bj.bcebos.com/irag-1.0/6c6093***cc5729de8/img-2039170e-7799-483a-75c4-5ad316ff3a8a.png?authorization=bce-auth-v1%2F5d****56ffa2"
}
]
}
错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。