文档 · 模型

图片生成

2026-09-18

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

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

gpt-image-2.6-sunburst：画质最高的那一个，生成和编辑都能用。
gpt-image-2.6-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://api.topxai.xyz/v1/images/generations \
  -H "content-type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"gpt-image-2.6-flare","prompt":"A lighthouse at dawn, watercolour","size":"1024x1024","n":1}'

价格与尺寸档位

两个模型价格相同：1K 一张 0.03 美元，2K 一张 0.05 美元，4K 一张 0.20 美元。档位按图片的最长边决定，格式是 WIDTHxHEIGHT（宽x高），中间用半角字母 x：

两边都不超过 1024 算 1K，例如 1024x1024；
最长边不超过 2048 算 2K，例如 1280x720、1536x1024、2048x2048；
最长边超过 2048 算 4K，例如 2560x1440、3840x2160；
任一边超过 3840，或总像素超过 8,294,400，转发前就直接拒绝。

请求前按你要的尺寸预扣，最终按实际交付的图片结算。这条线路可能返回与请求不同的尺寸，目前大多是约 150 万像素（2K 档），所以请求 4K 不保证拿到 4K 图，实际拿到哪一档就按哪一档收。n 和 quality 同样不保证，按实际返回的图片计费。

不填 size，或者填 "size": "auto"，都会在计价和转发前固定成 1024x1024，这样供应商不可能画出比你付费尺寸更大的图。供应商报告的输出尺寸属于哪一档，就按哪一档结算，比请求大就补收，比请求小就退差价。quality 会被校验，但不影响价格，价格只看 size 的档位。

n 可以取 1 到 128，费用按张数相乘。转发前，钱包里会先预留「单价乘以 n」的全额，所以 n 大的请求要有足够余额。结算时以实际返回的图片数为准，有一个例外：stream: true 的请求如果在流结束前断开，仍按请求的 n 张计费，不会因为收到第一张就断线而只付一张。供应商返回的结果里一张图都没有时，按错误处理，不扣费：返回 502；流式请求如果已经发出过事件（比如预览图），流的最后是一条错误事件，没有 data: [DONE]。

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 (4K)
output_format "svg" is not available; use png, jpeg, webp or gif
frame_count must be a positive integer
frame_count requires output_format "gif"
output_format "gif" does not support streaming

这条线路暂不提供 GIF 和 SVG 输出，这类请求会被拒绝，不扣费。

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

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

图片链接从哪里来

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

{
  "data": [{ "url": "https://api.topxai.xyz/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.6-sunburst, gpt-image-2.6-flare · 模型与价格

图片生成

线路与端点

价格与尺寸档位

图片链接从哪里来

相关