图片 / GPT 官方直连

OAI 官方直连 · 按量

OpenAI 官方 Image 模型直连：请求原样交给官方接口出图，原生 1K–4K，不经过网页端逆向和超分。按官方返回的 usage 以 Token 计费，失败不扣费。与 #184 写法相同、换 Key 即可切换；本组额外支持流式与异步，每张图实时校验 OpenAI 官方 C2PA 签名。

分组 #185「【GPT 官方直连按量】OAI · Image 2 / Flare / Sunburst」 · Key 需属于该分组

文生图图生图原生 1K–4K按 Token 计费URL 返回Base64 返回流式异步C2PA 签名

价格—

24 小时成功率—

可用模型

模型	说明	价格
`gpt-image-2.5-flare`	quality 支持 low / medium / high / xhigh / max；每 1M token 基础价：输入 $5 / 输出 $30 / 缓存读 $1.25 / 图片输入 $8 / 图片输出 $30	—
`gpt-image-2.5-sunburst`	quality 支持 low / medium / high / xhigh / max；出图带 OpenAI 官方 C2PA 内容凭证；每 1M token 基础价：输入 $5 / 输出 $30 / 缓存读 $1.25 / 图片输入 $8 / 图片输出 $30	—

`POST /v1/images/generations`	文生图，JSON
`POST /v1/images/edits`	图片编辑，multipart，参考图字段 image
`POST /v1/images/generations/async`	异步文生图，按返回的 poll_url 轮询，结果为 24 小时内有效的图片链接
`POST /v1/images/edits/async`	异步图片编辑，按返回的 poll_url 轮询
`GET /v1/models`	免费，可用来验证 Key

计费方式	按 Token：单价 = OpenAI 官方价 × 分组倍率 2.5；官方价每 1M token 文字输入 $5、图片输入 $8、图片输出 $30、缓存读取 $1.25
实测每张（倍率 2.5，16:9 文生图）	1K low 约 $0.012、1K high 约 $0.072；2K medium 约 $0.030、2K high 约 $0.108、2K max 约 $0.43；4K medium 约 $0.065、4K high 约 $0.25、4K max 约 $1.00
size	宽x高，边长为 16 的倍数，最长边不超过 3840，长宽比不超过 3:1
quality	low / medium / high；2.5 两个模型另有 xhigh / max（已实测）
返回格式	默认 b64_json（Base64 PNG）；url 返回本站图片链接，无需 Key 下载，1 小时后 404
异步结果	图片链接 24 小时内有效
耗时	1K 约 20–35 秒，2K 约 20–50 秒，4K 约 40–70 秒，max 最长约 100 秒
超时建议	不少于 300 秒

字段	类型		说明
`model`	string	必填	模型名，见上方模型列表
`prompt`	string	必填	中英文都可以
`size`	string	可选	宽x高，例如 1024x1024、1280x720、2048x1152、3840x2160（均实测）；边长为 16 的倍数，最长边不超过 3840，长宽比不超过 3:1
`quality`	string	可选	low / medium / high，2.5 模型另有 xhigh / max；越高越慢、越贵，建议显式填写
`n`	integer	可选	建议 1
`response_format`	string	可选	b64_json（默认）或 url
`image`	file	可选	编辑接口必填，multipart 文件字段，PNG / JPEG / WebP；参考图按图片输入 Token 计费
`stream`	boolean	可选	仅本组：true 时返回流式预览，预览图是上游的加载动画，成品图与非流式相同

价格随尺寸、quality 和参考图变化，没有固定的每张价格，以响应里的 usage 和使用记录为准。
建议显式传 quality；不传时由上游自动选择，同一尺寸的价格可能相差几倍。
请求失败（HTTP 4xx / 5xx）不扣费；错误体为 {"error": {"type", "message", "request_id"}}，反馈问题时附上 request_id。
编辑时参考图另计图片输入 Token：一张 512×512 参考图约 1024 Token。
4K 的 Base64 响应可达 15–26 MB，国内网络下载可能要几分钟甚至更久，建议用 response_format=url 再单独下载。
大批量并发时控制同时进行的请求数，避免下载互相抢带宽。
C2PA 签名需用接口直接返回的原始文件验证；经转码、压缩、裁剪或图床处理后签名会失效。
GET /v1/models 免费，可用来验证 Key。
流式和异步只在 #185 开放；异步用 /async 接口提交，按返回的 poll_url 轮询。
C2PA 检测确认 softwareAgent 为 API/gpt-image（官方 API，不是 ChatGPT 网页版），签发工具为 OpenAI Media Service API。

返回	原因与处理
`400 Invalid size '1000x1000'. Width and height must both be divisible by 16.`	参数不合法（尺寸、quality，或编辑接口缺少 image）；按参数表修改，不要原样重试。
`401 INVALID_API_KEY / API_KEY_REQUIRED`	没带 Key 或 Key 错误；检查 Authorization 请求头。
`403 INSUFFICIENT_BALANCE`	账户余额不足；充值后重试。
`404 Model "…" is not available for this group`	模型不在这个 Key 的分组；换模型或换 Key。
`429 API_KEY_QUOTA_EXHAUSTED 等`	Key 额度用完或请求过快；在控制台调高 Key 额度，或降低并发。
`502 / 503 Upstream service temporarily unavailable`	上游临时故障；稍后重试。