文档 · 模型

图片生成

2026-09-18

gpt-image-2.5-sunburst 和 -flare：两个端点、1K 与 2K 的单张价格、尺寸档位怎么定、图片链接从哪来。

目录里有两个图片模型，都属于 OpenAI 的 GPT Image 2.5 系列，都按张计费：

gpt-image-2.5-sunburst：画质最高的那一个，生成和编辑都能用。
gpt-image-2.5-flare：更快的那一个，端点和价格与前者相同。

gpt-image-2 已在 2026-09-18 下架，由这两个模型接替。

线路与端点

图片模型只在一条线路上出售，在 API 密钥 页面上显示为 OpenAI，线路名 图片生成（路由 id 是 image）。用 自动路由 密钥，请求同样会送到这里。

两个端点，都用 Authorization: Bearer <key> 鉴权：

POST /v1/images/generations（JSON 请求体）
POST /v1/images/edits（multipart 表单，带原图）

POST /v1/images/variations 没有实现，调用会收到 501，提示「This API is not implemented」。

curl https://ai.topxea.com/v1/images/generations \
  -H "content-type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"gpt-image-2.5-flare","prompt":"A lighthouse at dawn, watercolour","size":"1024x1024","n":1}'

价格与尺寸档位

两个模型价格相同：1K 一张 0.03 美元，2K 一张 0.05 美元。档位按你请求的 size 的像素总数决定，格式是 WIDTHxHEIGHT（宽x高），中间用半角字母 x：

不超过 1024x1024 像素（1,048,576）算 1K；
不超过 2048x2048 像素（4,194,304）算 2K；
再大的尺寸，或者任一边超过 4096，转发前就直接拒绝。

不填 size，或者填 "size": "auto"，都会在计价和转发前固定成 1024x1024，这样供应商不可能画出比你付费尺寸更大的图。如果供应商仍然报告了更高档位的输出尺寸，费用按那个档位补收；输出比请求小，则按原报价收。quality 会被校验，但不影响价格，价格只看 size 的档位。

n 可以取 1 到 128，费用按张数相乘。转发前，钱包里会先预留「单价乘以 n」的全额，所以 n 大的请求要有足够余额。结算时以实际返回的图片数为准，有一个例外：stream: true 的请求如果在流结束前断开，仍按请求的 n 张计费，不会因为收到第一张就断线而只付一张。

model、size、n、quality 这四个计价字段各只能出现一次，键名区分大小写（写成 Size 会被拒绝）；multipart 表单里重复出现同样拒绝。常见的拒绝原因，错误信息原文如下：

n must be an integer between 1 and 128
field "Size" is not accepted; use "size"
field "size" must be provided once
unsupported image size "<size>"
image size "<size>" exceeds the largest sold class (2K)

尺寸里写了乘号 × 也会被拒绝，错误信息会提示改用字母 x。

供应商一旦受理，客户端中途断开也照常结算：那边任务已经在跑，不管客户端还在不在都会计费。

图片链接从哪里来

响应里的每一个 url 都会换成本站的链接：

{
  "data": [{ "url": "https://ai.topxea.com/v1/images/content/<token>" }]
}

token 是一段加密并签名的凭据，把供应商的存储地址和访问凭证藏在里面。链接可以直接放进 <img> 标签，读取不需要 API 密钥。链接在响应生成一小时后失效，之后访问会返回 404，错误码 image_unavailable，提示「Generated image is unavailable or the link has expired」。要留存的图片请在一小时内下载。Base64 载荷（b64_json）原样透传。

读取链接时还有几条限制。整个站点同时最多取 4 张图，第 5 个并发读取会收到同样的 404 image_unavailable，稍后重试。一页里同时放很多 <img> 时可能碰到这种情况。只返回 image/png、image/jpeg、image/webp、image/gif 四种类型（按内容判断，其他一律 404），响应带 Cache-Control: private, max-age=300。单张图片读取上限 32 MiB。

模型：gpt-image-2.5-sunburst, gpt-image-2.5-flare · 模型与价格

图片生成

线路与端点

价格与尺寸档位

图片链接从哪里来

相关