GPT Image 2.5 图像生成 | API 文档

gpt-image-2.5-flare 适合快速出图；gpt-image-2.5-sunburst 侧重编辑精度。先通过 GET https://api.requestbeam.com/v1/models 确认当前 API Key 可用的模型。

请求

http

POST https://api.requestbeam.com/openai/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

json

{
  "model": "gpt-image-2.5-flare",
  "prompt": "白色桌面上的红色陶瓷杯",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "n": 1
}

参数	可选值
`model`	必填：`gpt-image-2.5-flare` 或 `gpt-image-2.5-sunburst`
`prompt`	必填：图片内容或编辑要求
`n`	1 至 4 的整数，默认 1
`size`	`auto`、宽高比或精确像素，例如 `1600x1200`
`resolution`	`1k`（默认）、`2k`、`4k`；精确像素尺寸会忽略此项
`quality`	`low`、`medium`、`high`、`xhigh`、`max`、`auto`（默认）
`image_urls`	最多 16 个公网可访问的 HTTP(S) 图片 URL
`output_format`	`png`（默认）、`jpeg`、`webp`
`output_compression`	JPEG 或 WebP 压缩强度，0 至 100 的整数
`background`	`auto`、`opaque`、`transparent`；透明背景要求 PNG 或 WebP
`moderation`	`low`（默认）、`auto`
`stream`	`false`（默认）返回 JSON；`true` 返回 SSE 完成事件

支持的比例：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。精确像素尺寸的宽高均须为 16 的倍数，任意边不超过 3840 像素，长短边比不超过 3:1，总像素在 655,360 至 8,294,400 之间。方形 4k 为 2880x2880，并非 4096x4096。

参考图编辑

json

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "保留商品和包装文字，将背景换成白色摄影棚",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}

参考图复用此 JSON 生成接口。本地图片需要先上传到你自己的存储，取得可访问的 HTTP(S) URL。本模型公开合同不包含 base64 data URI、multipart 文件上传、mask 或独立的 /images/edits 接口。

获取结果

当前 HTTP 连接会等待生成完成，客户端无需轮询上游任务。JSON 响应包含最终图片 URL 及上游可用的 Token 用量：

json

{
  "created": 1789035000,
  "data": [{"url": "https://example.com/generated-image.png"}],
  "usage": {"input_tokens": 15, "output_tokens": 196, "total_tokens": 211}
}

stream: true 时，在同一个 SSE 连接等待 image_generation.completed 和 [DONE]。不保证提供中间图片预览。

计费

按实际文本输入、缓存文本输入、图片输入、缓存图片输入和图片输出 Token 计费。两个型号的 Token 单价相同。模型目录分别展示当前售价和 OpenAI 官方参考价。每张图片没有统一固定价格，提示词、参考图、尺寸、质量和张数都会影响总费用。请求开始时预留额度，完成后结算并返还差额；显式指定质量有助于估算用量。

参数无效返回 400，认证失败返回 401，余额不足返回 402，模型不可用返回 404，限流返回 429，生成失败返回 5xx。完成状态未知的请求不应直接重复提交。

完整错误码、流式错误和重试边界见错误码与错误处理。