Skip to main content
POST
如何选择模型: gpt-image-2.5-flare 速度更快,适合日常高质量出图、批量生成和快速原型;gpt-image-2.5-sunburst 更强调编辑精度,适合成品级商品图、投放创意和多轮精细编辑。两者计费标准相同。

认证

string
必填
所有接口均使用 Bearer Token 认证。访问 API Key 管理页面 获取密钥。

模型选择

两个模型的单价和相同参数下的 token 消耗一致,选择时只需考虑速度与质量取舍。 gpt-image-2 相比,GPT-Image-2.5 新增 xhighmax 两个质量档位;mediumhigh 的输出 token 消耗约为上一代同名档位的四分之一。

请求参数

string
必填
图像生成模型名称。可选值:
  • gpt-image-2.5-flare
  • gpt-image-2.5-sunburst
string
必填
图像生成或编辑的文本描述。支持中英文。建议说明主体、场景、构图、风格、光线以及需要保留或修改的内容。
string
默认值:"auto"
输出图像的比例或精确像素尺寸。支持:
  • auto:由模型根据提示词或参考图决定
  • 比例名:1:13:22:34:33:45:44:516:99:162:11:221:99:213:11:3
  • 精确像素:例如 1600x1200
图生图时建议不传 size,系统会根据输入图比例和 resolution 自动计算输出尺寸。
string
默认值:"1k"
分辨率档位,与比例形式的 size 配合决定实际输出像素。
  • 1k(默认)
  • 2k
  • 4k
size 使用精确像素格式时,此字段会被忽略。
string
默认值:"auto"
图片质量档位。
  • low
  • medium
  • high
  • xhigh
  • max
  • auto(默认,由模型运行时决定)
xhighmax 仅 GPT-Image-2.5 支持。将其传给 gpt-image-2 会同步返回 400,不会自动降级。
integer
默认值:"1"
生成图片数量,取值范围为 1 ~ 4必须传入数字,不要使用字符串。
string
默认值:"png"
输出文件格式。
  • png(默认,支持透明背景)
  • jpeg
  • webp(支持透明背景)
integer
输出压缩强度,范围为 0 ~ 100,仅对 jpegwebp 生效。
string
背景模式。可选值:transparentopaqueauto
background: "transparent" 只能与 output_format: "png"output_format: "webp" 搭配。JPEG 不支持 Alpha 通道。
string
默认值:"low"
内容审核强度。可选值:autolow未传时,APIMart 会显式使用 low;传入 auto 时则按 auto 执行。
string[]
图生图或图像编辑使用的参考图 URL 数组,最多 16 张。传入后自动进入编辑模式。仅接受公网可访问的 HTTP(S) URL。本地图片请先调用 POST /v1/uploads/images 上传,再使用返回的 url

尺寸规则

使用精确像素尺寸时,宽高必须同时满足以下条件:
  • 宽和高均为 16 的倍数
  • 任意单边不超过 3840 像素
  • 长边与短边之比不超过 3:1
  • 总像素在 655,360 ~ 8,294,400 之间
高于 2560×1440 的分辨率属于实验性范围,稳定性可能低于常用分辨率。

比例与分辨率映射

也可以直接传入满足尺寸规则的任意精确像素值,不限于上表中的组合。

使用示例

文生图

使用 Sunburst 精细编辑

多参考图编辑

透明背景

精确像素尺寸

提交响应

提交成功后会立即返回异步任务 ID:
data 是数组,请读取 data[0].task_id

查询任务结果

使用提交响应中的 task_id 调用 任务查询接口
建议每 2 ~ 5 秒轮询一次,直到状态变为 completedfailed

任务成功

图片地址位于 data.result.images[].url[]。请及时下载并转存,不要将临时 URL 用作长期存储。 批量查询多个任务时,可使用 POST /v1/tasks/batch

计费说明

GPT-Image-2.5 按实际 token 用量计费,Flare 与 Sunburst 单价相同。最终费用请以 价格页面/api/pricing 返回的实时值为准。

官方 token 单价

实际扣费还会受到账号分组倍率和折扣影响。

1024×1024 输出 token 参考

quality: "auto" 的实际档位由模型运行时决定。提交时会按当前尺寸的最高档 max 预留额度,任务完成后再按真实 token 用量结算并退回差额。余额敏感时建议显式指定 quality
n > 1 时,预扣额度会按图片数量线性增加,最终按实际生成张数结算。任务失败会自动退款。

输出 token 参考表

下表为各比例、分辨率和质量组合的单张图片输出 token 参考值。实际账单还会包含提示词及参考图的输入 token。

限制

常见错误

Response

integer
响应状态码,提交成功时为 200。
array
提交响应数据。