跳转到主要内容

简介

Seedream 是字节跳动的图像模型系列,可用于文本生成图片、图片编辑、交互编辑、多参考图融合与图层拆分。目前该系列文档收录 Seedream 5.5 Pro 和 Seedream 5.0 Pro,具体参数与调用示例按文生图、图生图场景分别提供。 通过 GravitexAI 网关统一同步调用:
  • Base URL:https://api.gravitex.ai
  • 认证:Authorization: Bearer sk-xxxxxxxxxx
  • Content-Type:文生图、图生图均使用 application/json

该系列文档支持的模型

需要文生透明图、拆分数量配置或富文本 OCR 时,可选择 Seedream 5.5 Pro。5.0 Pro 的透明图模式仅支持输入 1 张带透明通道的参考图;5.5 Pro 支持文生透明图,也支持最多 10 张无需透明通道的参考图。两版默认输出格式分别为 jpeg、png,切换模型时请按对应文档检查参数。

按场景查看示例

支持的接口

两个端点由平台转发到上游同一个生图接口。本站文生图、图生图示例统一使用 /v1/images/generations:不传 image 为文生图,传入图片 URL 或 Base64 字符串(或数组)为图生图;普通生成最多支持 10 张参考图,图层拆分只能传 1 张图片。

响应与计费

接口同步返回图片列表 data 和 usage 用量统计。response_format 默认为 url,通过 data[].url 获取图片地址,24 小时内有效,收到后请及时下载保存;传入 b64_json 时,通过 data[].b64_json 获取 Base64 图片数据。 普通生成单次输出 1 张图片;图层拆分返回 1 张底图和多个图层,并提供图层顺序、边界框等信息。Seedream 5.5 Pro 开启 layer_decomposition_options.text_recognition 后,还会为规整文字图层返回富文本 OCR 结果。 计费区分参考图和成功生成的输出图,每张输出图按实际像素单独定档;图层拆分的底图和每个图层分别计费。两版模型的参考图价格、输出价格和拆分价格不同,详细字段与计费规则见对应模型文档。

查看最新模型与价格

最新模型列表、价格与能力以控制台模型广场为准。

接入流程

  1. 获取 API Key,设置网关地址和 Bearer 认证。
  2. 选择所需模型,并按场景进入文生图或图生图文档。
  3. 复制示例中的完整 JSON 请求 body;生成时提供 model、prompt,图生图同时提供 image。图层拆分设置 layer_decomposition: true,并传入 1 张图片,prompt 可省略。
  4. 发起同步请求,读取 data[].url 下载图片,或将 data[].b64_json 解码保存;通过 usage 查看用量,图层拆分时按 z_index 和 bounding_box 还原图层。