guides

Seedream 5.5 API 指南:价格、参数与代码示例

Poyo.ai Team
10 min read
Share:

核心要点

  • Seedream 5.5 是字节跳动 Seed 团队最新的图像模型,2026 年 11 月 9 日发布。一个模型就能完成文生图、单图编辑,以及最多 10 张参考图的多图编辑。
  • PoYo 提供两个模型 ID。 seedream-5.5 负责生成和编辑图片;seedream-5.5-layerize 把一张图拆成一张底图加最多 99 个透明图层。
  • 按张计费。 1K 或 1.5K 每张 4 积分($0.02),2K 每张 7 积分($0.035),每张参考图另加 1.6 积分($0.008)。分层拆解按实际返回的图片张数计费,底图也算一张。
  • 透明 PNG 只差一个参数。 把 background 设为 transparent、输出格式用 png,就能得到 RGBA 图片;既可以从提示词生成,也可以用普通 RGB 照片作参考图。
  • 最高输出 2K(1:1 为 2048×2048,21:9 为 3136×1344),每次请求出一张图。
  • 所有调用都是异步的。 先提交任务,再轮询状态接口,或者传入 callback_url 等回调。PoYo 实测中,Seedream 5.5 平均约 24 秒出一张图。

Seedream 5.5 API 一览

PoYo 上的 Seedream 5.5
开发方字节跳动 Seed(BytePlus 上的名称是 Dola Seedream 5.5)
发布日期2026 年 11 月 9 日
模型 IDseedream-5.5、seedream-5.5-layerize
模式文生图、图像编辑、多参考图合成、分层拆解
参考图1–10 张(JPEG、PNG 或 WebP,每张不超过 10 MB)
分辨率1K、1.5K、2K(默认 2K)
宽高比1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9,编辑时还可用 auto
背景auto、transparent、opaque
输出格式png(默认)或 jpeg
图层底图 + 最多 99 个图层,可选文字 OCR
价格1K/1.5K 每张 4 积分($0.02),2K 每张 7 积分($0.035),每张参考图 +1.6 积分

Seedream 5.5 有哪些新变化

字节跳动称 Seedream 5.5 是"新一代图像创作模型"。发布博客和 API 文档重点介绍了四项升级:

  • 多轮编辑更稳定。 未编辑的区域能做到"像素级"保留,颜色始终如一。字节跳动演示了对同一人物图片连续编辑 100 轮。
  • 原生 RGBA 输出。 模型可以直接生成带 Alpha 通道的图片,支持全透明和半透明;文生图可以,用最多 10 张普通 RGB 参考图做图生图也可以。
  • 分层拆解更精细。 一张底图加最多 99 个图层,可以设置输出张数上限,文字图层还能返回富文本 OCR。
  • 小字更清晰,画面更真实。 按字节跳动自己的评测,严重文字崩坏率降到 0.4%,轻微文字崩坏率降到 1.7%;与上一版相比,图生图真实感的 GSB 达到 +55.62%。

字节跳动还表示,Seedream 5.5 系列的 Pro 版本会随后推出。想看与旧版本的完整对比,可以读 Seedream 5.5 vs 5.0 Pro vs 5.0 Lite。

该用哪个模型 ID

你想做的事模型 ID输入输出
根据提示词生成图片seedream-5.5prompt1 张图
编辑一张图,或合成最多 10 张图seedream-5.5prompt + image_urls(1–10 张)1 张图
做透明贴纸、图标或抠图素材seedream-5.5prompt(可加 image_urls),background: "transparent"1 张 RGBA PNG
把成品图拆成可编辑的部件seedream-5.5-layerizeimage_urls(1 张)+ 可选 prompt底图 + 图层

文生图和编辑共用同一个模型 ID:给 seedream-5.5 加上 image_urls,它就切换到编辑模式。

请求参数

seedream-5.5

参数类型取值默认值
promptstring,必填5–5,000 个字符—
image_urlsarray1–10 个公网图片 URL;传了即进入编辑模式—
sizestring1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、auto(编辑时)文生图为 1:1,编辑为 auto
resolutionstring1K、1.5K、2K2K
backgroundstringauto、transparent(需配合 png)、opaqueauto
output_formatstringpng、jpegpng
enable_safety_checkerbooleantrue、falsetrue

编辑时用 size: "auto",输出会沿用参考图的比例,像素面积接近所选分辨率档位。

输出尺寸

size1K1.5K2K
1:11024×10241536×15362048×2048
4:31152×8641792×13442368×1776
3:4864×11521344×17921776×2368
16:91424×8002048×11522816×1584
9:16800×14241152×20481584×2816
3:21248×8321872×12482496×1664
2:3832×12481248×18721664×2496
21:91568×6722352×10083136×1344

seedream-5.5-layerize

参数类型取值默认值
image_urlsarray,必填1 张 JPEG 或 PNG,不超过 10 MB,512×512 到 6000×6000 像素,宽高比 1:16 到 16:1—
promptstring说明怎么拆,最多 2,000 个字符由模型自动识别主要元素
resolutionstring1K、1.5K、2K、autoauto
max_imagesinteger2–100,含底图30
text_recognitionboolean对普通文字图层做 OCRfalse
output_formatstringpng、jpeg(只作用于底图,图层始终是 PNG)png
enable_safety_checkerbooleantrue、falsetrue

auto 的规则是:原图在 1K 到 2K 之间就保持原尺寸,小于 1K 放大到 1K,大于 2K 缩小到 2K。

Seedream 5.5 价格

PoYo 对 Seedream 5.5 按张计费,单价与字节跳动官方 API 相同,无需订阅,一个 API Key 即可调用所有 Seedream 版本。$1 = 200 积分,只有任务成功才扣积分。

计费项积分美元
seedream-5.5 1K 或 1.5K 每张4$0.02
seedream-5.5 2K 每张7$0.035
image_urls 中的每张参考图1.6$0.008
seedream-5.5-layerize 1K 或 1.5K,每张返回的图片4$0.02
seedream-5.5-layerize 2K 或 auto,每张返回的图片7$0.035
seedream-5.5-layerize 输入图1.6$0.008

成本示例

任务算法费用
1 张 1K 透明贴纸44 积分($0.02)
1 张 2K 文生图商品图77 积分($0.035)
对 1 张照片做一次 2K 编辑7 + 1.68.6 积分($0.043)
用 10 张参考图合成 1 张 2K 图7 + 10 × 1.623 积分($0.115)
2K 多轮编辑 5 轮,每轮 1 张参考图5 × 8.643 积分($0.215)
1,000 张 2K 文生图1,000 × 77,000 积分($35)
1K 分层,返回底图 + 5 个图层(PoYo 实测)6 × 4 + 1.625.6 积分($0.128)
auto 分层,返回底图 + 32 个图层33 × 7 + 1.6232.6 积分($1.163)

分层拆解有两点要注意。模型会按图片内容返回所需的图层数,可能少于 max_images,只按实际返回的张数收费。但提交时,账户余额必须够 max_images 张的费用:默认 30 张、auto 分辨率,就是 30 × 7 = 210 积分。

快速上手:提交任务并查询结果

在 API Key 控制台 创建密钥,存到环境变量里:

export POYO_API_KEY="your-api-key"

向统一接口提交任务:

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "胡桃木台面上的一套陶瓷手冲咖啡器具,清晨窗边的柔和光线,杯口升起热气,极简商品摄影",
      "size": "16:9",
      "resolution": "2K"
    }
  }'

响应里会返回 task_id:

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1794470400-abcd1234",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

用同一个密钥查询状态:

curl --request GET \
  --url https://api.poyo.ai/api/generate/status/task-unified-1794470400-abcd1234 \
  --header "Authorization: Bearer $POYO_API_KEY"

data.status 会依次变为 not_started、running、finished(或 failed)。变成 finished 后,图片地址在 data.files[].file_url,扣费金额在 data.credits_amount。也可以在提交请求的顶层加上 callback_url,任务完成或失败时,系统会把同样的任务对象 POST 到这个地址。

本文后面的示例都用下面这个 Python 函数提交任务并等待结果:

import os
import time

import requests

API = "https://api.poyo.ai/api/generate"
HEADERS = {"Authorization": f"Bearer {os.environ['POYO_API_KEY']}"}


def run(model: str, payload: dict, interval: float = 4, timeout: float = 300) -> dict:
    """Submit a PoYo task and return the finished task data."""
    resp = requests.post(
        f"{API}/submit",
        headers=HEADERS,
        json={"model": model, "input": payload},
        timeout=30,
    )
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") != 200:
        raise RuntimeError(body)
    task_id = body["data"]["task_id"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/status/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] == "finished":
            return task
        if task["status"] == "failed":
            raise RuntimeError(task.get("error_message"))
        time.sleep(interval)
    raise TimeoutError(task_id)

除了 HTTP 状态码,还要检查响应体里的 code:有些参数校验错误会返回 HTTP 200,但 code 是 400。另外几个需要处理的码是 401(密钥无效)、402(积分不足)和 429(触发限流)。

示例 1:带精确文字的文生图

Seedream 5.5 擅长渲染密集的小字,所以要把图上每一行文字都写清楚。下面是 PoYo 实测用的海报提示词:

task = run("seedream-5.5", {
    "prompt": (
        "A vertical exhibition poster for a ceramics show. A realistic photograph of a "
        "handmade speckled stoneware vase holding dried pampas grass on a linen-draped plinth, "
        "soft side window light and gentle shadows. The poster contains exactly four lines of "
        "text and nothing else: the bold serif headline \"CLAY & LIGHT\" at the top, the subtitle "
        "\"Handmade Ceramics Exhibition\" under it, and \"March 14 - 30, 2027\" and "
        "\"Harbor Gallery, Hall B\" at the bottom. Clean Swiss layout with generous empty space, "
        "warm cream background, terracotta accent color."
    ),
    "size": "3:4",
    "resolution": "2K",
    "output_format": "png",
})
print(task["files"][0]["file_url"])  # 1776×2368 PNG, 7 credits

Seedream 5.5 文生图海报:柔和窗光下,铺着亚麻布的桌上摆着插有蒲苇的斑点粗陶花瓶,顶部是标题"CLAY & LIGHT"和副标题"Handmade Ceramics Exhibition",底部写着"March 14 - 30, 2027"和"Harbor Gallery, Hall B"

PoYo 用上面的提示词实测生成的 2K 海报(Seedream 5.5)。

写明"只有这四行文字"能让文案更干净。文字较多的版式,建议多预留一次生成的预算,从中挑选效果最好的一张。

示例 2:多参考图编辑

最多可以传 10 张图,在提示词里按顺序称呼它们:第一个 URL 是图 1,第二个是图 2。写清每张图提供什么、哪些内容必须保持不变。

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "把图 1 中的青花瓷瓶竖直放在图 2 空玻璃展柜的正中央。保留瓷瓶的轮廓、钴蓝纹样和釉面,博物馆建筑和木质展柜保持不变。光线匹配展厅的暖色灯光,透视、比例一致,底部带柔和的接触阴影。",
    "image_urls": [
      "https://storage.poyo.ai/models/seedream-5-0-flash/examples/museum-input-1.webp",
      "https://storage.poyo.ai/models/seedream-5-0-flash/examples/museum-input-2.webp"
    ],
    "size": "4:3",
    "resolution": "2K"
  }
}

正式使用时换成你自己的公网 HTTPS 图片即可。编辑时如果不传 size,默认是 auto,输出会沿用参考图的比例。这次请求的费用是 7 + 2 × 1.6 = 10.2 积分($0.051)。

示例 3:透明 PNG

把 background 设为 transparent,output_format 保持 png。在提示词里描述一个独立的主体,效果会更好:

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "A clear glass teapot filled with amber tea and floating chamomile flowers, with a soft natural reflection on the glass, product cutout isolated on a transparent background.",
    "size": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

PoYo 实测约 22 秒返回一张 1024×1024 的 RGBA PNG,花费 4 积分。玻璃这类半透明区域会保留部分透明度,放到任何背景上都很自然。

Seedream 5.5 透明输出:一个圣诞主题的透明亚克力音乐播放器立牌,带黑胶唱片、叶子和浆果花环、驯鹿与雪花贴纸,放在棋盘格背景上,便于看出全透明和半透明区域

字节跳动 Seedream 5.5 文档中的文生 RGBA 示例,放在棋盘格上以显示 Alpha 通道。

透明素材也可以从照片里提取。字节跳动的示例把两张拼贴海报作为参考图,输出一张透明背景的贴纸合集;提示词要求分别从图 1 和图 2 中提取贴纸元素,去掉贴纸以外的所有背景,并让贴纸互不重叠、边缘完整清晰。

示例 4:多轮编辑

要持续修改同一张图,就把每次的结果作为下一轮的参考图,并写清改什么、保留什么:

image = "https://storage.poyo.ai/models/seedream-5-5/examples/transparent-teapot-2c9bec305560.png"

steps = [
    "Place the glass teapot from image 1 on a rustic wooden table by a window in soft morning "
    "sunlight. Keep the teapot's shape, glass lid, handle, amber tea and floating chamomile "
    "flowers unchanged.",
    "Add a white ceramic cup of tea next to the teapot. Keep everything else unchanged.",
    "Change the time of day to warm late-afternoon light. Keep the teapot, cup, table and "
    "window unchanged.",
]

for prompt in steps:
    task = run("seedream-5.5", {
        "prompt": prompt,
        "image_urls": [image],
        "size": "1:1",
        "resolution": "2K",
        "background": "opaque",
    })
    image = task["files"][0]["file_url"]
    print(image)

字节跳动建议,多轮编辑时用不带 Alpha 通道的 RGB 图作输入,并把 background 设为 opaque,一致性最好。只在最后一步需要抠图时再切换到 transparent。这里每轮 8.6 积分,三轮共 25.8 积分($0.129)。

Seedream 5.5 多轮编辑:原图是一位身穿橙色针织 Polo 衫的女性,第 1 轮加上粉色泡泡糖,第 2 轮戴上黑色墨镜,第 3 轮换成金框眼镜,她的头发、珍珠耳环、毛衣和蓝色背景始终不变

同一张人像的三轮编辑,来自字节跳动的 Seedream 5.5 文档。

示例 5:分层拆解

seedream-5.5-layerize 只接收一张图。不传提示词时,模型会自动找出主要元素,各放一个图层。下面的请求拆分的是示例 1 的陶瓷海报:

{
  "model": "seedream-5.5-layerize",
  "input": {
    "image_urls": ["https://storage.poyo.ai/models/seedream-5-5/examples/t2i-clay-and-light-7c708282a2fe.png"],
    "resolution": "1K",
    "max_images": 6
  }
}

想指定拆哪些内容,就加一个 prompt,例如"把每只动物单独放一个图层,其余场景留在底图里"。字节跳动用这类提示词做过演示:max_images: 40 返回了 33 张图,即一张底图加 32 个动物图层。

Seedream 5.5 分层拆解:一幅满是动物的丛林插画、去掉动物后的底图,以及 32 个透明动物图层中的 8 个,包括老鹰、熊猫、斑马、狮子、长颈鹿、火烈鸟、狐狸和青蛙

字节跳动 Seedream 5.5 分层拆解示例中的输入图、底图和 32 个图层中的 8 个。

任务完成后,data.files 按图片逐个列出,底图排在第一位,每个文件都带一个 layer 对象。下面这段节选来自 PoYo 对上面这张海报的实测,约 30 秒返回了底图加 5 个图层:

{
  "files": [
    {
      "file_url": "https://storage.poyo.ai/images/task-unified-1794470400-abcd1234/task-unified-1794470400-abcd1234_1.png",
      "file_type": "image",
      "layer": { "z_index": 0 }
    },
    {
      "file_url": "https://storage.poyo.ai/images/task-unified-1794470400-abcd1234/task-unified-1794470400-abcd1234_2.png",
      "file_type": "image",
      "layer": {
        "z_index": 1,
        "name": "Dark brown bold serif main title",
        "description": "Dark brown bold serif main title text reading \"CLAY & LIGHT\"",
        "bounding_box": {
          "absolute": [0, 0, 887, 295],
          "normalized": [0, 0, 1000, 250]
        }
      }
    }
  ]
}
  • z_index:底图为 0,图层从 1 开始递增,数值越大越靠上。
  • bounding_box.absolute:以底图像素为单位的 [left, top, right, bottom];normalized 是同一个框在 0–1000 坐标系下的值。
  • name 和 description 由模型生成。

这次实测的另外四个图层分别是副标题、铺着亚麻布的桌面、插着蒲苇的花瓶,以及日期和场馆信息。要还原原图,把每个图层缩放到对应的框,再按 z_index 顺序叠加:

from io import BytesIO

import requests
from PIL import Image


def load(url: str) -> Image.Image:
    return Image.open(BytesIO(requests.get(url, timeout=60).content)).convert("RGBA")


def rebuild(files: list[dict]) -> Image.Image:
    files = sorted(files, key=lambda f: f["layer"]["z_index"])
    canvas = load(files[0]["file_url"])  # base image, z_index 0
    for f in files[1:]:
        left, top, right, bottom = f["layer"]["bounding_box"]["absolute"]
        layer = load(f["file_url"]).resize((right - left, bottom - top), Image.LANCZOS)
        canvas.alpha_composite(layer, (left, top))
    return canvas

图层文件往往比它的框大(上面的标题图层是 1775×591,而框是 887×295),所以放置前一定要先缩放。如果要放到尺寸不同的画布上,就改用 normalized 坐标换算。

文字图层的 OCR

加上 "text_recognition": true,每个普通文字图层还会返回 layer.text_recognition:完整文本、每一行的位置框,以及带近似样式的文本段(similar_font_family、foreground_color、bold、italic、underline、strikethrough、shadow、translucent)。设计工具可以用这些数据改文案、做多语言版本或复用模板。艺术字和手写字会保留在图像图层里。

Seedream 5.5 文字图层 OCR:一张带大本钟的"THANK YOU SO MUCH!"海报,以及它的九个文字图层和对应的识别文本,例如"THANK YOU""December - 29 - 2026"和联系方式

字节跳动 Seedream 5.5 文档中的文字图层及其 OCR 结果。

实用建议

  • 按用途选分辨率。 1K 和 1.5K 价格相同,都是 4 积分,凡是可能上线使用的图,直接用 1.5K。印刷、主视觉和细小文字再用 2K。
  • 留意参考图附加费。 每张参考图加 1.6 积分。只传这次编辑真正需要的图,一张选得好的参考图往往比五张随意的更有效。
  • 编辑提示词写成"改什么 + 保留什么"。 例如"把 X 换成 Y,A、B、C 保持不变",给模型清晰的边界,多轮编辑也更稳定。
  • 按顺序称呼参考图。 按 image_urls 的顺序写"图 1""图 2"。
  • 透明图用 png。 transparent 搭配 output_format: "png",PNG 能保存 Alpha 通道。
  • 按任务调 max_images。 简单的商品图几个图层就够;画面复杂的插画用 30–60 效果更好。数值越低,提交时需要的余额也越少。
  • 及时保存结果。 任务完成后,尽快把每个 file_url 下载到自己的存储。
  • 量大时用回调。 callback_url 能省去轮询几百个任务;处理逻辑要做成幂等,因为同一个完成事件可能送达不止一次。

Seedream 5.5 与 PoYo 上其他 Seedream API

模型适合场景PoYo 最高分辨率PoYo 每张价格
Seedream 5.5多轮编辑、透明 PNG、分层文件2K4 积分(1K/1.5K)或 7 积分(2K),每张参考图 +1.6
Seedream 5.0 Pro密集排版、信息图、多语言文字2K15 积分
Seedream 5.0 Lite3K 输出、自定义尺寸、一次最多 15 张组图3K5 积分
Seedream 5.0 Flash低成本草图和多参考图编辑2K4 积分

想并排对比能力、价格和迁移步骤,请看 Seedream 5.5 vs 5.0 Pro vs 5.0 Lite。更早的指南还有 Seedream 5.0 Pro API 指南、Seedream 5.0 Pro 功能介绍 和 Seedream 5.0 Flash 指南。

常见问题

Seedream 5.5 是什么?

Seedream 5.5 是字节跳动 Seed 团队的图像创作模型,2026 年 11 月 9 日发布,和 BytePlus 上的 Dola Seedream 5.5 是同一个模型。它支持文生图、最多 10 张参考图的编辑、原生透明 PNG,以及把图片拆成一张底图加最多 99 个图层。

Seedream 5.5 API 多少钱?

在 PoYo 上,seedream-5.5 1K 或 1.5K 每张 4 积分($0.02),2K 每张 7 积分($0.035),每张参考图另加 1.6 积分($0.008)。seedream-5.5-layerize 对每张返回的图片(含底图)按同样的单价收费,输入图另加 1.6 积分;auto 分辨率按 2K 计费。

有免费的 Seedream 5.5 API 吗?

PoYo 上的 Seedream 5.5 随用随付:按成功生成的图片付费,无需订阅,也没有最低消费,每张 $0.02 起。一个 API Key 就能调用所有 Seedream 版本。写代码之前,可以先在 Seedream 5.5 模型页 的 Playground 里试提示词。

有 Seedream 5.5 Pro 吗?

字节跳动已经宣布,Seedream 5.5 系列的 Pro 版本会随后推出。目前发布的是 Seedream 5.5,在 PoYo 上的模型 ID 是 seedream-5.5 和 seedream-5.5-layerize。

Seedream 5.5 支持 4K 吗?

Seedream 5.5 的输出档位是 1K、1.5K 和 2K。最大尺寸为 1:1 的 2048×2048、16:9 的 2816×1584 和 21:9 的 3136×1344。需要 3K 输出时,可以用 Seedream 5.0 Lite。

最多能用几张参考图?

每次请求最多 10 张,格式为 JPEG、PNG 或 WebP 的公网 URL,每张不超过 10 MB。每张参考图加收 1.6 积分。分层拆解只接收一张输入图。

怎么生成透明背景?

把 background 设为 transparent,output_format 设为 png。文生图和编辑都可以这样用,参考图用普通 RGB 照片即可。

Seedream 5.5 能拆出多少个图层?

最多 99 个图层加一张底图。max_images 可设为 2 到 100(默认 30);模型会在这个上限内按图片需要返回图层,只按实际返回的张数收费。

一次 Seedream 5.5 请求要多久?

PoYo 在 2026 年 11 月的测试中,seedream-5.5 平均约 24 秒出一张图,90 分位约 29 秒。返回 3 到 13 张图的分层请求耗时约 18 到 47 秒。

Seedream 5.5 一次请求能出多张图吗?

每次 seedream-5.5 请求返回一张图。需要多个变体时,就并行发多个请求,并分别记录每个 task_id。分层拆解是例外:一次请求会返回底图和全部图层。

Share: