跳转到主要内容
Seedream 5.5
Seedream 5.5 是字节跳动的图像创作与编辑模型。使用 doubao-seedream-5-5-261028 调用文生图、参考图编辑、透明背景生成及可编辑图层拆分。 POST https://api.mixroute.ai/v1/images/generations 向图片生成接口发送 JSON,请求头为 Authorization: Bearer $MIXROUTE_API_KEY 和 Content-Type: application/json。参数直接放在顶层,不包进 metadata。参考图编辑和图层拆分也使用这个接口,不使用 /v1/images/edits 或 Chat Completions。
MixRoute 的所有请求都必须提供 prompt,图层拆分也不例外。即使上游示例将其标为可选,也不能省略。

请求参数

图片、尺寸与限制

  • 普通生成每次只返回 1 张图片,n 不控制输出数量。不支持流式、组图或联网搜索,请省略 stream、sequential_image_generation 及搜索工具字段。
  • 单张参考图不超过 30 MB,宽高比为 1:16 至 16:1。Base64 data URL 的格式名必须小写,例如 data:image/png;base64,...。
  • 生成时使用分辨率档位,可在 prompt 中描述宽高比;使用 宽x高 时用小写 x,总像素须为 921,600-4,624,220,宽高比为 1:16 至 16:1,例如 2880x1440。像素限制指宽乘高,不是单边长度。
  • 拆分只能输入 1 张 PNG 或 JPEG,总像素不少于 262,144(512 x 512)。size: auto 按输入尺寸与宽高比适配,不保证每个输出都保持原始像素尺寸,请读取各项 data[].size。
  • 任一图层失败,整个拆分请求失败。提示词要求的输出数超过 max_images 时,部分要求拆出的元素可能缺失。

请求示例

将 MIXROUTE_API_KEY 设置为 MixRoute Key。发送请求前,将下方 example.com 输入地址替换为可访问的图片。

文生图

多图参考

透明 PNG

图层拆分与 OCR

Python OpenAI SDK

安装 openai 包,设置 MIXROUTE_API_KEY 和 SEEDREAM_IMAGE_URL。Seedream 专有字段及分辨率值放在 SDK 的 extra_body 中;发送时会合并为顶层 JSON 字段,不会产生 extra_body 或 metadata 包装对象。示例关闭自动重试,避免盲目重复生图请求。

返回字段

以下为包含 1 张底图和 1 个图层的示意响应节选:

还原图层

以 z_index: 0 的底图为画布,按 bounding_box.absolute 将各图层缩放到 (right - left) x (bottom - top),放置在 (left, top),再按 z_index 从小到大进行透明合成。图层原生 size 可能与放置尺寸不同。OCR 提供文字信息,实际文字编辑仍由你的应用完成。

计费

输入图和成功输出图分别按张计费。输出档位按每张图实际宽乘高决定,不只看请求中的尺寸名称。以下美元标准价与当前公开报价一致,账号及路由实际价格以模型广场为准。
  • 每张参考图或待拆分图都算输入图。底图和每个成功生成的图层各算一张输出图,按各自像素档计价;未成功输出的图不计费。
  • 图层拆分会按 max_images 预扣额度,完成后按实际输出张数结算,退回未使用的预扣部分。余额有限时可调小该上限。
  • 例如:1 张输入图,成功输出 3 张且每张均超过 2,610,000 像素,标准价为 0.0075 + 3 * 0.0345 = 0.111 美元。不同尺寸的图层可能属于不同价格档,实际扣费请查看消费日志。

常见错误

模型介绍