Create image

openai/gpt-image-2.5-sunburst 的文生图。走 OpenAI 兼容端点，官方 SDK 将 base_url 指向此处即可直接使用。

Sunburst 是 2.5 中偏向输出质量的型号，适用于对编辑精度与保真度要求较高的场景。 若以生成速度为先，请使用 gpt-image-2.5-flare。 两者参数面完全一致，差异仅在行为表现。

鉴权

header

Authorizationstring必填

Bearer <你的 Amux 密钥> 站内 API Key。

请求

application/json

modelstring必填

站内模型 ID，可带 :供应商 后缀锁定供应商。

promptstring必填

提示词。

ninteger默认 1

出几张（1–10，默认 1）。按张计费，预扣也按张乘。 流式时必须是 1。

sizestring

精确像素串或 auto（默认）。常用档位：1024x1024（1:1）、

1536x1024 / 1024x1536（3:2 横 / 竖）、

1024x768 / 768x1024（4:3 横 / 竖）、2048x2048（2K 见方）、

2048x1152（16:9）、2048x1536 / 1536x2048（2K 4:3）、

3840x2160 / 2160x3840（4K 16:9）、

3264x2448 / 2448x3264（4K 4:3）。

除此之外，任意满足下列约束的像素串都可以：两边都是 16 的倍数、

长边 ≤ 3840、宽高比 ≤ 3:1、总像素数在 655,360 – 8,294,400 之间。

长边取满 3840 时另一边最多 2160，因此那一档只有 16:9 及更宽；

像素上限内最大的 4:3 是 3264x2448。

⚠️ 尺寸直接决定出图 token 数，也就是价格。

auto 不受这些约束——实际出了多大，看响应里的 size。

它与 Google 系的「比例 + 分辨率档」并列，打到只认另一套的上游时

我们会换算并在 amux.notes 里说明。

aspect_ratiostring

1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 16:9 / 9:16。 size 的另一种写法（Google 生态的说法），两者给一个就够； 同时给时以 size 为准，并在 amux.notes 里说明。

⚠️ 建议优先使用 size。 这条上游只接受精确像素串，因此比例会连同 image_size（若提供）一起折算为其中一档。折算是有损的：没有精确匹配的 比例会被近似为最接近的一档，实在没有接近的则整个丢弃——两种情况都会在 amux.notes 中说明。size 表达的是确切的结果，且原样透传。

image_sizestring

1K / 2K / 4K。和 aspect_ratio 搭配用，规则同上。

quality"low" | "medium" | "high" | "xhigh" | "max" | "auto"默认 "auto"

渲染质量。它决定出图 token 数，因而直接影响价格—— 档位之间可以差一个数量级。

background"transparent" | "opaque" | "auto"默认 "auto"

透明背景要配 png 或 webp，jpeg 没有 alpha 通道。 透明背景目前仍是预览能力。

output_format"png" | "jpeg" | "webp"默认 "png"

输出格式，默认 png。

output_compressioninteger默认 100

压缩级别，只对 jpeg / webp 有意义。

moderation"auto" | "low"默认 "auto"

内容审核强度。只有生成端点有这个参数。

userstring

端用户标识，用于滥用追踪。不需要就整个别传。

streamboolean默认 false

以 SSE 流式返回。要求 n 为 1，且这个模型至少有一条支持流式的供应商。

partial_imagesinteger默认 0

流式时给几张低清预览。0（默认）表示只发最后那一个完成事件。 实际可能比要的少——图出得快时上游会直接发完成事件。

响应

200response

出图成功。data 与 usage 与 OpenAI 一致，amux 是我们的扩展。

400response

请求不合法。也包括「要流式但没有支持流式的供应商」与「流式时 n 大于 1」 ——两者都会说清怎么改。

402response

可用余额不足以覆盖这次请求的预扣上界。可用 = 余额 − 已过期批次 − 已冻结的预扣。

503response

没有可用供应商。两种常见原因：这个模型还没有配图像供应商，

或者你要的尺寸档位在该供应商上没有配价——后者的细节在 metadata 里。

质量档#

GPT-Image-2.5 支持五个质量档加 auto，在 high 之上新增 xhigh 与 max。 这五档是相互独立的档位而非别名：各档对应不同的出图 token 数，计费随之不同。

xhigh 与 max 为 2.5 专有，发送给 gpt-image-2 或 gpt-image-1.5 会被上游拒绝。

上面的分档数字是在 flare 上量的。sunburst 计费相同：max 档下两个模型在 1024x704、2048x2048、3840x2160 三个尺寸上的出图 token 完全一致。 两者的差别在耗时，不在账单。

从 gpt-image-2 迁移时需注意，档位并非一一对应：同样尺寸下，2.5 的 high 对应 2.0 medium 的成本，2.5 的 max 对应 2.0 high 的成本。 将 quality 原值照搬会同时改变输出效果与计费。

官方价格参考#

下表为 OpenAI 的官方公开标价，仅作为选择参数时的量级参照。 这不是我们的收费：走本网关的请求，计费低于 OpenAI 官方标价。 我们的准确单价见模型详情页， 某一次调用实际花了多少，读响应里的 usage。

该模型的官方 token 单价为：文本输入 $5/M、文本缓存输入 $1.25/M、图像输入 $8/M、 图像缓存输入 $2/M、出图 $30/M。总成本由出图一项主导，因此按官方标价， 一张 1024x1024 的图大致为：

尺寸对总成本的影响与质量档相当。均在 max 档下：

注意最后两行：4K 略低于 2K 见方——出图 token 在 14,000 上下饱和， 并不随像素数持续增长。

尺寸与成本#

常用档位：

除此之外，任意满足下面四条的像素串都合法：两边都是 16 的倍数、 长边 ≤ 3840、宽高比 ≤ 3:1、总像素数在 655,360 – 8,294,400 之间。

长边取满 3840 时另一边最多 2160，因此该档位仅支持 16:9 及更宽的比例； 像素上限内最大的 4:3 是 3264x2448。

建议优先使用 size。 aspect_ratio 与 image_size 是另一种写法，但这条上游 只接受精确像素串，因此这一对会被折算为上表中的某一档。折算是有损的：不在表内的比例 会被近似为最接近的一档，实在没有接近的则整个丢弃——两种情况都会在 amux.notes 中说明。size 表达的是确切的结果，且原样透传。

auto 不受这些约束——想知道实际出了多大，读响应里的 size。

由于出图 token 会饱和而非随像素数持续增长，尺寸更大并不必然更贵。 请按实际需要的尺寸选择，而非按推测的成本高低选择。

耗时#

实测 quality: max 生成一张 1024x704 约需 106 秒。请预留充足余量：调高客户端与 代理的超时时间，或改用任务端点 替代同步端点。

产物保留#

响应的 amux.images 里是可直接访问的地址，data[].b64_json 是这一次的图。 存储产物在保留期后会被清理。 需要长期保存的请及时下载；清理后地址返回 404。

流式#

stream: true 按 SSE 返回，partial_images（0–3）决定给几张低清预览。 最终图与 usage 在同一个完成事件里；如果出图很快，预览张数可能少于请求值。

流式时 n 必须为 1。当前若无任何渠道支持图像流式，请求将被拒绝并附带说明； 移除 stream 后该模型仍可正常调用。

错误#

错误体形状与 OpenAI 一致，type 取值与重试语义见错误与重试。

curl https://gateway.amux.ai/v1/images/generations \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "openai/gpt-image-2.5-sunburst",
    "prompt": "A red fox sitting in snow, photorealistic",
    "size": "1024x1024"
  }'

{
  "created": 1786000000,
  "size": "<string>",
  "quality": "<string>",
  "background": "<string>",
  "output_format": "<string>",
  "data": [
    {
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0
  },
  "amux": {
    "task_id": "<string>",
    "generation_id": "<string>",
    "provider": "<string>",
    "cost_nano": "<string>",
    "images": [
      {
        "index": 0,
        "url": "<string>"
      }
    ],
    "notes": [
      "<string>"
    ]
  }
}