Skip to main content

概览

  • 模型:Seedream 4.0(seedream-4)与 Seedream 4.5(seedream-4.5),质量 4.5 更高,速度略慢。
  • 能力:文生图、多图融合(最多 14 张)、批量生成(最多 15 张输出)。
  • 分辨率:1K / 2K / 4K(默认 2K);新增 aspect_ratio 控制画幅。
  • 计费:Seedream 4.0 每张输出 30 积分,Seedream 4.5 每张输出 40 积分;分辨率不影响价格,输入参考图不收费。总输入图 + 输出张数 ≤ 15。
  • 接口:POST /api/v1/task/submit/seedream-4 与 /seedream-4.5,查询统一用 /api/v1/task/status。
Breaking Change(2025-12-10):size 字段已统一为 resolution,新增 aspect_ratio。请尽快迁移以避免校验失败。

认证

请求头加入:

模型对比

每张输出分别为 30/40 积分(1000 积分 = $1)。分辨率和输入参考图数量不改变价格;batch_size 按输出张数倍增。

提交任务

接口:POST /api/v1/task/submit/seedream-4 或 /seedream-4.5,Content-Type: application/json
  • 宽高比选项:1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9。Seedream 会在 prompt 末尾自动追加比例提示。
  • 约束:输入图片数量 + 输出图片数量 <= 15,超出将校验失败。

请求示例(文生图,Seedream 4.0)

请求示例(高画质文生图,Seedream 4.5)

请求示例(多图融合)

请求示例(批量生成)

成功响应

任务查询

接口:POST /api/v1/task/status
客户端可见状态:PENDING、QUEUED、PROCESSING、REVIEW_REQUIRED、SUCCEEDED、FAILED。详见任务状态 API 参考。

迁移指引(size → resolution + aspect_ratio)

旧版(已废弃):
新版(当前):

技术说明

  • 画幅实现:Seedream 会在 prompt 末尾追加 aspect_ratio: <ratio> 文本,自动匹配对应像素尺寸(如 16:9 → 2560x1440)。
  • 同步转异步:Seedream 原生同步(约 6-7 秒),平台会自动包装为异步任务,提交后返回 task_id,轮询 /task/status 获取结果。

最佳实践

  • 分辨率:草稿用 1K/2K,定稿用 4K。
  • 画幅:1:1 社媒头像/封面,16:9 横屏,9:16 竖屏,21:9 电影感宽屏。
  • 批量:用 batch_size 生成变体,记得确保输入 + 输出张数 ≤ 15。
  • 多图融合:控制在 1-3 张核心参考图,超过 8 张时注意风格一致性与尺寸;输入参考图不额外收费。
  • 种子:固定 seed 可复现,-1 或省略则随机。
  • 水印:默认关闭,合规场景可开启。