GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

Seedream 5.5 API：可用状态、参数与接入步骤

Seedream 5.5 API 接入指南：了解目前可用的调用入口、全部请求参数、尺寸设置、支持 OCR 的图层拆分和按张计费规则，并通过可直接运行的请求示例开始测试。

Seedream 5.5 API：可用状态、参数与接入步骤

现在即可在 reAPI 上调用 Seedream 5.5 API：通过异步图像接口，使用模型 ID doubao-seedream-5-5。Seedream 5.5 API 已开放：ByteDance 于 2026 年 11 月 9 日发布了该模型，它也已在 BytePlus 的 Lumina 创作工作台上线。[1][2]

本指南介绍 Seedream 5.5 API 接受哪些参数、尺寸与图层拆分如何使用、每次请求的费用，并提供可直接运行的请求。参数和价格详情描述的是截至 2026 年 11 月 10 日的 reAPI API。

要点速览

  • 在 reAPI 上，调用 POST /api/v1/images/generations，传入 "model": "doubao-seedream-5-5"，然后轮询任务获取图像 URL。[3]
  • 尺寸支持 1K、1.5K 或 2K、十种宽高比，也可指定精确像素。最多 10 张参考图。不支持 3K 或 4K。[3]
  • 提示词和参考图输入均支持透明输出；图层拆分最多返回 100 张图像，可选文字识别。[3]
  • 在 reAPI 上，每张输出图像的价格为：1K 或 1.5K $0.013，2K $0.023，每张参考图另收 $0.0052（2026 年 11 月 10 日上线时的价格）。[4]

Seedream 5.5 API 的当前状态

入口2026 年 11 月 10 日的状态
reAPI 图像 API已上线，模型 ID 为 doubao-seedream-5-5[3]
BytePlus LuminaSeedream 5.5 已在创作工作台上线[2]

ByteDance 对该模型能力的描述来自其公告：100 轮多轮编辑中保持未编辑区域完整、原生透明输出，以及更清晰的小字。在 ByteDance 的测试中，严重文字畸变率为 0.4%，轻微畸变率为 1.7%。[1]

Seedream 5.5 API 参数

下方列出 reAPI 的 Seedream 5.5 请求体字段。[3]

字段用途
prompt描述要生成的图像或进行的编辑。除图层拆分外均为必填。
size档位（1K、1.5K、2K；默认 2K）、auto、宽高比，或精确的 WIDTHxHEIGHT。
resolution1K、1.5K 或 2K，与宽高比形式的 size 配合使用。
image_urls最多 10 个公网参考图 URL。
backgroundauto、opaque 或 transparent。透明背景需使用 PNG 输出。
output_formatpng（默认）或 jpeg。
layer_decomposition将一张图像拆分为一张底图和多个透明图层。
layer_decomposition_optionsmax_images（2–100，默认 30）和 text_recognition。
optimize_prompt_options仅支持 { "mode": "standard" }；优化始终开启。
watermark添加“AI 生成”标识。
n固定为 1。

尺寸是容易出错的字段。十种宽高比分别为 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9、2:1 和 1:2；选择其中一种，再搭配 resolution 指定档位。精确像素的总数需在 921,600 到 4,624,220 之间，宽高比需在 1/16 到 16 之间，发送时不带 resolution。[3]

有两项规则与 Seedream 5.0 Pro 不同。5.5 的文生图和图像编辑均支持透明输出，而 5.0 Pro 需要恰好一张参考图才能透明输出。另外，5.5 的图层拆分允许设置返回的图像数量，最多 100 张；5.0 Pro 则最多返回一张底图加 16 个图层。[3][5]

可直接运行的 Seedream 5.5 API 请求

curl https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-5",
    "prompt": "A frosted glass perfume bottle with pale gold liquid, soft studio light",
    "size": "16:9",
    "resolution": "2K"
  }'

响应包含任务 id，状态为 status: "processing"。轮询 GET /api/v1/tasks/{id}，直到状态为 completed，再从 output.image_urls 读取图像。生成的 URL 会过期，因此请将结果复制到你自己的存储中。[3]

带文字识别的图层拆分

传入恰好一张图像，开启 layer_decomposition，不传 background：

{
  "model": "doubao-seedream-5-5",
  "image_urls": ["https://example.com/poster.png"],
  "layer_decomposition": true,
  "layer_decomposition_options": { "max_images": 10, "text_recognition": true },
  "size": "1K"
}

任务完成后，output.image_urls 中先列出底图，再依次列出各图层，output.layers 中有对应条目：叠放顺序、以底图坐标表示的边界框，以及在 OCR 识别到常规文字时提供的 text_recognition 对象，其中包含文字、文本行边界框和估计的样式。[3]图层拆分可能需要几分钟，请持续轮询同一任务，不要重复提交。

Seedream 5.5 API 请求失败时如何处理

大多数失败会表现为以下四种情况之一，其中只有一种会产生费用：[3]

  • 提交时同步返回 400。 某个字段违反了文档中的规则，例如宽高比不在支持列表中、jpeg 使用透明背景，或图层模式未传入恰好一张图像。错误信息会指出该字段，且不收取任何费用。
  • 提交时返回 402。 余额不足以支付预扣费用。图层拆分会预扣 max_images 张图像的费用，因此降低该上限会有所帮助。
  • 任务失败。 内容政策拒绝、无法访问的图像 URL，以及 AVIF 等不支持的格式，都会使任务以失败状态结束，预扣费用将全额退还。
  • 长时间处于 processing 状态。 图层拆分可能需要几分钟。请持续轮询同一任务，不要再次提交，否则会支付两次费用。

Seedream 5.5 API 的费用

reAPI 对 Seedream 5.5 的每张输出图像按尺寸档位计费，每张参考图另计；第一张参考图也不免费。[3] 2026 年 11 月 10 日上线时的费率为：[4]

项目价格
输出图像，1K 或 1.5K（不超过 2,610,000 px）$0.013[4]
输出图像，2K（超过 2,610,000 px）$0.023[4]
每张参考图$0.0052[4]

举例，向上取整到整数 credits（1 credit = $0.001）：一次 2K 文生图请求花费 23 credits；一次带一张参考图的 1K 编辑花费 19 credits。[4]

图层拆分按请求的尺寸档位，预扣 max_images 张图像的费用，再按实际返回数量结算，单张输入图仅计费一次。一次 1K 拆分若上限设为 10 张图像，会预扣 136 credits；若实际返回四张图像，则花费 58 credits，其余退还。失败任务全额退款。作为对比，同一天 Seedream 5.0 Pro 在 reAPI 上每张 1K 图像为 $0.032，每张 2K 图像为 $0.063。[5]

根据任务选择尺寸与参考图

按尺寸分档计价时，选择满足任务所需的最小尺寸更划算。以下建议基于档位和输入的计费方式，并非质量测试：

  • 草稿与社交图片。 1.5K 与 1K 同价，因此在较低价格档位中，更适合作为默认选择。
  • 印刷、海报与密集文字。 2K 能为小字提供最多的像素，而小字正是 ByteDance 表示渲染有所改善的领域。[1]
  • 产品图编辑。 先用一张干净的参考图。只有第二张图包含第一张没有的信息（如场景或标志）时，才增加参考图，因为每张都计费。
  • 排版素材。 使用 background: "transparent" 并选择 PNG 输出，无需先生成白底图再抠图。

接入 Seedream 5.5 API 的后续步骤

以下清单是我们的编辑建议。

  1. 先在 Playground 中试用。 Seedream 5.5 页面使用相同参数，并在生成前显示费用。
  2. 采用异步流程。 提交、轮询，再复制结果。
  3. 用一个配置项保存模型 ID，便于用相同提示词比较 Seedream 5.5 和 5.0 Pro。
  4. 为参考图预留预算。 每张参考图都会增加费用，因此要测试实际需要多少张。
  5. 限制图层拆分数量。 按需设置 max_images；预扣额度由它决定。

常见问题

有 Seedream 5.5 API 吗？

有。reAPI 通过图像 API 提供 Seedream 5.5，模型 ID 为 doubao-seedream-5-5。[3]

Seedream 5.5 API 免费吗？

不免费。在 reAPI 上使用预付 credits 按量付费，无需订阅：每张输出图像和每张参考图均计费，失败任务退款。[4]

有 Seedream 5.5 API 教程吗？

Seedream 5.5 API 文档介绍了 cURL、Python、Node.js 和 Go 请求示例、所有参数、图层拆分输出及计费方式。上面的示例是最简可用请求。[3]

可以下载 Seedream 5.5 吗？

不可以。ByteDance 尚未发布 Seedream 5.5 权重或可下载模型；它以托管模型的形式在 ByteDance 应用中运行，也可通过 API 调用。[1][2]

Seedream 5.5 的文生图文档在哪里？

reAPI 的文档是 Seedream 5.5 API 文档。

如何获取 Seedream 5.5 API 密钥？

在 reAPI 控制台创建密钥，并以 Bearer token 形式传入。同一个密钥可以调用 Seedream 5.5 及账户内所有其他模型。

现在开始调用 Seedream 5.5 API

模型已经发布并可调用：向 reAPI 图像接口发送 doubao-seedream-5-5，在将 Seedream 5.5 API 接入代码之前，先在 Playground 中调整尺寸与参考图。

参考资料

  1. ByteDance Seed。图像更逼真，100 轮编辑更稳定 | Seedream 5.5 介绍。 访问于 2026 年 11 月：seed.bytedance.com/en/blog/more-realistic-images-more-stable-editing-across-100-rounds-introducing-seedream-5-5
  2. BytePlus。Seedream 5.5 发布日期：2026 年 11 月 9 日正式发布。 访问于 2026 年 11 月：ai.byteplus.com/lumina/en/resource/seedream-5-5-release-date
  3. reAPI。Seedream 5.5 API 文档。 访问于 2026 年 11 月：reapi.ai/docs/seedream-5-5
  4. reAPI。Seedream 5.5。 访问于 2026 年 11 月：reapi.ai/models/seedream-5-5
  5. reAPI。Seedream 5.0 Pro API 文档与模型页。 访问于 2026 年 11 月：reapi.ai/docs/seedream-5-0-pro 和 reapi.ai/models/seedream-5-0-pro
全部教程与指南