Amux AI

Create image

最近更新：2026年9月1日

通过 OpenAI Images 兼容端点生成图像。官方 SDK 可直接使用。

这个端点兼容 OpenAI 的 Images 接口，用于文生图。官方 SDK 可直接使用，只需把 base_url 指过来。

下表列出全部请求参数，含取值范围与使用上的前置条件。

POSThttps://gateway.amux.ai/v1/images/generations

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。

请求

application/json
modelstring必填

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

promptstring必填

提示词。

ninteger默认 1

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

sizestring

精确像素串或 auto（默认）。

⚠️ 取值域逐模型不同：

- gpt-image-1.5：封闭集，只有 1024x1024 /

1536x1024 / 1024x1536 / auto。其余像素串一律被上游拒绝，

即使满足下面四条约束也不例外；

- **gpt-image-2、gpt-image-2.5-flare、

gpt-image-2.5-sunburst**：以上三档再加 2048x2048、

2048x1152、3840x2160、2160x3840，4:3 与 3:4 的

1024x768 / 768x1024 / 2048x1536 / 1536x2048 /

3264x2448 / 2448x3264，以及任意满足这四条的像素串

——两边都是 16 的倍数、长边 ≤ 3840、宽高比 ≤ 3:1、

总像素数在 655,360 – 8,294,400 之间。长边取满 3840 时另一边

最多 2160，因此那一档只有 16:9 及更宽；像素上限内最大的 4:3

是 3264x2448。

发一个当前模型不收的档位会被上游拒。逐模型的准确取值域见

该模型的专属文档。

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

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

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

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

aspect_ratiostring

size 的另一种写法（Google 生态的说法），和 image_size 搭配用。 两套给一个就够；同时给时以 size 为准。取值域逐模型不同，见模型页。

⚠️ OpenAI 那几个模型上建议优先使用 size。 它们的上游只接受精确 像素串，比例会被折算为其中一档；折算有损，没有精确匹配的比例会被近似或 丢弃，并在 amux.notes 中说明。xAI 的出图正好相反：它原生接受 aspect_ratio，且完全不接受 size。

image_sizestring

分辨率档，和 aspect_ratio 搭配用。取值域逐模型不同，见模型页。

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

⚠️ 取值域逐模型不同：xhigh 与 max 只有 gpt-image-2.5-flare 与 gpt-image-2.5-sunburst 接受，发给 gpt-image-2 或 gpt-image-1.5 会被上游拒绝；xAI 的出图只收 low / medium / auto。

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

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

透明背景要配 png 或 webp，jpeg 没有 alpha 通道。 gpt-image-2 上的透明背景仍是预览能力。

output_format"png" | "jpeg" | "webp"

输出格式，默认 png。

output_compressioninteger默认 100

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

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

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

userstring

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

streamboolean默认 false

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

partial_imagesinteger

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

响应

200response

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

400response

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

402response

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

503response

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

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

支持的模型

六个：gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2、 gpt-image-1.5、x-ai/grok-imagine-image-2.0、x-ai/grok-imagine-image-quality。

⚠️ 上面的参数面板是这条端点的并集，不是任何单个模型真正收的那一套。 两家表达尺寸的方式就不同：OpenAI 那四个用精确像素串（size）， xAI 那两个用「比例 + 分辨率档」（aspect_ratio + image_size）， 并且不接受 size。

GPT-Image-2.5 的两个型号参数面完全相同，差别在延迟与出图质量，不在收哪些参数。

gpt-image-2.5（flare / sunburst）gpt-image-2gpt-image-1.5grok-imagine-image-2.0grok-imagine-image-quality
尺寸常用档 + 任意合法像素串（最高 4K）同左仅 1024x1024 / 1536x1024 / 1024x1536 / auto，其余一律拒绝aspect_ratio + image_size（1K / 2K）同左
qualitylow / medium / high / xhigh / max / autolow / medium / high / auto同 gpt-image-2low / medium / auto不支持
input_fidelity不支持不支持支持——
流式支持支持支持不支持不支持
文本输出 token无无有（内部推理，按输出文本价计费）无无

⚠️ xhigh 与 max 只有 GPT-Image-2.5 有，发给 gpt-image-2 或 gpt-image-1.5 会被上游拒绝。档位在代际之间也不是一一对应的：同样尺寸下，2.5 的 high 花的是 2.0 medium 的钱，2.5 的 max 花的是 2.0 high 的钱。

只想调某一个模型的话，用它的专属文档更省事： gpt-image-2.5-flare · gpt-image-2.5-sunburst · gpt-image-2 · gpt-image-1.5 · grok-imagine-image-2.0 · grok-imagine-image-quality。

和文本端点不同的两点

产物我们会转存。 响应的 amux.images 里是可直接访问的地址。这些产物会被清理 ——需要长期保存请尽快下载，到期后地址返回 404。

提交时按上界预扣。 出图成功后按实际结算、释放差额。余额不足以覆盖上界时 直接 402，而不是先出图再发现扣不出来。

流式

stream: true 按 SSE 返回，事件与 OpenAI 一致：若干个 image_generation.partial_image，最后一个 image_generation.completed 带最终图与 usage。

两条限制：n 必须为 1（流式事件里没有标明「第几张」的字段）； 只有声明支持流式的供应商参与路由，一条都没有时明确报错，不静默降级。

不支持的参数

response_format（gpt-image 恒定返回 base64）、style（dall-e 专有）、 seed（官方图像端点没有这个参数）。发过来会被丢掉，并在 amux.notes 里说明。

⚠️ 图像链路没有未知参数透传（文本链路有），参数面板之外的字段不会送给上游。

错误

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

cURL
curl https://gateway.amux.ai/v1/images/generations \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "openai/gpt-image-2",
    "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>"
    ]
  }
}