Doubao Seedream 5.0 Pro 能力概览

Doubao Seedream 5.0 Pro（doubao-seedream-5-0-pro-260628）通过一个同步接口提供图片生成与编辑能力，兼容火山方舟图片生成 API 的请求与响应契约。普通模式返回一张基础图；图层拆分模式返回一张基础图和最多 16 个图层，data 最多包含 17 项。

接口路径为 POST /api/v3/images/generations。请求完成后可直接从响应体读取 url 或 b64_json，无需创建任务或轮询状态。

快速入口

图片生成与编辑

查看公共参数、普通模式限制与请求示例

交互编辑

使用标注图、点坐标或框坐标指定编辑区域

图层拆分

自动或定向拆分基础图与透明 PNG 图层

API Reference

查看并调试 POST /api/v3/images/generations

能力范围

生成与参考图编辑

支持文生图、单图编辑与最多 10 张参考图的多图融合

交互编辑

支持上传标注图，以及在提示词中使用点坐标或框坐标

图层拆分

支持自动完整拆分、定向拆分与图层编辑

透明背景

符合条件的单图编辑可输出带透明通道的 PNG

能力	支持情况	说明
文生图	支持	只传 `prompt`，返回一张基础图
单图编辑	支持	传入一张参考图和 `prompt`
多参考图融合	支持	最多传入 10 张参考图，返回一张基础图
交互编辑	支持	标注图、`<point>` 点坐标和 `<bbox>` 框坐标
图层拆分	支持	一张基础图加最多 16 个图层，最多 17 项
透明背景	条件支持	必须是只输入一张图片且输出格式为 PNG 的编辑请求
组图	不支持	不支持 `sequential_image_generation`
联网搜索	不支持	不支持 `tools`
指定输出数量	不支持	不接受 `n`，普通模式固定返回一张基础图，图层数量由模型决定
流式输出	不支持	`stream: true` 会返回参数错误；省略或传 `false` 均为同步调用

请勿携带 n、sequential_image_generation、sequential_image_generation_options 或 tools。这些参数不受支持。接口仅支持同步调用：stream: true 会返回参数错误，stream: false 可接受但不会改变同步行为。

模型与输出数量

模型	普通模式	图层拆分模式
`doubao-seedream-5-0-pro-260628`	返回 1 张基础图	返回 1 张基础图 + 最多 16 个图层，最多 17 项

普通模式要求非空 prompt；image 可省略，也可传单个字符串或最多 10 项的字符串数组。图层拆分模式必须且只能传一张图片，prompt 可省略。

技术规格

项目	规格
调用方式	同步
Base URL	`https://api.looprouter.com`
端点	`POST /api/v3/images/generations`
鉴权	`Authorization: Bearer $LOOPROUTER_API_KEY`
普通模式尺寸	`1K` / `1.5K` / `2K`（默认 `2K`），或符合限制的显式 `宽x高`
图层模式尺寸	`auto`（默认）/ `1K` / `1.5K` / `2K`，不支持显式 `宽x高`
输出格式	`jpeg`（默认）或 `png`
返回方式	`url`（默认，链接 24 小时内有效）或 `b64_json`
提示词优化	`standard`（默认）或 `fast`
水印	默认开启，可通过 `watermark: false` 关闭

透明背景条件

background: "transparent" 仅适用于同时满足以下条件的图片编辑请求：

传入且只传入 1 张图片；
output_format 为 png。

其他请求默认使用 background: "opaque"。不符合条件的透明背景组合会返回参数错误。

快速调用

文生图（cURL）

curl -X POST "https://api.looprouter.com/api/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LOOPROUTER_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一座建在云海之上的未来图书馆，清晨柔光，电影感构图",
    "size": "2K",
    "response_format": "url"
  }'

response_format: "url" 返回的图片链接在生成后 24 小时内有效，请在有效期内下载。希望直接保存图片数据时，可改用 b64_json。

常见问题

每次请求会返回多少项？

普通模式返回一张基础图。图层拆分模式返回一张基础图和最多 16 个图层，因此 data 最多包含 17 项。

普通编辑最多可以传几张参考图？

最多 10 张。单图可将 image 设为字符串；多图可设为字符串数组。

图片链接有效多久？

response_format: "url" 时，返回链接在图片生成后 24 小时内有效。b64_json 直接返回 Base64 图片数据，不依赖临时链接。

图层拆分是否使用独立端点？

不使用。仍调用 POST /api/v3/images/generations，并设置 layer_decomposition: true。

图片生成与编辑

普通模式参数、输入限制与输出格式

图层拆分

图层模式参数、响应字段与完整示例

API Key

在 LoopRouter 控制台创建 API Key

计费与余额

查看公开价格入口与余额说明

产品基础

视频模型

图片模型

Doubao Seedream 5.0 Pro 能力概览

快速入口

图片生成与编辑

交互编辑

图层拆分

API Reference

能力范围

生成与参考图编辑

交互编辑

图层拆分

透明背景

模型与输出数量

技术规格

透明背景条件

快速调用

常见问题

相关文档

图片生成与编辑

图层拆分

API Key

计费与余额

​快速入口

图片生成与编辑

交互编辑

图层拆分

API Reference

​能力范围

生成与参考图编辑

交互编辑

图层拆分

透明背景

​模型与输出数量

​技术规格

​透明背景条件

​快速调用

​常见问题

​相关文档

图片生成与编辑

图层拆分

API Key

计费与余额

快速入口

能力范围

模型与输出数量

技术规格

透明背景条件

快速调用

常见问题

相关文档