跳转到主要内容
POST

授权

Authorization
string
header
必填

控制台获取的API密钥

请求体

application/json
model
string
必填

图像生成模型名称。可选值:

  • gpt-image-2.5-flare
  • gpt-image-2.5-sunburst
prompt
string
必填

图片生成或编辑的文字描述。仅传入提示词时生成图片;配合 image_urls 时根据参考图进行生成或编辑。

size
string
默认值:auto

输出图像的比例或精确像素尺寸。支持:

  • auto:由模型根据提示词或参考图决定
  • 比例名:1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3
  • 精确像素:例如 1600x1200
resolution
string
默认值:1k

分辨率档位,与比例形式的 size 配合决定实际输出像素。

  • 1k(默认)
  • 2k
  • 4k

当 size 使用精确像素格式时,此字段会被忽略。

quality
string
默认值:low

图片质量档位。

  • low(默认)
  • medium
  • high
  • xhigh
  • max
  • auto(在本网关中按 low 处理)
n
integer
默认值:1

本次生成的图片数量,1 至 4 张;省略时生成 1 张。

必填范围: 1 <= x <= 4
output_format
enum<string>
默认值:png

输出图片格式:png(默认)、jpeg 或 webp。

可用选项:
png,
jpeg,
webp
output_compression
integer

JPEG 或 WebP 的输出压缩参数,取值为 0 至 100。

必填范围: 0 <= x <= 100
background
string

背景设置:transparent、opaque 或 auto。透明背景仅适用于 PNG 或 WebP。

image_urls
string[]

图生图或图像编辑使用的参考图数组,最多 16 张。传入后自动进入编辑模式。支持公网可访问的 HTTP(S) URL。

mask_url
string

局部编辑蒙版。需与第一张参考图同尺寸,使用带 Alpha 通道的 PNG;可提供公开可访问的图片 URL 或 Data URI,且需同时提供 image_urls。

response_format
enum<string>
默认值:b64_json

返回格式:默认 b64_json 为 Base64 数据;url 为图片地址。

可用选项:
url,
b64_json

响应

生成成功,默认返回 Base64 图片数据;显式传入 response_format: url 时返回图片 URL

created
integer
data
object[]