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

# Seedream 5.5 API：透明背景 PNG 与 99 层拆分，每张 0.035 美元

> 用老张API调用字节跳动 Seedream 5.5（seedream-5-5-261028），不需要 BytePlus 账号：文生图、1–10 张参考图改图、直接输出透明背景 PNG、把成品图拆成最多 100 张图层并识别文字样式，附可运行的 cURL 与 Python 示例。

Seedream 5.5 是 BytePlus 在 2026 年 11 月 12 日发布的 Seedream 图像模型，相比 5.0 新增直接输出透明背景 PNG，分层上限从 16 层提高到 99 层，还能识别图层里的文字和字体样式。老张API自 2026 年 11 月 13 日起提供，用 `default` 分组的令牌即可调用。

| 项目 | 内容 |
| - | - |
| 模型 ID | `seedream-5-5-261028`（也可以写 BytePlus 原名 `dola-seedream-5-5-261028`） |
| 接口 | `POST /v1/images/generations`，JSON 请求体；文生图、改图、分层都用这一个接口 |
| 令牌 | `default` 分组，计费模式按量优先（推荐）或按次计费 |
| 价格 | 每张 \$0.035，1K、1.5K、2K 同价；参考图每张另收 \$0.008，见[计费](#计费) |
| 尺寸 | `1K`、`1.5K`、`2K`（默认），或像素宽高；最高约 2048×2048，没有 3K、4K |
| 参考图 | 最多 10 张；分层时只能 1 张 |
| 不支持 | 组图模式 `sequential_image_generation`、流式 `stream`、`optimize_prompt_options` 的 `fast` 模式 |

![Seedream 5.5 生成的雨后江南小巷，女孩撑油纸伞走过，右上角有书法字烟雨](https://mintcdn.com/laozhangai-edd05f2c/HEoMLhnyMjdf-Yvq/images/samples/seedream-5-5-zh-generate.jpg?fit=max\&auto=format\&n=HEoMLhnyMjdf-Yvq\&q=85\&s=4c259e28ab4a472c93ad477a8caeb1c9)

「文生图」示例的输出：2K，返回 2496×1664，画面里的书法字「烟雨」由模型直接写出

![Seedream 5.5 直接生成的透明背景陶瓷咖啡杯 PNG](https://mintcdn.com/laozhangai-edd05f2c/HEoMLhnyMjdf-Yvq/images/samples/seedream-5-5-zh-transparent.png?fit=max\&auto=format\&n=HEoMLhnyMjdf-Yvq\&q=85\&s=3d7a81713907c1ef9303a73cf559ac1f)

「透明背景 PNG」示例的输出：1K，返回 1248×832 的 RGBA 图片，背景是真正的透明通道

## 和 Seedream 5.0 有什么不同

| 对比项 | Seedream 5.5 | 5.0 Flash / 5.0 Pro |
| - | - | - |
| 透明背景 | 文生图和改图都能用 `background` 直接出 RGBA PNG | 需要透明素材时用分层拆图 |
| 分层 | 1 张底图 + 最多 99 层，可用 `max_images` 控制总张数，可返回文字样式 | 1 张底图 + 最多 16 层 |
| 默认输出格式 | PNG | JPEG |
| 每张价格 | \$0.035 | Flash \$0.018，Pro \$0.12 |
| 参考图费用 | 每张 \$0.008 | Flash 不收，Pro 从第 2 张起每张 \$0.003 |

* 要透明素材、精细分层或识别海报文字，选 Seedream 5.5。
* 只要大批量出图、控制成本，用 [5.0 Flash](https://docs.laozhang.ai/api-capabilities/seedream-image.md)；要 3K、4K 或组图模式，用 5.0、4.5、4.0，见 [Seedream 各版本对比](https://docs.laozhang.ai/api-capabilities/seedream-image.md#新接入选哪个版本？)。

## 调用前准备

**1. 创建令牌**

在[令牌管理](https://api2.laozhang.ai/token)新建令牌，分组选 `default`，计费模式选「按量优先」（推荐）或「按次计费」。不需要火山方舟或 BytePlus 账号。

**2. 设置密钥并安装依赖**

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API令牌"
python -m pip install requests pillow
```

返回的图片地址是临时链接，BytePlus 说明 24 小时内有效，拿到后尽快下载保存。

## 文生图

### cURL

```bash theme={null}
curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "雨后的江南小巷，青石板路面倒映着红灯笼，一位撑油纸伞的女孩走过，画面右上角写着书法字“烟雨”",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5.json

python save_images.py seedream-5-5.json seedream-5-5
```

`save_images.py` 是 [Images API 参考中的保存脚本](https://docs.laozhang.ai/api-reference/images.md#保存返回图片)，会下载 `data[]` 里的每张图片并按实际格式命名。2K 通常 25–35 秒返回，1K 约 12–20 秒。Seedream 5.5 默认输出 PNG，需要 JPEG 时传 `"output_format": "jpeg"`。

### Python

```python theme={null}
import os
from pathlib import Path

import requests

API_URL = "https://api.laozhang.ai/v1/images/generations"
HEADERS = {"Authorization": f"Bearer {os.environ['LAOZHANG_API_KEY']}"}

response = requests.post(
    API_URL,
    headers=HEADERS,
    json={
        "model": "seedream-5-5-261028",
        "prompt": "雨后的江南小巷，青石板路面倒映着红灯笼，一位撑油纸伞的女孩走过，画面右上角写着书法字“烟雨”",
        "size": "2K",
        "response_format": "url",
        "watermark": False,
    },
    timeout=180,
)
response.raise_for_status()
result = response.json()
if not result.get("data"):
    raise SystemExit(f"没有返回图片：{result}")

item = result["data"][0]
image = requests.get(item["url"], timeout=60)
image.raise_for_status()
path = Path(f"seedream-5-5.{item.get('output_format', 'png')}")
path.write_bytes(image.content)
print(f"已保存 {path}，尺寸 {item['size']}")
```

## 透明背景 PNG

把 `background` 设为 `transparent`、`output_format` 设为 `png`，Seedream 5.5 会直接返回带 alpha 通道的图片，不需要再抠图。文生图和参考图改图都可以这样输出。

```bash theme={null}
curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "prompt": "一只印着蓝色小花的陶瓷咖啡杯，产品图",
    "background": "transparent",
    "output_format": "png",
    "size": "1K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5-transparent.json
```

`background` 有三个值：

* `auto`（默认）：模型按提示词和 `output_format` 决定，`output_format` 为 `jpeg` 时一定没有透明通道。
* `transparent`：返回 RGBA 图片，响应里 `data[].background` 为 `transparent`。
* `opaque`：返回不透明的 RGB 图片。

两种组合会报错：`output_format` 为 `jpeg` 时传 `transparent`，以及分层请求里带 `background`。

## 参考图改图

在请求里加入 `image` 就是改图。`image` 可以是一张图片，也可以是最多 10 张图片组成的数组，数组顺序就是提示词里的图 1、图 2……每张图片是公网 URL 或 `data:image/png;base64,...` 形式的 data URL。

```bash theme={null}
IMG1=$(base64 < model.png | tr -d '\n')
IMG2=$(base64 < jacket.png | tr -d '\n')

curl --fail-with-body --max-time 180 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- \
  -o seedream-5-5-edit.json <<EOF
{
  "model": "seedream-5-5-261028",
  "prompt": "让图 1 中的模特穿上图 2 的外套，保持图 1 的姿势、表情和背景不变",
  "image": [
    "data:image/png;base64,$IMG1",
    "data:image/png;base64,$IMG2"
  ],
  "size": "2K",
  "response_format": "url",
  "watermark": false
}
EOF

python save_images.py seedream-5-5-edit.json seedream-5-5-edit
```

这次请求带 2 张参考图，费用是 \$0.035 + 2 × \$0.008 = \$0.051。每张参考图的格式、大小要求和 Seedream 其他版本相同，见 [Seedream 参考图限制](https://docs.laozhang.ai/api-capabilities/seedream-image.md#本地图片怎么传？参考图有什么限制？)。

## 分层：拆成底图和透明图层

设置 `"layer_decomposition": true` 并传 1 张图片，Seedream 5.5 会返回一张补全后的底图和若干张只含一个元素的透明 PNG 图层。和 5.0 相比，5.5 可以用 `layer_decomposition_options` 控制拆分粒度：

* `max_images`：本次最多返回几张，包含底图，范围 2–100，默认 30。值越大拆得越细，也可能更贵。
* `text_recognition`：设为 `true` 时，普通文字图层会额外返回 `text_recognition`，包括文字内容、近似字体、颜色和粗体、斜体、下划线等样式。艺术字和手写字不返回。

```bash theme={null}
curl --fail-with-body --max-time 360 "https://api.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5-261028",
    "image": "https://example.com/your-poster.png",
    "layer_decomposition": true,
    "layer_decomposition_options": {
      "max_images": 6,
      "text_recognition": true
    },
    "size": "1K",
    "response_format": "url",
    "watermark": false
  }' \
  -o seedream-5-5-layers.json
```

把 `image` 换成你自己的图片：png 或 jpeg，总像素不少于 512×512，不超过 30 MB。示例用 `1K`，1K 分层通常 20–30 秒返回，`2K` 更慢。

`data[]` 的第 1 项是底图（`z_index` 为 0），其余每项是一个图层。下面是一张海报拆出的文字图层，只保留了关键字段：

```json theme={null}
{
  "size": "1616x649",
  "output_format": "png",
  "z_index": 2,
  "bounding_box": {
    "absolute": [0, 0, 836, 336],
    "normalized": [0, 0, 1000, 268]
  },
  "name": "Bold uppercase text \"SUMMER\"",
  "background": "transparent",
  "text_recognition": {
    "text": "SUMMER",
    "lines": [
      {
        "runs": [
          {
            "text": "SUMMER",
            "style": {
              "similar_font_family": "TikTok Sans",
              "foreground_color": "#FFFFFF",
              "bold": true,
              "italic": false
            }
          }
        ]
      }
    ]
  }
}
```

`bounding_box`、`z_index` 的含义和重新合成图层的脚本与 5.0 相同，见 [Seedream 分层响应与重新合成](https://docs.laozhang.ai/api-capabilities/seedream-image.md#分层响应)。图层 PNG 的像素尺寸不一定等于框的大小，合成时要缩放到 `absolute` 框里。

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `model` | string | 是 | `seedream-5-5-261028` 或 `dola-seedream-5-5-261028` |
| `prompt` | string | 是 | 图片描述或编辑指令；分层时可以不传 |
| `image` | string 或 string\[] | 否 | 参考图，最多 10 张；分层时只能 1 张 |
| `size` | string | 否 | `1K`、`1.5K`、`2K`（默认），或像素宽高，见下方说明 |
| `background` | string | 否 | `auto`（默认）、`transparent`、`opaque`；分层时不能传 |
| `output_format` | string | 否 | `png`（默认）或 `jpeg` |
| `response_format` | string | 否 | `url`（默认）或 `b64_json` |
| `watermark` | boolean | 否 | 默认 `true`，会加「AI generated」字样，需要无水印时传 `false` |
| `layer_decomposition` | boolean | 否 | 设为 `true` 时分层 |
| `layer_decomposition_options` | object | 否 | 分层选项：`max_images`（2–100）、`text_recognition` |

`size` 写像素宽高时：

* 宽和高之间用英文字母 `x`，例如 `2048x2048`、`2848x1600`。
* 总像素在 921,600（`1280x720`）到 4,624,220 之间。
* 宽高比在 1/16 到 16 之间。

用档位时画面比例由模型按内容决定，需要固定比例就写像素宽高。

## 计费

**Seedream 5.5 按返回的图片张数计费，每张 \$0.035，参考图每张另收 \$0.008。**

| 请求 | 费用 |
| - | - |
| 文生图，1K、1.5K 或 2K | \$0.035 |
| 1 张参考图改图 | \$0.035 + \$0.008 = \$0.043 |
| 10 张参考图改图 | \$0.035 + 10 × \$0.008 = \$0.115 |
| 分层，返回 6 张（含底图） | 6 × \$0.035 + \$0.008 = \$0.218 |

> [!WARNING]
>
> **分层张数决定费用，用 `max_images` 设上限。**
>
> * 不设 `max_images` 时最多可能返回 30 张，按 \$0.035 一张计费；元素少的图实际张数会更少。
> * 2K 分层耗时较长，客户端超时设到 300 秒以上；客户端提前断开后，服务端完成的请求仍会计费。
> * 返回非 200（参数错误、内容审核拦截等）不扣费。实际扣费以[调用日志](https://docs.laozhang.ai/faq/call-logs.md)为准。

## 常见问题

### Seedream 5.5 的模型 ID 是什么？

`seedream-5-5-261028`。BytePlus 文档里的原名 `dola-seedream-5-5-261028` 也能直接调用，两个名字价格相同，响应里的 `model` 字段显示 `dola-seedream-5-5-261028`。

### Seedream 5.5 API 多少钱一张？

每张 \$0.035，1K、1.5K、2K 同价；带参考图时每张参考图另收 \$0.008。分层按返回的张数计费，底图也算一张。

### Seedream 5.5 支持 fast 模式吗？

不支持。`optimize_prompt_options.mode` 只能是默认的 `standard`，传 `fast` 会返回 400，不扣费，报错里写着 `must be standard for Seedream 5.5`。

Seedream 系列里只有 5.0 Pro 和 4.0 支持 fast 模式。

### Seedream 5.5 能出 4K 吗？

不能。最高约 2048×2048（总像素 4,624,220）。需要 4K 时用 `seedream-4-5-251128` 或 `seedream-4-0-250828`，需要 3K 用 `seedream-5-0-260128`，见 [Seedream 各版本的尺寸范围](https://docs.laozhang.ai/api-capabilities/seedream-image.md#size-可以填哪些值？能出-4k-吗？)。

### 能一次生成多张图吗？

不能。Seedream 5.5 不支持组图模式 `sequential_image_generation`，也不支持 `stream`，请求里不要带这两个字段。需要多张图时分别发请求，或改用 `seedream-5-0-260128` 的组图模式。

### 需要 BytePlus 或火山方舟账号吗？

不需要。在老张API创建 `default` 分组的令牌，用 `sk-` 开头的密钥即可调用全部 Seedream 模型。

## 相关文档与来源

* [Seedream API：5.0 Flash、5.0 Pro、5.0、4.5、4.0](https://docs.laozhang.ai/api-capabilities/seedream-image.md)：其他版本的价格、组图模式和尺寸
* [Seedream 5.5 上线公告](https://docs.laozhang.ai/announcements/seedream-5-5-2026-11.md)
* [图像生成 API 选型与价格](https://docs.laozhang.ai/api-capabilities/image-generation-guide.md)：与 GPT Image、Nano Banana、FLUX.2 对比
* [模型与价格总表](https://docs.laozhang.ai/models.md)
* [BytePlus ModelArk 图像生成 API](https://docs.byteplus.com/en/docs/ModelArk/1541523)：`background`、`layer_decomposition_options` 等参数的官方说明（2026 年 11 月 13 日核对）
* [BytePlus ModelArk 模型列表](https://docs.byteplus.com/en/docs/modelark/model-list)：各模型能力与限流


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