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

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 生成的雨后江南小巷，女孩撑油纸伞走过，右上角有书法字烟雨 — 「文生图」示例的输出：2K，返回 2496×1664，画面里的书法字「烟雨」由模型直接写出

Seedream 5.5 直接生成的透明背景陶瓷咖啡杯 PNG — 「透明背景 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；要 3K、4K 或组图模式，用 5.0、4.5、4.0，见 Seedream 各版本对比。

调用前准备

创建令牌

在令牌管理新建令牌，分组选 default，计费模式选「按量优先」（推荐）或「按次计费」。不需要火山方舟或 BytePlus 账号。

设置密钥并安装依赖

export LAOZHANG_API_KEY="替换为你的老张API令牌"
python -m pip install requests pillow

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

文生图

cURL

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 参考中的保存脚本，会下载 data[] 里的每张图片并按实际格式命名。2K 通常 25–35 秒返回，1K 约 12–20 秒。Seedream 5.5 默认输出 PNG，需要 JPEG 时传 "output_format": "jpeg"。

Python

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 通道的图片，不需要再抠图。文生图和参考图改图都可以这样输出。

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。

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 参考图限制。

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

设置 "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，包括文字内容、近似字体、颜色和粗体、斜体、下划线等样式。艺术字和手写字不返回。

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），其余每项是一个图层。下面是一张海报拆出的文字图层，只保留了关键字段：

{
  "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 分层响应与重新合成。图层 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

分层张数决定费用，用 max_images 设上限。

不设 max_images 时最多可能返回 30 张，按 $0.035 一张计费；元素少的图实际张数会更少。
2K 分层耗时较长，客户端超时设到 300 秒以上；客户端提前断开后，服务端完成的请求仍会计费。
返回非 200（参数错误、内容审核拦截等）不扣费。实际扣费以调用日志为准。

常见问题

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 各版本的尺寸范围。

能一次生成多张图吗？

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

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

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

开始使用

图像生成与编辑 API

视频生成 API

文本 API

多模态与音频 API