# Doubao Seedream 5.0 Pro 能力概览

> Doubao Seedream 5.0 Pro 的图片生成、参考图编辑、交互编辑、图层拆分与透明背景能力

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

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

## 快速入口

<CardGroup cols={2}>
  <Card title="图片生成与编辑" icon="image" href="/api-capabilities/seedream/image-generation">
    查看公共参数、普通模式限制与请求示例
  </Card>
  <Card title="交互编辑" icon="crosshairs" href="/api-capabilities/seedream/interactive-editing">
    使用标注图、点坐标或框坐标指定编辑区域
  </Card>
  <Card title="图层拆分" icon="layer-group" href="/api-capabilities/seedream/layer-decomposition">
    自动或定向拆分基础图与透明 PNG 图层
  </Card>
  <Card title="API Reference" icon="code" href="/api-reference/seedream/create-image">
    查看并调试 `POST /api/v3/images/generations`
  </Card>
</CardGroup>

## 能力范围

<CardGroup cols={2}>
  <Card title="生成与参考图编辑" icon="images">
    支持文生图、单图编辑与最多 10 张参考图的多图融合
  </Card>
  <Card title="交互编辑" icon="pen-nib">
    支持上传标注图，以及在提示词中使用点坐标或框坐标
  </Card>
  <Card title="图层拆分" icon="layer-group">
    支持自动完整拆分、定向拆分与图层编辑
  </Card>
  <Card title="透明背景" icon="object-ungroup">
    符合条件的单图编辑可输出带透明通道的 PNG
  </Card>
</CardGroup>

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

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

## 模型与输出数量

| 模型 | 普通模式 | 图层拆分模式 |
| --- | --- | --- |
| `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"`。不符合条件的透明背景组合会返回参数错误。

## 快速调用

```bash 文生图（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"
  }'
```

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

## 常见问题

<AccordionGroup>
  <Accordion title="每次请求会返回多少项？">
    普通模式返回一张基础图。图层拆分模式返回一张基础图和最多 16 个图层，因此 `data` 最多包含 17 项。
  </Accordion>
  <Accordion title="普通编辑最多可以传几张参考图？">
    最多 10 张。单图可将 `image` 设为字符串；多图可设为字符串数组。
  </Accordion>
  <Accordion title="图片链接有效多久？">
    `response_format: "url"` 时，返回链接在图片生成后 **24 小时**内有效。`b64_json` 直接返回 Base64 图片数据，不依赖临时链接。
  </Accordion>
  <Accordion title="图层拆分是否使用独立端点？">
    不使用。仍调用 `POST /api/v3/images/generations`，并设置 `layer_decomposition: true`。
  </Accordion>
</AccordionGroup>

## 相关文档

<CardGroup cols={2}>
  <Card title="图片生成与编辑" icon="image" href="/api-capabilities/seedream/image-generation">
    普通模式参数、输入限制与输出格式
  </Card>
  <Card title="图层拆分" icon="layer-group" href="/api-capabilities/seedream/layer-decomposition">
    图层模式参数、响应字段与完整示例
  </Card>
  <Card title="API Key" icon="key" href="https://console.looprouter.com/keys">
    在 LoopRouter 控制台创建 API Key
  </Card>
  <Card title="计费与余额" icon="receipt" href="/faq/billing-and-balance">
    查看公开价格入口与余额说明
  </Card>
</CardGroup>