资讯 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

图像生成

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

功能介绍

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

支持模型列表

  • ERNIE-iRAG-1.0

在线调试

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

鉴权说明

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

请求结构

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地址,如下图所示: image.png
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()

响应示例

{
    "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
下一篇
图像理解