Create image
最近更新：2026年9月1日
通过 OpenAI Images 兼容端点生成图像。官方 SDK 可直接使用。
这个端点兼容 OpenAI 的 Images 接口，用于文生图。官方 SDK 可直接使用，只需把 base_url 指过来。
下表列出全部请求参数，含取值范围与使用上的前置条件。
https://gateway.amux.ai/v1/images/generations鉴权
headerAuthorizationstring必填Bearer <你的 Amux 密钥> 控制台创建的 Amux 密钥。忘了可以回控制台的密钥页再看一次。
请求
application/jsonmodelstring必填站内模型 ID，可带 :供应商 后缀锁定供应商。
promptstring必填提示词。
ninteger默认 1出几张（1–10，默认 1）。按张计费，预扣也按张乘。 流式时必须是 1。
sizestring精确像素串或 auto（默认）。
⚠️ 取值域逐模型不同：
- gpt-image-1.5：只有 1024x1024 / 1536x1024 /
1024x1536 / auto；
- gpt-image-2：以上再加 2048x2048、2048x1152、
3840x2160、2160x3840，以及任意满足这四条的像素串
——两边都是 16 的倍数、长边 ≤ 3840、宽高比 ≤ 3:1、
总像素数在 655,360 – 8,294,400 之间。3840x2160 正好压在
像素上限上，所以 4K 只有 16:9 这一种比例。
发一个当前模型不收的档位会被上游拒。逐模型的准确取值域见
该模型的专属文档。
⚠️ 尺寸直接决定出图 token 数，也就是价格。
auto 不受这些约束——实际出了多大，看响应里的 size。
它与 Google 系的「比例 + 分辨率档」并列，打到只认另一套的上游时
我们会换算并在 amux.notes 里说明。
aspect_ratiostringsize 的另一种写法（Google 生态的说法），和 image_size 搭配用。 两套给一个就够；同时给时以 size 为准。折成精确像素是有损的， 折不出对应档位时会丢掉并在 amux.notes 里说明。取值域逐模型不同，见模型页。
image_sizestring分辨率档，和 aspect_ratio 搭配用。取值域逐模型不同，见模型页。
quality"low" | "medium" | "high" | "auto"默认 "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 与 gpt-image-1.5。两者收的参数基本一致，差异只有两处
（下表），逐参数的取值域见上面的参数面板。
| gpt-image-2 | gpt-image-1.5 | |
|---|---|---|
size | 三档常用值 + 任意合法像素串（最高 4K） | 只有 1024x1024 / 1536x1024 / 1024x1536 / auto |
| 文本输出 token | 无 | 有（内部推理，按输出文本价计费） |
只想调某一个模型的话，用它的专属文档更省事： gpt-image-2 · gpt-image-1.5。
和文本端点不同的两点
产物我们会转存。 响应的 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 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>"
]
}
}