Amux AI

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。

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> Amux AI API 密钥(Bearer Token)。

请求

application/json
modelstring必填

模型 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默认 9

GIF 动图总帧数(2–16,默认 9),仅在纯生成且 output_format: "gif" 时生效;其余场景将被忽略并记录于 amux.notes。

渠道支持说明:adobe 渠道不支持(因不支持 gif);amux-special 渠道已完整支持。

frame_duration_msinteger默认 200

GIF 每帧持续时长(单位:毫秒,须 ≥ 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,360output_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 均可正常生成)。

尺寸规范

常用标准规格:

宽高比1K2K4K
1:11024x10242048x2048—
3:2 / 2:31536x1024 / 1024x1536——
4:3 / 3:41024x768 / 768x10242048x1536 / 1536x20483264x2448 / 2448x3264
16:9 / 9:16—2048x11523840x2160 / 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
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>"
    ]
  }
}