图像生成

更新时间：2025-03-17

本文介绍了图像生成 V2版本相关API及使用。

功能介绍

调用本接口，可根据用户输入的文本或图片生成图片。

支持模型列表

ERNIE-iRAG-1.0

在线调试

平台提供了 API在线调试平台-示例代码，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用，更多内容请查看API在线调试介绍。

鉴权说明

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

请求结构

Bash

POST /v2/images/generations HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string

{
    "model": "irag-1.0",
    "prompt": "画一只小狗"
  }

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称	类型	必填	描述
model	string	是	用于生图的模型，说明：（1）预置服务，当前仅支持`irag-1.0` （2）平台训练模型，可以通过查看服务地址获取该字段值，详情请查看新手指南-平台使用快速开始：model值为在创建服务时对应的API地址，如下图所示：
prompt	string	是	所需生成图片的描述，说明：（1）只允许中文、常规标的符号和少量英文（2）长度不超过220个字符（3）默认生图尺寸为1024x1024，如果生图场景为：手抄报、黑板报、小红书封面、A3/A4纸、明信片、壁纸、传单、书籍封面等，生图尺寸非默认尺寸。可通过prompt设定图片生图尺寸与分辨率（并非百分百生效），具体设定需要符合以下要求： ① 长*宽接近1024x1024=1048576 ② 长和宽都能被32整除
refer_image	string	否	参考图图片链接，可基于该图进行参考生成；图片限制说明： · 大小：10MB以内 · 格式：支持PNG、JPG、JPEG、WEBP、BMP、ICO · 长宽比例不超过不超过4倍 · 长或宽不低于128像素值
user	string	否	终端用户的唯一标识符

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称	类型	描述
created	int	时间戳
data	list(object)	生成的图片列表

data说明

名称	类型	描述
url	string	图片链接，有效期24h

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()

响应示例

JSON

{
    "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	错误码
msg	错误描述信息，帮助理解和解决发生的错误
type	错误类型

更多相关错误码，请查看推理服务V2版本错误码说明。

重排序Reranker

图像理解