Amux AI

Create task

最近更新：2026年10月21日

用 bytedance/seedream-5.0-pro 向站内统一入口 /v1/tasks 提交异步出图任务，支持图生图与图层拆分。

bytedance/seedream-5.0-pro 的异步出图。通过 Amux Tasks 统一入口提交，立即返回任务 id， 使用取回任务获取结果。

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

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 站内 API Key。

请求

application/json
modelstring必填

站内模型 ID，可带 :供应商 后缀锁定供应商。

promptstring

提示词。图层拆分时可选，其余场景必填。

imagestring | array<string>

参考图，单张字符串或字符串数组，最多 10 张。图层拆分要求恰好 1 张。

sizestring

档位 1K / 1.5K / 2K，生成场景也收 宽x高；图层拆分另收 auto、不收像素串。

output_format"jpeg" | "png"默认 "jpeg"

输出编码。图层恒为 png。

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

transparent 要求恰好 1 张带透明通道的输入图，且不能配 jpeg。

watermarkboolean默认 false

右下角「AI 生成」水印。本站默认关闭，传 true 时开启。

layer_decompositionboolean默认 false

图层拆分。要求恰好 1 张参考图，可以不给 prompt。

optimize_prompt_optionsobject

提示词优化配置。不传就是官方默认的 standard。用 multipart 提交时写成

扁平的文本字段 optimize_prompt_mode。

›optimize_prompt_optionsobject
mode"standard" | "fast"默认 "standard"

standard 质量更高、耗时更长；fast 更快、效果略低。两档同价。

webhook_urlstring

任务到终态时往这里 POST 一份结果（{event, sent_at, task} 信封 +

Amux-Signature 签名 + 退避重试）。

仅支持 https，且不能指向内网地址（回调由本站服务端发起）。地址在提交时校验，

不合法时直接返回错误。

响应

202response

任务已建立。拿 id 去轮询，或等回调。带了 Prefer: wait 且等到了终态时返回 200

与取回口同一份结果；幂等键重放也返回 200。

400response

参数不合法。取值超出这个模型的范围时，报错里会写明可接受的取值。

402response

可用余额不足以覆盖这次的预扣。

参数

与同步端点一致，size、image、layer_decomposition、 watermark（本站默认关闭）、output_format、background、optimize_prompt_options 均原样生效。

该端点不分生成和编辑：不传 image 为文生图，传入为图生图；传入 1 张 image 并设 layer_decomposition: true 为图层拆分，此时 prompt 可选。

以 multipart/form-data 提交时，参考图使用 image 文件字段，布尔值写作字符串 "true"， 提示词优化模式写作 optimize_prompt_mode。

获取结果

方式用法
轮询GET /v1/tasks/{id}，建议间隔 5–10 秒
回调提交时传入 webhook_url
同步等待请求头 Prefer: wait=60

任务生命周期、回调签名与幂等键对所有模型一致，见创建任务。

计费

与同步端点一致：按张计费，按每张成片的实际像素分档， 图层拆分时底图与每个图层分别计费，参考图按张计费。取回时 cost 为本次实际扣费。

提交时按上界预扣，完成后按实际用量结算并退还差额；可用余额不足以覆盖预扣时返回 402。 失败与过期不计费。

cURL
curl https://gateway.amux.ai/v1/tasks \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "bytedance/seedream-5.0-pro",
    "image": "https://example.com/poster.png",
    "layer_decomposition": true,
    "webhook_url": "https://hooks.example.com/amux"
  }'
{
  "id": "task_01M5CWPZEAJ6FRGPDM1G7G1V29",
  "status": "queued",
  "model": "bytedance/seedream-5.0-pro",
  "created_at": "2026-10-21T08:25:44Z",
  "output": {
    "images": [
      {
        "index": 0,
        "url": "https://cdn.amux.ai/gen/20261021/task_01M5CWPZEAJ6FRGPDM1G7G1V29-0.jpg",
        "layer": {
          "zIndex": 0,
          "role": "background",
          "bboxAbsolute": [
            0
          ],
          "bboxNormalized": [
            0
          ],
          "name": "<string>",
          "description": "<string>"
        }
      }
    ],
    "videos": [
      {}
    ]
  },
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0,
    "total_tokens": 0
  },
  "cost": "0.043",
  "notes": [
    "dropped seed: this model has no seed parameter"
  ],
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}