跳转到主要内容
POST

授权

Authorization
string
header
必填

控制台获取的API密钥

请求体

application/json
model
string
必填

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

  • gpt-image-2.6-flare
  • gpt-image-2.6-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

图生图省略此字段时,按首张参考图比例选择尺寸。GIF 使用单帧像素尺寸,例如 384x384。

resolution
string
默认值:1k

分辨率档位:1k(默认)、2k、4k。使用精确像素尺寸时,此字段不决定输出大小。

quality
string
默认值:medium

图片质量档位:low、medium、high、xhigh、max、auto。本网关当前将省略或 auto 规范化为 medium。

n
integer
默认值:1

生成图片数量,1 至 4 张;省略时生成 1 张。SVG 仅支持 1。

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

输出格式:png、jpeg、webp、gif 或 svg。GIF 和 SVG 仅支持文生图,不能同时传参考图或蒙版;GIF 可设置帧数与帧间隔,SVG 需设置 svg.model。

可用选项:
png,
jpeg,
webp,
gif,
svg
frame_count
integer

仅用于 GIF 的帧数,范围为 2 至 16。

必填范围: 2 <= x <= 16
frame_duration_ms
integer

仅用于 GIF 的单帧时长(毫秒),至少 20,且为 10 的倍数。

必填范围: x >= 20必须是以下数值的倍数 10
svg
object

当 output_format 为 svg 时必填;仅支持文生图,且 n 为 1。

output_compression
integer

仅用于 JPEG 或 WebP 的压缩参数,范围为 0 至 100;GIF 与 SVG 不支持。

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

背景设置:auto、opaque 或 transparent;透明背景仅搭配 PNG 或 WebP。

image_urls
string[]

图像编辑的参考图数组,最多 16 张。使用公网可访问的 HTTP(S) 图片地址。

mask_url
string

局部编辑蒙版。需同时提供 image_urls;使用与首张参考图同尺寸、带透明通道的 PNG 图片地址或 Data URI。不能与 markup 同时提供。

markup
object

标注引导编辑,需同时提供 image_urls;不能与 mask_url 同时提供。传入包含 image_url 的对象,例如 {"image_url":"data:image/png;base64,..."}。

complexity
string
默认值:high

规划强度:low、medium、high;省略时为 high。此字段独立于图片质量 quality。

response_format
enum<string>
默认值:b64_json

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

可用选项:
url,
b64_json

响应

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

created
integer
data
object[]