Create image
最近更新:2026年11月23日
通过 OpenAI 兼容端点调用 openai/gpt-image-2.6-flare 生成图像,支持 SVG 矢量、GIF 动图与复杂度控制。
通过 OpenAI Images 兼容端点调用 openai/gpt-image-2.6-flare 执行文生图。将 OpenAI 官方 SDK 的 base_url 指向网关地址即可直接调用。
Flare 是 GPT-Image 2.6 系列中的低延迟型号,在保持 2.6 代新特性(svg 矢量输出、gif 动图与帧率控制、complexity 复杂度档位)的同时显著降低端到端耗时。若优先追求复杂场景的细节还原与高保真画面表现,请选用 gpt-image-2.6-sunburst。
https://gateway.amux.ai/v1/images/generations鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> Amux AI API 密钥(Bearer Token)。
请求
application/jsonmodelstring必填模型 ID(openai/gpt-image-2.6-flare),可附加 :amux-special 或 :adobe 后缀指定供应商(:openai 与 :azure 暂未上线)。
promptstring必填图像生成文本提示词,上限 32,000 字符。
ninteger默认 1单次生成的图像张数(1–10,默认 1)。output_format 为 svg 或开启流式传输时必须为 1。
sizestring输出图像像素尺寸或 auto(默认)。常用规格包括 1024x1024(1:1)、1536x1024 / 1024x1536(3:2 / 2:3)、1024x768 / 768x1024(4:3 / 3:4)、2048x2048(2K 1:1)、2048x1152(16:9)、2048x1536 / 1536x2048(2K 4:3 / 3:4)、3840x2160 / 2160x3840(4K 16:9 / 9:16)及 3264x2448 / 2448x3264(4K 4:3 / 3:4)。
自定义像素尺寸需满足:宽高均为 16 的倍数、长边 ≤ 3840、宽高比 ≤ 3:1、总像素数介于 655,360 至 8,294,400 之间。
渠道差异:adobe 支持真原生 4K 与精确自定义像素(严格校验总像素 ≥ 655,360,如 512x512 会被拒绝);amux-special 非 4K 规格会按比例输出约 1.57MP(如 16:9 为 1672x941、1:1 为 1254x1254),4K(3840x2160)为后处理超分。
aspect_ratiostring宽高比(1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 16:9 / 9:16),作为 size 的替代写法。建议优先使用 size 直接指定精确像素尺寸;同时提供时以 size 为准,折算或忽略说明记录于 amux.notes。
image_sizestring分辨率档位(1K / 2K / 4K),与 aspect_ratio 配合使用,折算规则同 aspect_ratio。
quality"low" | "medium" | "high" | "xhigh" | "max" | "auto"默认 "auto"渲染质量档位(low / medium / high / xhigh / max / auto)。amux-special 与 adobe 渠道均已支持。
complexity"low" | "medium" | "high"默认 "high"GPT-Image 2.6 新增参数,控制画面构图与元素复杂度(low / medium / high,默认 high)。amux-special 与 adobe 渠道均已支持。
background"transparent" | "opaque" | "auto"默认 "auto"背景模式。设为 transparent 时,output_format 须为 png、webp 或 gif(jpeg 不含透明通道)。
output_format"png" | "jpeg" | "webp" | "svg" | "gif"默认 "png"输出图像文件格式,默认 png。GPT-Image 2.6 新增 svg(矢量图,仅支持纯生成且 n=1)与 gif(动图,仅支持纯生成);两者均不支持流式传输。
渠道支持说明:adobe 渠道不支持 svg 与 gif(仅支持 png / jpeg / webp)。未锁定供应商时,请求 svg 或 gif 会自动路由至 amux-special;显式指定 :adobe 将返回 400。
output_compressioninteger默认 100图像压缩比(0–100,默认 100),仅对 jpeg 与 webp 格式生效。
frame_countinteger默认 9GIF 动图总帧数(2–16,默认 9),仅在纯生成且 output_format: "gif" 时生效;其余场景将被忽略并记录于 amux.notes。
渠道支持说明:adobe 渠道不支持(因不支持 gif);amux-special 渠道已完整支持。
frame_duration_msinteger默认 200GIF 每帧持续时长(单位:毫秒,须 ≥ 20 且为 10 的倍数,默认 200),仅在纯生成且 output_format: "gif" 时生效;其余场景将被忽略并记录于 amux.notes。
渠道支持说明:adobe 渠道不支持(因不支持 gif);amux-special 渠道已完整支持。
moderation"auto" | "low"默认 "auto"内容安全审核严格度,仅图像生成端点支持。
userstring终端用户唯一标识,用于异常调用识别与滥用防控;无需使用时请省略。
streamboolean默认 false是否启用 SSE 流式返回。启用时要求 n 为 1 且 output_format 不能为 svg 或 gif。
渠道支持说明:当前已上线的 amux-special 与 adobe 渠道均不支持流式传输(开启将直接返回 400);待 openai / azure 官方渠道上线后可用。
partial_imagesinteger默认 0流式模式下返回的低清预览图像数量上限(0–3,默认 0)。不可与 svg / gif 同时使用。
渠道支持说明:依赖流式传输,当前已上线的 amux-special 与 adobe 渠道均不支持;待 openai / azure 官方渠道上线后可用。
响应
200response图像生成成功。data 与 usage 与 OpenAI 官方结构一致,amux 为网关扩展字段。
400response请求参数无效(包括 svg/gif 约束冲突、所选渠道不支持 svg/gif/stream,或流式模式下 n > 1)。
402response工作区可用余额不足以覆盖本次请求的预留额度。
503response服务暂时不可用,或所请求的模型与尺寸规格当前不可用。
供应商差异与可用状态
openai/gpt-image-2.6-flare 规划接入四家供应商,可通过在 model 后附加 :供应商 后缀(例如 openai/gpt-image-2.6-flare:adobe)显式锁定;不加后缀时由网关按路由策略及请求参数能力自动选择。实时单价请参阅模型详情页。
| 供应商 | 状态 | 计费方式与定位 | 4K 与尺寸表现 | 不支持的参数 |
|---|---|---|---|---|
amux-special | 已上线 | 低价按次计费(低价质量层) | 非 4K 规格按比例输出约 1.57MP(如 16:9 为 1672x941、1:1 为 1254x1254);4K(3840x2160)为后处理超分 | stream、partial_images |
adobe | 已上线 | 偏低价按次计费(低价质量层,略高于 amux-special) | 真原生 4K(3840x2160)与精确自定义像素;严格校验总像素 ≥ 655,360 | output_format: svg / gif、frame_count、frame_duration_ms、mask、markup、stream、partial_images |
openai | 暂未上线 | 官方渠道按 token 计费 | 官方原生全规格 | —(按官方 2.6 规范全量适配,上线后启用) |
azure | 暂未上线 | 官方 Azure OpenAI 按 token 计费 | 官方原生全规格 | —(已适配 Azure 部署端点,上线后启用) |
自动避让机制:未显式锁定供应商时,若请求指定了
output_format: "svg"、output_format: "gif"、mask或markup,网关会自动跳过不支持这些能力的adobe供应商并路由至amux-special;若显式指定:adobe并传入上述参数,网关将直接返回400明确提示。
2.6 系列新增参数
complexity(构图与细节复杂度)
支持 low、medium、high(默认 high),独立于 quality 控制画面的构图密度与元素丰富度。当前已上线的 amux-special 与 adobe 均支持该参数。
output_format: "svg" 与 "gif"
svg:输出可编辑矢量图,仅支持文生图(不可用于编辑),要求n = 1且不能开启stream。托管在amux.images的.svg链接会携带Content-Disposition: attachment响应头以保障浏览器安全。gif:输出循环动图,仅支持文生图,不能开启stream。可通过frame_count(2–16,默认9)控制总帧数,通过frame_duration_ms(≥ 20 且为 10 的倍数,默认200)控制每帧时长。- 渠道说明:
adobe渠道不支持svg、gif、frame_count与frame_duration_ms;如需矢量或动图输出,请勿锁定:adobe(默认或锁定:amux-special均可正常生成)。
尺寸规范
常用标准规格:
| 宽高比 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | — |
| 3:2 / 2:3 | 1536x1024 / 1024x1536 | — | — |
| 4:3 / 3:4 | 1024x768 / 768x1024 | 2048x1536 / 1536x2048 | 3264x2448 / 2448x3264 |
| 16:9 / 9:16 | — | 2048x1152 | 3840x2160 / 2160x3840 |
自定义像素尺寸需同时满足:宽高均为 16 的倍数、长边 ≤ 3840、宽高比 ≤ 3:1、总像素数介于 655,360 – 8,294,400 之间。如需精确 4K 原生渲染,推荐指定 :adobe;如需高性价比常规出图或动图/矢量图,推荐 :amux-special。
产物保留期限
响应中的 data[].b64_json 返回当次生成图像的 Base64 数据,amux.images 提供可直接访问的图像文件链接。托管链接具有时效性,到期清理后访问将返回 404,如需长期保存请及时下载。
流式传输
当前已上线的 amux-special 与 adobe 供应商均不支持 stream: true 与 partial_images(请求传入 stream: true 将直接返回 400,不会静默降级)。待 openai / azure 官方渠道上线后即可使用流式预览帧。
错误处理
错误响应结构与 OpenAI 官方规范一致,type 取值与重试策略见错误与重试。
curl https://gateway.amux.ai/v1/images/generations \
-H "Authorization: Bearer $AMUX_API_KEY" \
-d '{
"model": "openai/gpt-image-2.6-flare",
"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>"
]
}
}