Amux AI

Create task

最近更新:2026年11月23日

提交 openai/gpt-image-2.6-flare 异步图像任务,统一支持文生图(含 SVG/GIF)与参考图编辑(含 markup)。

向 /v1/tasks 提交 openai/gpt-image-2.6-flare 异步任务:请求立即返回任务 id,图像生成在后台执行。

本端点不区分图像生成与图像编辑:省略 image 时执行文生图(支持 svg、gif、frame_count、frame_duration_ms),携带 image 时执行图像编辑(支持 mask 或 markup,两者互斥)。不携带参考图像时,也可使用 application/json 发送相同字段。

POSThttps://gateway.amux.ai/v1/tasks

鉴权

header
Authorizationstring必填

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

请求

multipart/form-data
modelstring必填

模型 ID(可附加 :amux-special 或 :adobe 后缀)。

promptstring必填

图像生成或编辑提示词,上限 32,000 字符。

imagearray<string>

可选参考图像文件列表。省略时执行图像生成,提供时执行图像编辑;最多 16 张,单张上限 25 MB。

字段名同时兼容 image 与 image[]。

maskstring

局部编辑蒙版文件,透明区域(alpha 为 0)指示重绘范围。与 markup 互斥,仅在同时提供参考图像时生效。

渠道支持说明:adobe 渠道不支持 mask(显式锁定 :adobe 将返回 400);amux-special 渠道已支持。

markupstring

GPT-Image 2.6 新增的视觉涂鸦/圈选标注图,与 mask 互斥,仅在同时提供参考图像时生效。

渠道支持说明:adobe 渠道不支持 markup(显式锁定 :adobe 将返回 400);amux-special 渠道已支持。

ninteger默认 1

生成图像张数(1–10,默认 1);output_format: "svg" 时必须为 1。

sizestring默认 "1024x1024"

输出图像像素尺寸,默认 1024x1024。adobe 支持真原生 4K 且严格校验总像素 ≥ 655,360;amux-special 非 4K 规格按比例输出约 1.57MP、4K 为后处理超分。

aspect_ratiostring

宽高比(1:1 / 4:3 / 3:4 / 3:2 / 2:3 / 16:9 / 9:16),作为 size 的替代写法。建议优先使用 size;同时提供时以 size 为准。

image_sizestring

分辨率档位(1K / 2K / 4K),与 aspect_ratio 配合使用,折算规则同 aspect_ratio。

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

low / medium / high / xhigh / max / auto。

complexity"low" | "medium" | "high"默认 "high"

GPT-Image 2.6 新增参数,控制画面构图与元素复杂度(low / medium / high,默认 high)。amux-special 与 adobe 渠道均已支持。

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

背景模式(transparent / opaque / auto)。透明背景须搭配 png、webp 或 gif 格式。

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

输出图像格式(png / jpeg / webp / svg / gif,默认 png)。svg 与 gif 仅支持纯生成(不可携带 image),且 svg 要求 n=1。

渠道支持说明:adobe 渠道不支持 svg 与 gif(显式锁定 :adobe 将返回 400);amux-special 渠道已完整支持。

output_compressionstring

图像压缩比(0–100,默认 100),仅对 jpeg 与 webp 格式生效。

frame_countinteger默认 9

GIF 动图帧数(2–16,默认 9),仅在纯生成且 output_format: "gif" 时生效。

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

frame_duration_msinteger默认 200

GIF 每帧时长(单位:毫秒,须 ≥ 20 且为 10 的倍数,默认 200),仅在纯生成且 output_format: "gif" 时生效。

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

userstring

终端用户唯一标识,用于异常调用识别与滥用防控。

webhook_urlstring

任务进入终态后接收结果推送的回调地址。仅支持公网 HTTPS URL。

moderation"auto" | "low"

内容安全审核严格度。仅在不携带参考图像的纯生成任务中生效;携带参考图像时该字段将被忽略并记录于 notes。

响应

200response

任务在等待窗口内已到达终态(携带 Prefer: wait 请求头),或命中相同幂等键返回已有任务记录。

202response

任务已受理并完成额度预留,可通过返回的 id 轮询或等待回调获取结果。

400response

请求参数无效(包括传入 stream: true、partial_images > 0、mask 与 markup 同时提供、编辑请求指定 svg/gif,或锁定渠道不支持对应参数)。

402response

工作区可用余额不足以覆盖本次任务的预留额度。

503response

当前并发任务已达上限,请按响应头 Retry-After 指示稍后重试。

供应商差异与可用状态

供应商状态计费方式特性与差异不支持的参数
amux-special已上线低价按次计费支持 svg、gif(自定义帧数/帧间隔)、多图 edits、mask 与 markup;4K 为后处理超分stream(异步端点本身亦不支持)
adobe已上线偏低价按次计费(略高于 amux-special)真原生 4K 与精确自定义像素(总像素 ≥ 655,360)output_format: svg / gif、frame_count、frame_duration_ms、mask、markup
openai暂未上线官方按 token 计费官方全量能力—(上线后启用)
azure暂未上线官方 Azure 按 token 计费官方全量能力—(上线后启用)

获取结果

方式调用方法适用场景
轮询GET /v1/tasks/{id}实现简单,建议轮询间隔 2–5 秒
Webhook 回调提交时传入 webhook_url服务端异步流水线,无需维持长连接
同步等待请求头携带 Prefer: wait=60希望在指定秒数内直接获取终态结果

关于任务状态流转、回调签名验签与幂等键机制,请参阅创建任务。

适用场景

高分辨率 4K 渲染或 gif 动图生成的端到端耗时较长,若同步连接在反向代理、网关或客户端侧发生超时中断,客户端将丢失响应结果而算力费用已实际产生;推荐优先采用 /v1/tasks 异步模式。

错误处理

错误响应结构与 OpenAI 官方规范一致,type 取值与重试策略见错误与重试。

cURL
curl https://gateway.amux.ai/v1/tasks \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -F "model=openai/gpt-image-2.6-flare" \
  -F "prompt=Make the fox wear a red scarf" \
  -F "image=@/path/to/image.png" \
  -F "size=1024x1024" \
  -F "webhook_url=https://hooks.example.com/amux"
{
  "id": "task_01M1CG35C16CJ790D00BV1RBVM",
  "status": "queued",
  "model": "openai/gpt-image-2.6-flare",
  "created_at": "<string>",
  "output": {
    "images": [
      {
        "index": 0,
        "url": "<string>"
      }
    ]
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0
  },
  "cost": "0.0100",
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}