image-2 调用文档

基于 OpenAI 兼容接口封装，使用 aigc.oagi.com.cn 作为接入域名。

接口说明

接口地址：POST https://aigc.oagi.com.cn/v1/images/generations

鉴权方式：Authorization: Bearer YOUR_API_KEY

请求格式：application/json

输出方式：默认返回 Base64 图片数据

模型名称：gpt-image-2

适用场景：

文生图

海报生成

商品图生成

封面图生成

高分辨率图片生成

请求头

请求参数

参数名	类型	必填	说明
`model`	string	是	固定填写 `gpt-image-2`
`prompt`	string	是	图片生成提示词
`size`	string	否	输出尺寸，默认 `auto`
`quality`	string	否	生成质量，可选 `low`、`medium`、`high`、`auto`
`n`	integer	否	生成图片数量，默认 `1`
`output_format`	string	否	输出格式，可选 `png`、`jpeg`、`webp`
`output_compression`	integer	否	`jpeg` 或 `webp` 压缩率，范围 `0-100`
`background`	string	否	背景模式，可选 `auto`、`opaque`、`transparent`
`moderation`	string	否	审核强度，可选 `auto`、`low`
`user`	string	否	业务侧用户标识，便于追踪

尺寸说明

gpt-image-2 支持灵活分辨率，常用推荐值如下：

1024x1024

1536x1024

1024x1536

2048x2048

2048x1152

3840x2160

2160x3840

auto

尺寸约束：

单边最大不超过 3840

宽高都必须是 16 的倍数

长边与短边比例不超过 3:1

总像素需在 655,360 到 8,294,400 之间

Curl 示例

如果需要直接保存图片：

Python 示例

Node.js 示例

请求示例

{
  "model": "gpt-image-2",
  "prompt": "生成一张高端咖啡品牌宣传海报，暖色灯光，真实摄影风格，画面包含英文标题 COFFEE HOUSE",
  "size": "1024x1536",
  "quality": "high",
  "n": 1,
  "output_format": "png",
  "moderation": "auto"
}

返回示例

{
  "created": 1710000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "usage": {
    "input_tokens": 123,
    "output_tokens": 1056,
    "total_tokens": 1179
  }
}

返回字段说明

字段	类型	说明
`created`	integer	时间戳
`data`	array	图片结果列表
`data[].b64_json`	string	Base64 编码后的图片内容
`usage.input_tokens`	integer	输入消耗
`usage.output_tokens`	integer	输出消耗
`usage.total_tokens`	integer	总消耗

错误响应示例

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

常见问题

1. 为什么返回的是 `b64_json`？

图片接口默认返回 Base64 内容，服务端或前端需要自行解码并保存成图片文件。

2. 哪种格式更适合线上使用？

png：无损，适合海报、UI、文字较多的图

jpeg：体积更小，适合普通展示图

webp：兼顾质量和体积，适合网页场景

3. 质量怎么选？

low：草稿预览，速度更快

medium：日常业务图

high：正式出图、广告图、封面图

4. 延迟大概多久？

复杂提示词或高分辨率图片通常耗时更长，复杂请求可能接近 1 到 2 分钟。

接入建议

优先从 1024x1024 + medium 开始联调

生产环境建议开启超时重试

如果主要关注速度，优先使用 jpeg

如果对画面中文字要求高，建议在提示词中明确字体布局、文案内容和排版位置

兼容性说明

本文档按 OpenAI 兼容 Images API 组织，适合直接用于以下 SDK 接入：

OpenAI Python SDK

OpenAI Node.js SDK

任何兼容 OpenAI 协议的 HTTP 客户端

如果你的实际网关不是 https://aigc.oagi.com.cn/v1，只需要替换 base_url 或请求域名即可，其他请求结构通常保持不变。

gpt-image-2接口调用

image-2 调用文档#

接口说明#

请求头#

请求参数#

尺寸说明#

Curl 示例#

Python 示例#

Node.js 示例#

请求示例#

返回示例#

返回字段说明#

错误响应示例#

常见问题#

1. 为什么返回的是 b64_json？#

2. 哪种格式更适合线上使用？#

3. 质量怎么选？#

4. 延迟大概多久？#

接入建议#

兼容性说明#