Amux AI

Create image

最近更新：2026年10月21日

用 bytedance/seedream-5.0-pro 在火山方舟 Ark 原生端点 /api/v3/images/generations 同步生成图像，支持图生图与图层拆分。

bytedance/seedream-5.0-pro 的同步出图，请求与响应均为火山方舟原生格式。官方 SDK 将 base_url 指向本站即可使用。文生图、图生图与图层拆分共用这一端点。

POSThttps://gateway.amux.ai/api/v3/images/generations

鉴权

header
Authorizationstring必填

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

请求

application/json
modelstring必填

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

promptstring

提示词。图层拆分时可选，不传则由模型自动识别主体、文字与背景；

其余场景必填。

imagestring | array<string>

参考图，可选——不给就是文生图，给了就是图生图。一张发字符串，

多张发字符串数组，最多 10 张，单张 ≤ 30MB。

每一项是 https 地址或 data:image/<格式>;base64,…。地址必须公网可达，

指向内网或使用 http 时返回 400。

sizestring

出图尺寸。生成场景收档位 1K / 1.5K / 2K（默认 2K，没有 4K），

也收像素串 宽x高（总像素约 92 万–462 万，原样转发）。

图层拆分只收 1K / 1.5K / 2K / auto（默认 auto），不收像素串。

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

输出编码。图层拆分时只管底图，图层恒为 png。

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

transparent 出透明底 png。只用于图生图，要求恰好 1 张带透明通道的

输入图，且不能配 output_format: jpeg——违反任一条件时返回 400。

watermarkboolean默认 false

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

layer_decompositionboolean默认 false

图层拆分：把一张图拆成底图 + 若干图层。要求 image 恰好 1 张

（png / jpeg，建议 ≥ 512×512），可以不给 prompt。

optimize_prompt_optionsobject

提示词优化配置。不传就是官方默认的 standard。

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

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

response_format"url" | "b64_json"默认 "url"

返回形式。b64_json 时 data[] 里回图片的 base64、不回 url，与官方一致；

两种形式的产物均存入本站存储，可在日志与操练场中查看。

响应

200response

出图完成。

400response

参数不合法：图层拆分给了 0 张或多张图、拆分时 size 用了像素串、参考图超过

10 张、透明底的前提不满足、image 地址不可用。

402response

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

502response

上游出图失败。不收钱，预扣已经退回。

尺寸

size 支持两种写法，不可混用：

  • 分辨率档位：1K、1.5K、2K，默认 2K。不支持 4K。
  • 像素值：宽x高，总像素 921,600 – 4,624,220，宽高比 1/16 – 16。

图层拆分仅支持档位与 auto（默认 auto），不支持像素值。

参考图

通过 image 传入：单张为字符串，多张为数组，最多 10 张，单张不超过 30 MB。支持公网 HTTPS 地址与 data:image/<格式>;base64,…（格式名须小写）。不传 image 即为文生图。

图层拆分

layer_decomposition: true 将一张图拆分为一张底图与最多 16 个图层：

  • image 须恰好 1 张，格式为 png 或 jpeg，总像素不低于 512×512；
  • prompt 可选，用于指定要拆分的元素；不传时由模型自动识别主体、文字与背景；
  • 响应 data 中底图的 z_index 为 0，图层从 1 递增，并附 bounding_box、name、description；
  • 图层恒为带透明通道的 png，output_format 仅作用于底图；
  • bounding_box.normalized 为 0–1000 的整数，还原到底图时建议使用 absolute。

图层拆分适用于海报、插画、设计稿等主体清晰的图片。内容过于复杂的图片可能无法拆分， 上游返回 400，不计费。

其他参数

参数说明
watermark右下角「AI 生成」水印。本站默认关闭，传 true 时开启
output_formatjpeg（默认）或 png
backgroundtransparent 输出透明底 png。仅用于图生图，须恰好 1 张带透明通道的输入图，不能与 jpeg 同用
optimize_prompt_options.mode提示词优化模式：standard（默认）或 fast。fast 耗时更短、效果略低，两档同价
response_formaturl（默认）或 b64_json。b64_json 时仅返回 base64，不返回 url

该模型不支持 n、seed 与流式输出，每次请求生成一张图（图层拆分除外）。

耗时

同步请求在出图完成后一次性返回。实测文生图与图生图约 15–60 秒，图层拆分约 60–90 秒。 不希望长时间保持连接时，使用 Amux Tasks。

计费

按张计费，不按 token。档位按每张成片的实际像素确定：总像素不超过 261 万为低档（1K、1.5K）， 超过为高档（2K）。图层拆分时，底图与每个图层按各自像素分别计费，单价低于单图生成。参考图按张计费。

计费张数以响应中的 usage.generated_images 为准。output_tokens 与 total_tokens 是上游按面积折算的参考值，不参与计费。

单价见模型页。提交时按上界预扣（图层拆分按 17 张）， 完成后按实际用量结算并退还差额。失败不计费。

调用方式

方式端点说明
火山方舟原生（本页）POST /api/v3/images/generations同步；响应为火山方舟格式
OpenAI 兼容POST /v1/images/generations同步；响应为 OpenAI 格式，附 amux 字段
Amux TasksPOST /v1/tasks异步；返回任务 ID，支持回调

三种方式共用同一套路由、计费与任务记录，上述参数在三者上均生效。

错误

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

cURL
curl https://gateway.amux.ai/api/v3/images/generations \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "bytedance/seedream-5.0-pro",
    "prompt": "一只红色的纸船漂在雨后的街道上，电影感光影",
    "size": "2K",
    "watermark": false
  }'
{
  "model": "doubao-seedream-5-0-pro-260628",
  "created": 1792511123,
  "data": [
    {
      "size": "2048x2048",
      "url": "https://cdn.amux.ai/gen/20261021/task_01M5CWPZEAJ6FRGPDM1G7G1V29-0.jpg",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}