简介
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 结果。
计费区分参考图和成功生成的输出图,每张输出图按实际像素单独定档;图层拆分的底图和每个图层分别计费。两版模型的参考图价格、输出价格和拆分价格不同,详细字段与计费规则见对应模型文档。
查看最新模型与价格
最新模型列表、价格与能力以控制台模型广场为准。
接入流程
- 获取 API Key,设置网关地址和 Bearer 认证。
- 选择所需模型,并按场景进入文生图或图生图文档。
- 复制示例中的完整 JSON 请求 body;生成时提供
model、prompt,图生图同时提供image。图层拆分设置layer_decomposition: true,并传入 1 张图片,prompt可省略。 - 发起同步请求,读取
data[].url下载图片,或将data[].b64_json解码保存;通过usage查看用量,图层拆分时按z_index和bounding_box还原图层。
