图像生成
Seedream 系列
字节跳动 Seedream 图像模型:文生图与参考图编辑,按张固定价
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、4kseedream-4.5:2k、4kseedream-5.0-lite:2k、3k、4kseedream-5.0-pro:1k、1.5k、2k,默认1.5kseedream-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:14:33:416:99:163:22:32:11:221:9 seedream-4.0与seedream-4.5额外支持9:21auto由模型按输入决定画幅:seedream-4.0、seedream-4.5、seedream-5.0-lite只在edit下接受它;seedream-5.0-pro与seedream-5.0-flash两个动作都接受,且默认画幅就是auto