Skip to main content
POST
Seedream 系列
Seedream 是字节跳动的图像生成与编辑模型系列。本页覆盖当前可用的五个模型,它们共用同一套请求参数、同一个任务接口和同一种计费方式(按成功出图的固定张价),差别在分辨率档、画幅数量和各自的专有参数——换模型只改 model。

快速开始

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果,也可以用 Prefer: wait 在一次调用里等待,或配置 Webhook。

请求参数

string
必填
五选一:seedream-4.0、seedream-4.5、seedream-5.0-lite、seedream-5.0-pro 或 seedream-5.0-flash。
string
默认值:"generate"
  • generate:根据文字生成图片
  • edit:基于参考图改写;必须提供 image_urls
string
必填
图片描述或编辑指令,中英文均可。
string[]
参考图片 URL 数组。edit 时必填:seedream-5.0-flash 最多 10 张,其余模型最多 1 张;generate 不接受参考图。
string
默认值:"1:1"
画面比例。五个模型共通 10 种:1:1、4:3、3:4、16:9、9:16、3:2、2:3、2:1、1:2、21:9。seedream-4.0 与 seedream-4.5 额外支持 9:21。auto 表示由模型决定比例。seedream-5.0-pro 与 seedream-5.0-flash 的默认值是 auto,两个动作都接受;其余三个模型默认 1:1,且只在 edit 下接受 auto。
string
默认值:"2k"
输出分辨率,各模型档位不同:
  • seedream-4.0:1k、2k、4k
  • seedream-4.5:2k、4k
  • seedream-5.0-lite:2k、3k、4k
  • seedream-5.0-pro:1k、1.5k、2k,默认 1.5k
  • seedream-5.0-flash:1k、1.5k、2k,默认 1k
integer
默认值:"1"
生成数量。seedream-4.0 与 seedream-4.5 的文生图每次只出 1 张,编辑时参考图张数 + n 不超过 15(带 1 张参考图时 n 最多 14);seedream-5.0-lite 文生图取 1–15,编辑时同样是参考图张数 + n 不超过 15;seedream-5.0-pro 与 seedream-5.0-flash 取值 1。n 大于 1 时进入组图模式:n 是本次最多生成的张数,实际返回可能少于 n,按实际返回的张数计费。
boolean
默认值:"false"
是否在输出图片中添加水印。
string | object
提示词优化模式,只有 seedream-4.0 与 seedream-4.5 支持,默认 standard。
  • standard:质量优先,耗时更长
  • fast:速度优先
seedream-4.0 直接传字符串("fast");seedream-4.5 传对象({"mode": "fast"})。
string
默认值:"jpeg"
输出图片格式,jpeg 或 png。只有 seedream-5.0-lite、seedream-5.0-pro 与 seedream-5.0-flash 支持。
string
默认值:"opaque"
背景:opaque 不透明 / transparent 透明。只有 seedream-5.0-pro 与 seedream-5.0-flash 支持,且透明背景仅在单张带 alpha 通道的输入图做图生图、同时 output_format 为 png 时可用。
通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。 本系列不接受 seed、quality、negative_prompt 和 mask_url。以上之外的参数会返回 400,不计费。

限制

计费

按成功出图的固定张价结算。seedream-4.0、seedream-4.5、seedream-5.0-lite、seedream-5.0-flash 四个模型的各档分辨率同价,seedream-5.0-pro 的 2k 比 1k / 1.5k 贵一档。 单价见 GET /v1/models 返回的 price_config,或控制台「模型市场」。单次调用的实际花费见任务响应里的 cost——整数 quota,500,000 quota = 1 USD,不是美元。 generate 与 edit 同价,参考图不加价,画幅、输出格式与提示词长度都不影响价格——单张价格只由分辨率决定,总价 = 张价 × 实际返回的张数。提交时按 n 张冻结额度;组图模式下实际返回少于 n 张时,多冻结的部分在任务完成时退回。resolution 不在该模型支持的档位内时,按其兜底价结算(等于该模型的基础档价)。 只有成功出图才计费。任务失败、取消,或没有返回可用图片时,全额退款。

响应

任务完成
result.images 返回生成的图片,expires_at 是该链接的失效时间戳。完整字段说明见查询任务状态。

可用模型

五个模型都支持文生图与参考图编辑,都接受 watermark。seedream-5.0-flash 编辑时最多接受 10 张参考图,其余模型 1 张;seedream-4.0、seedream-4.5、seedream-5.0-lite 可以一次出多张(见 n)。
  • 10 种共通画幅:1:1 4:3 3:4 16:9 9:16 3:2 2:3 2:1 1:2 21:9
  • seedream-4.0 与 seedream-4.5 额外支持 9:21
  • auto 由模型按输入决定画幅:seedream-4.0、seedream-4.5、seedream-5.0-lite 只在 edit 下接受它;seedream-5.0-pro 与 seedream-5.0-flash 两个动作都接受,且默认画幅就是 auto

相关文档