Seedream 5.0 Pro

调用 Seedream 5.0 Pro 进行文生图、使用最多 10 张参考图编辑、图层分解和透明背景生成，按张计费，通过任务交付。

Seedream 5.0 Pro 是 ByteDance 的图像模型。每次请求可根据提示词，或提示词加最多 10 张参考图生成一张图像，也可将一张图像分解为底图和最多 16 个透明图层。发送请求后，保留返回的任务 ID，再从任务中读取完成的图像。参考图以 URL 形式传入。

模型 ID	输入	输出尺寸	每次请求的图像数量
`seedream-5-0-pro`	文本、0–10 张图像	`1K`、`1.5K`、`2K` 或 `WIDTHxHEIGHT`	1 张，或底图加最多 16 个图层

快速示例

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

端点

POST https://api.seedrouter.ai/v1/images/generations

请求头	值
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

响应返回的是任务（{"id": "task_...", "status": "processing"}），而非完成的图像。轮询 GET /v1/tasks/{task_id} 获取结果。请将 API Key 保存在服务端代码中。参考图和图层分解均通过 image 随同一次请求传入；此模型不使用 /v1/images/edits，调用该端点会返回 400。

参数

字段	类型	默认值	说明
`model`	字符串	必填	`seedream-5-0-pro`
`prompt`	字符串	必填	描述要生成的图像。使用 `layer_decomposition` 时可选：说明要拆分哪些元素，或省略以拆分所有主要元素。
`image`	URL 或 URL 列表	无	一个公开的图像 URL，或包含 2–10 个 URL 的列表。不传时为文生图。使用 `layer_decomposition` 时仅限一张。
`size`	字符串	`2K`	`1K`、`1.5K` 或 `2K`（在 `prompt` 中描述画幅），也可使用精确像素尺寸 `WIDTHxHEIGHT`，总像素为 921,600 至 4,624,220，宽高比为 1:16 至 16:1，例如 `2048x1024`。使用 `layer_decomposition` 时仅支持 `auto`（默认）、`1K`、`1.5K` 或 `2K`。
`layer_decomposition`	布尔值	`false`	将输入的一张图像分解为底图及最多 16 个透明 PNG 图层。
`optimize_prompt_options.mode`	枚举	`standard`	`standard` 质量更高，`fast` 延迟更低。
`output_format`	枚举	`jpeg`	`jpeg` 或 `png`。使用 `layer_decomposition` 时仅设置底图格式；图层始终为 PNG。
`background`	枚举	`opaque`	`opaque` 或 `transparent`。`transparent` 需要且仅接受一张带 alpha 通道的输入图像，不能使用 `jpeg` 输出，也不能与 `layer_decomposition` 同时使用。
`watermark`	布尔值	`true`	`true` 在右下角添加“AI generated”标记。设为 `false` 可获得无标记图像。
`content_filter`	布尔值	`true`	仅可通过 API 设置。Playground 始终保持开启。

此列表之外的字段会在转发请求前被丢弃，不会导致错误，也不会改变输出。不提供 n、stream、seed、response_format 或连续生成。不支持 callback_url，请改为轮询任务。

输出尺寸

档位决定图像规模，提示词决定画幅。在 prompt 中写明宽高比（例如“16:9 横图”），模型会选择相应画幅：

档位	1:1	4:3	3:4	16:9	9:16	3:2	2:3	21:9
`1K`	1024x1024	1152x864	864x1152	1424x800	800x1424	1248x832	832x1248	1568x672
`1.5K`	1536x1536	1792x1344	1344x1792	2048x1152	1152x2048	1872x1248	1248x1872	2352x1008
`2K`	2048x2048	2368x1776	1776x2368	2816x1584	1584x2816	2496x1664	1664x2496	3136x1344

需要固定画幅时，请传入精确像素尺寸，而非档位。1K 和 1.5K 同价；2K 及超过 261 万像素的尺寸价格更高（见计费维度）。

参考图

传入一张图像进行编辑，或传入 2–10 张进行融合，并在 prompt 中说明要保留和修改的内容。按顺序指代它们（例如“图 1 中的夹克”）。

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

图层分解

传入且仅传入一张图像，并设置 layer_decomposition: true。任务先返回底图，再以透明 PNG 格式返回各个图层。

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

每层包含 z_index（底图为 0；数字越大越靠上）、name、description 和 bounding_box。bounding_box.absolute 使用底图像素坐标，格式为 [left, top, right, bottom]；bounding_box.normalized 表示同一边界框，以底图宽高的千分之一为单位。重建图像时，将各图层缩放到对应边界框大小，再按 z_index 升序放置到底图上。

使用 size: "auto" 时，底图与各图层保留在输入图像中的尺寸。输入必须为 PNG 或 JPEG，总像素（宽 × 高）在 262,144（512 × 512）到 36,000,000（6000 × 6000）之间。

透明背景

传入一张带 alpha 通道的 PNG，并设置 background: "transparent"，即可获取透明背景的 PNG：

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

媒体输入

每张参考图均使用公开的 HTTP(S) URL。不接受 Base64 data URI：请将文件上传到自己的存储空间，并传入其 URL。支持 JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC 和 HEIF，每张不超过 30 MB，宽高比为 1:16 至 16:1，宽和高均大于 14 像素，总像素不超过 36,000,000。图层分解仅接受 PNG 或 JPEG。

计费维度

当前费率见模型价格区块。Seedream 5.0 Pro 按场景和像素档位对每张输出图像计费，除第一张外，每张参考图另行收费：

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

低价档涵盖不超过 261 万像素的图像（1.5K 及以下）；超过此范围为高价档。
图层分解按底图及每个图层计费。整次请求采用同一档位：只有每张返回图像均不超过 261 万像素时，才采用低价档。
任务受理时按最大可能结果预留金额：所选档位的一张图像，或图层分解的 17 张图像（auto 按高价档计算）。随后按实际返回的图像数量扣费，并释放差额。

最终费用可在账户用量记录中查看。失败的任务不收费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

查询任务

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每隔 10–20 秒轮询一次，直到 status 为 completed 或 failed。轮询时发生网络超时并不表示生成失败：保留任务 ID，继续查询。不要为了查看进度而创建新任务。

已完成的任务

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

图层分解任务先列出底图，再列出各个图层：

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

我们的测试中，一张 1K 图像约需 35–55 秒，一次返回底图加 13 个图层的 1K 图层分解约需 140 秒。

错误

任务创建前被拒绝的请求会返回带有 error 对象的 HTTP 错误，不收费。任务受理后若失败，查询时仍返回 HTTP 200，并包含 status: "failed" 和 error 对象。

错误码、HTTP 状态及重试建议见公共错误目录。

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身超时，请先查询任务，再决定是否重新提交：第一次请求可能已经受理。

使用提示

从 1K 或 1.5K 开始反复调整；1.5K 与 1K 同价。
使用档位时，在提示词中说明画幅；需要固定版式时传入精确像素尺寸。
使用多张参考图时，说明分别参考哪些内容，并按顺序指代它们。
需要无标记图像时，设置 watermark: false；默认会添加标记。
图层分解时，列出想要拆分的元素，以减少图层数量。

模型 ID