POST
Seedream 图片生成(官方协议)

简介

Seedream 官方入口以火山方舟 Seedream 图片生成协议对外提供服务,从火山官方 API 迁移时只需替换 Base URL。接口为同步调用:一次请求直接返回生成结果,没有任务 ID,也不需要轮询;可选 SSE 流式返回。
网关会按模型名路由到可用渠道(火山官方、天翼云、腾讯云等),不同上游的字段差异由网关内部适配,调用方统一使用本文档的官方协议。
与原 OpenAI 兼容入口 /v1/images/generations 并存,两者计费一致。需要组图、流式、图层拆分、联网搜索等 Seedream 专有能力时使用本入口;已有 OpenAI Images 客户端可以继续使用原入口。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx
Content-Type 必须为 application/json,不支持 multipart 表单。

支持模型

模型名必须以 doubao-seedream- 或 seedream- 开头。常用模型:
网关按前缀识别新模型,未列出的 doubao-seedream-* / seedream-* 模型同样可以请求;是否真正可用取决于服务端渠道配置与上游账号开通情况。各模型的参数能力以官方文档为准,请求该模型不支持的参数时会由上游返回错误并原样透传。

请求参数

string
必填
模型名称,前缀为 doubao-seedream- 或 seedream-。
string
必填
提示词。
string | string[]
参考图,支持 http(s) URL 或 base64 数据 URI(data:image/png;base64,...)。单张可传字符串,多张传数组,最多 14 张。
string
输出尺寸。可传档位(1K / 1.5K / 2K / 3K / 4K,按模型支持)或 宽x高 像素写法(如 2048x2048);Seedream 5.0 Pro 另支持 adaptive。宽高均不超过 65536。
string
默认值:"url"
url(默认,下载链接有时效)或 b64_json(Base64 内联返回)。
boolean
默认值:"true"
是否添加水印。显式传 false 会被保留。
boolean
默认值:"false"
是否开启 SSE 流式返回。
string
默认值:"disabled"
组图开关:disabled(单图)或 auto(一次生成多张)。
object
组图选项,目前为 {"max_images": N},N 为 1–15;仅在 auto 时生效,max_images 大于 1 必须搭配 auto。
object
提示词优化:{"mode": "standard"}(默认)或 {"mode": "fast"}(部分模型支持)。
string
输出编码:png 或 jpeg(5.0 系列支持)。
string
背景:transparent 或 opaque(5.0 Pro 支持)。
array
工具列表,如 [{"type": "web_search"}](联网搜索,部分模型支持)。
boolean
是否进行图层拆分(5.0 Pro 支持)。
integer
随机种子。
number
引导强度。

全局约束

  • 参考图数量 ≤ 14。
  • 组图时「参考图数量 + 生成图数量 ≤ 15」;auto 未指定 max_images 时按上限预留。
  • 未列出的字段会原样透传给上游,是否接受由上游决定。

与 OpenAI 图片协议的区别

本入口是官方 Seedream 协议,不是 OpenAI Images 协议。以下参数会被直接拒绝(HTTP 400): multipart 表单同样返回 400。

示例

文生图(最小请求)

参考图生成

单张参考图直接传字符串,多张传数组:

组图(一次生成多张)

流式返回

响应

同步响应

response_format: "b64_json" 时 data 体积较大(单图可达数 MB),注意客户端接收上限。

流式响应

Content-Type: text/event-stream,事件类型与官方一致:
  • 逐图事件可直接消费,拿到 partial_succeeded 即可开始下载该图。
  • 最终计费以 completed 事件的 usage 为准。
  • 部分渠道不支持流式:请求 stream: true 时仍可能收到 application/json 普通响应,客户端请按 Content-Type 判断,两种都要兼容。

错误处理

本地参数校验失败返回 HTTP 400,不会产生费用:
常见触发:
  • 携带 n / images / OpenAI 专有参数;
  • max_images 超出 1–15、非整数,或大于 1 却未开 auto;
  • 参考图超过 14 张,或参考图 + 生成图超过 15;
  • image 与 images 混用、数组含空字符串;
  • prompt 为空、Content-Type 非 JSON、JSON 解析失败。
上游返回的错误会原样透传(Ark 形态 {"error": {"code": ..., "message": ...}}),HTTP 状态码保留。参数不被该模型支持(如对 5.0 Pro 开流式)时由此路径报错。令牌无效、额度不足返回 401 / 403 / 429,与其他接口一致。

相关页面

OpenAI 兼容图片接口

/v1/images/generations,兼容 OpenAI Images 协议

Qwen 图片生成

DashScope 官方协议的 Qwen-Image 入口