Create task
最近更新:2026年11月23日
提交 openai/gpt-image-2.6-sunburst 异步图像任务,统一支持高画质文生图(含 SVG/GIF)与参考图编辑(含 markup)。
向 /v1/tasks 提交 openai/gpt-image-2.6-sunburst 异步任务:请求立即返回任务 id,图像生成在后台执行。
本端点不区分图像生成与图像编辑:省略 image 时执行文生图(支持 svg、gif、frame_count、frame_duration_ms),携带 image 时执行图像编辑(支持 mask 或 markup,两者互斥)。不携带参考图像时,也可使用 application/json 发送相同字段。
https://gateway.amux.ai/v1/tasks鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> Amux AI API 密钥(Bearer Token)。
请求
multipart/form-datamodelstring必填模型 ID(可附加 :amux-special 或 :adobe 后缀)。
promptstring必填图像生成或编辑提示词,上限 32,000 字符。
imagearray<string>可选参考图像文件列表。省略时执行图像生成,提供时执行图像编辑;最多 16 张,单张上限 25 MB。
字段名同时兼容 image 与 image[]。
maskstring局部编辑蒙版文件,透明区域(alpha 为 0)指示重绘范围。与 markup 互斥,仅在同时提供参考图像时生效。
渠道支持说明:adobe 渠道不支持 mask(显式锁定 :adobe 将返回 400);amux-special 渠道已支持。
markupstringGPT-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默认 9GIF 动图帧数(2–16,默认 9),仅在纯生成且 output_format: "gif" 时生效。
渠道支持说明:adobe 渠道不支持;amux-special 渠道已完整支持。
frame_duration_msinteger默认 200GIF 每帧时长(单位:毫秒,须 ≥ 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 | 希望在指定秒数内直接获取终态结果 |
关于任务状态流转、回调签名验签与幂等键机制,请参阅创建任务。
适用场景
Sunburst 在高分辨率(尤其是原生 4K)或 gif 动图场景下生成耗时较长,若同步连接在反向代理、网关或客户端侧发生超时中断,客户端将丢失响应结果而算力费用已实际产生;强烈建议优先采用 /v1/tasks 异步模式。
错误处理
错误响应结构与 OpenAI 官方规范一致,type 取值与重试策略见错误与重试。
curl https://gateway.amux.ai/v1/tasks \
-H "Authorization: Bearer $AMUX_API_KEY" \
-F "model=openai/gpt-image-2.6-sunburst" \
-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-sunburst",
"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>"
}
}