doubao-seedream-5.0、doubao-seedream-5.0-lite、doubao-seedream-5.0-pro 三个模型,支持文生图、图生图。
所有请求都经由 GregAPI 转发到火山方舟,不需要自行签名,只需在 Header 中携带 GregAPI API Key。
模型总览
各模型说明
doubao-seedream-5.0:Seedream 5.0 基础版,支持联网检索,增强知识广度、参考一致性与专业场景生成质量;支持文生图、图生图、文生组图、多图生组图、流式输出。doubao-seedream-5.0-lite:Seedream 5.0 轻量版,速度与成本更优,能力与基础版一致(组图、流式、联网搜索)。doubao-seedream-5.0-pro:面向高精度创作,支持交互编辑(坐标/框选/箭头精准定位)与图层拆分(1 张底图 + 最多 16 个图层);暂不支持文生组图、流式输出与联网搜索。
接口说明
端点
请求头
doubao-seedream-* 模型名绑定到 Doubao / VolcArk 渠道(ChannelTypeVolcArk),即可通过统一的 OpenAI 风格接口访问。
请求参数
基础参数(OpenAI 兼容)
stream=true、tools、sequential_image_generation 和 sequential_image_generation_options 等组图/流式参数仅对 5.0 与 5.0-lite 等支持组图、流式的模型生效;5.0-pro 不支持这些参数。
火山方舟专用参数
Base64 参考图格式
image 中的每张参考图必须是公网可访问的图片 URL,或以下完整 Data URI:
- JPEG:
data:image/jpeg;base64,<完整Base64> - PNG:
data:image/png;base64,<完整Base64>
/9j/... 或 iVBOR... 这样的裸 Base64,会被当作 URL 解析,可能返回 HTTP 400、InvalidParameter。response_format="b64_json" 只控制输出格式,不会为输入的 image 自动补前缀。
响应格式
非流式响应
Base64 响应(response_format=b64_json)
b64_json 是不带 Data URI 前缀的裸 Base64。若要将生成结果再次作为 image 输入,需要补上 data:image/jpeg;base64, 或 data:image/png;base64, 前缀。
使用示例
文生图
doubao-seedream-5.0 / doubao-seedream-5.0-lite,只需替换 model(与可选 size 档位)。
图生图(Base64 Data URI)
将<完整JPEG图片Base64> 替换为 JPEG 图片的完整 Base64,保留前面的 data:image/jpeg;base64,。PNG 图片改用 data:image/png;base64,。
data[0].b64_json 读取并解码图片。单图也可将 image 写成一个完整 Data URI 字符串。
常见问题
如何选择模型?
- 需要高精度编辑、精准定位、图层拆分:用
doubao-seedream-5.0-pro。 - 需要组图、流式输出、联网搜索,或追求更强知识广度与一致性:用
doubao-seedream-5.0或doubao-seedream-5.0-lite(lite 成本更低)。
图片 URL 有效期多久?
生成的图片 URL 通常在 24 小时内有效,请在有效期内下载并保存到自己的存储。如何去除水印?
在请求体中设置"watermark": false 即可关闭模型水印(前提是当前模型与账号配置允许关闭)。
图生图时图片传不上去怎么办?
- 确认
image字段使用公网可访问的 HTTPS URL,或完整 Data URI(如data:image/jpeg;base64,<完整Base64>); - 出现
InvalidParameter/invalid url specified时,检查是否误传了裸 Base64,并补上与实际格式匹配的前缀; response_format="b64_json"是输出设置,不能代替输入图片所需的 Data URI 前缀;- 图片较大时建议预先压缩,避免超过上游大小限制。
计费说明
- 按成功生成的图片张数计费;
- 生成失败的图片通常不计费(以上游账单为准);
- 具体价格请在后台「模型价格管理」中查看 Doubao Seedream 相关条目。