Amux AI

Retrieve task

最近更新：2026年10月21日

按站内统一形状查 bytedance/seedream-5.0-flash 的任务结果，带图层信息、用量与费用。

按任务 ID 查询 bytedance/seedream-5.0-flash 的任务。无论任务是否完成均返回 200，状态见 status。

GEThttps://gateway.amux.ai/v1/tasks/{id}

鉴权

header
Authorizationstring必填

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

请求

idstring必填

提交时返回的任务 ID。

响应

200response

任务的当前状态。succeeded 时附带 output。

404response

没有该任务，或该任务不属于当前工作区。两种情况返回同一响应，以避免通过跨工作区试探任务 ID 判断其是否存在。

轮询

文生图与图生图通常在 10–20 秒内完成，图层拆分约 60–90 秒。建议提交 10 秒后开始查询， 间隔 5–10 秒；也可在提交时使用 Prefer: wait=60 直接等待结果。

产物

图像产物位于 output.images。output.videos 字段始终存在且为空数组，不应据此判断任务模态。

图层拆分时，output.images 第一项为底图，其后每个图层一项，各带 layer 字段：

{
  "output": {
    "images": [
      { "index": 0, "url": "https://…/task_x-0.jpg", "layer": { "zIndex": 0, "role": "background" } },
      {
        "index": 1,
        "url": "https://…/task_x-1.png",
        "layer": {
          "zIndex": 1,
          "role": "layer",
          "bboxAbsolute": [223, 638, 685, 993],
          "bboxNormalized": [279, 448, 855, 697],
          "name": "咖啡杯",
          "description": "盛有浓缩咖啡的白色陶瓷咖啡杯"
        }
      }
    ],
    "videos": []
  }
}

layer 使用驼峰命名，与火山方舟原生端点的 z_index、bounding_box 是同一数据。 bboxNormalized 为 0–1000 的整数。

产物地址指向本站存储，保留期后会被清理，需要长期保存请及时下载。

用量

该模型按张计费，usage 中的三个 token 字段恒为 0。本次扣费见 cost，图层拆分时包含底图与全部图层。

错误

错误体格式与 OpenAI 一致，type 取值与重试语义见错误与重试。

cURL
curl https://gateway.amux.ai/v1/tasks/{id} \
  -H "Authorization: Bearer $AMUX_API_KEY"
{
  "id": "task_01M5CWPZEAJ6FRGPDM1G7G1V29",
  "status": "queued",
  "model": "bytedance/seedream-5.0-flash",
  "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.017",
  "notes": [
    "dropped seed: this model has no seed parameter"
  ],
  "error": {
    "message": "<string>",
    "code": "<string>"
  }
}