> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetoken.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream 5.5 — 图像编辑

> 使用字节跳动 Seedream 5.5 以自然语言编辑与融合图像。

| | |
| - | - |
| **模型 ID** | `bytedance/seedream-5.5-edit` |
| **系列** | `seedream-5-5` |
| **任务** | `edit` |
| **提供方** | ByteDance |
| **模态** | 图像 |

## 参数

**prompt** `string`

描述编辑内容或多张参考图如何融合的自然语言指令。开启 `layer_decomposition` 时可选，可用来说明如何拆分图像。

**image\_urls** `string[]` *required*

一到 10 张参考图的 URL，必须是可公开访问的 HTTPS 地址。

**size** `string` (default: 2K)

输出分辨率档位。取值为 `1K`、`1.5K`、`2K` 之一。

**aspect\_ratio** `string` (default: auto)

输出画幅。取值为 `auto`, `1:1`, `4:3`, `3:4`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9` 之一。`auto` 由模型根据提示词决定画幅；其他比例按 `size` 对应的像素量出图，价格不变。

**background** `string` (default: auto)

`auto`（默认）、`opaque` 或 `transparent`。`transparent` 返回带透明通道的 PNG。

**output\_format** `string` (default: png)

`png`（默认）或 `jpeg`。透明背景需使用 `png`。

**layer\_decomposition** `boolean` (default: false)

不做编辑，而是把唯一的输入图拆成一张底图和若干独立的透明图层。`image_urls` 中须恰好一张图。见下文的图层拆分一节。

**max\_layers** `integer` (default: 10)

开启 `layer_decomposition` 时：最多返回的图片数（含底图，2 到 100）。按实际返回的图片计费。

**text\_recognition** `boolean` (default: false)

开启 `layer_decomposition` 时：同时返回每个文字图层上的文字及其行与样式。

## 计费

每张返回的图片按尺寸计费：约 260 万像素以内（`1K`、`1.5K`）一个价，更大的（`2K`）更高；另对 `image_urls` 中的**每张参考图**按张计费。开启 `layer_decomposition` 时，每张返回的图片（底图和每个图层）同样按尺寸计费；请求按 `max_layers` 张预扣，按实际返回的图片结算。生成失败不收费。当前价格请见[定价页](https://vibetoken.cn/pricing)。

## 图层拆分

设置 `layer_decomposition: true` 后，`image_urls` 中的那张图会以一张底图加若干图层的形式返回，每层都是透明 PNG。`data` 中的每一项除 `url` 外还包含：

| 字段 | 含义 |
| - | - |
| `size` | 像素尺寸，例如 `1024x512` |
| `z_index` | 叠放顺序，`0` 为底图 |
| `name`、`description` | 该图层的内容 |
| `bounding_box` | 图层位置：`absolute` 为像素坐标 `[左, 上, 右, 下]`，`normalized` 为 0 到 1000 的归一化坐标 |
| `text_recognition` | 开启 `text_recognition: true` 时，文字图层上的文字及其行与样式 |

`aspect_ratio` 与 `background` 不适用：图层保持输入图的比例。

## 示例

```bash theme={null}
curl https://vibetoken.cn/v1/images/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5.5-edit",
    "prompt": "把这辆自行车改造成极简白色影棚里的银色概念车",
    "image_urls": ["https://example.com/bicycle.jpg"],
    "size": "2K",
    "aspect_ratio": "16:9"
  }'
```

```bash theme={null}
curl https://vibetoken.cn/v1/images/generations \
  -H "Authorization: Bearer $VIBETOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5.5-edit",
    "prompt": "把海报拆成背景、产品图和标题文字",
    "image_urls": ["https://example.com/poster.png"],
    "layer_decomposition": true,
    "max_layers": 8,
    "text_recognition": true
  }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.