BytePlus Seedream + SeedEdit 图像生成

Seedream 5.0 Pro / 5.0 Lite / 4.5 / 4.0 文生图 + 图生图 + 多图连续生成, 兼容 OpenAI SDK

POST /v1/images/generations

Auth: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

BytePlus Seedream + SeedEdit 图像生成系列 (BytePlus ModelArk 旗下, 字节跳动海外品牌). > 📖 官方文档: https://docs.byteplus.com/en/docs/ModelArk/1824121 ## 模型矩阵 (新版本优先) | 模型 | 主推场景 | i2i? | 多图参考 | sequential | |---|---|---|---|---| | `dola-seedream-5-0-pro-260628` ⭐ | **专业版 Pro** (t2i/i2i/组图/联网搜索), 仅 1K/2K | ✅ | ✅ 多张 | — (仅单图输出) | | `seedream-5-0-lite-260128` | **新一代主推**, 跟 4.5 schema 100% 兼容, 性价比最高 | ✅ | ≤14 张 | ✅ max 15 | | `seedream-4-5-251128` | 4K 主推 + 多图连续生成 | ✅ | ≤14 张 | ✅ max 15 | | `seedream-4-0-250828` | 基础文生图 + 图生图 | ✅ | ≤3 张 | — | ## 支持的 size - `1K` / `2K` (默认) / `4K` — 主要档位 - `auto` — 由模型自动选择 - `WxH` 自定义 (1024-4096, 16 倍数), 仅 4.0+ 支持 - 注: `dola-seedream-5-0-pro` 仅 1K / 2K, 单图输出 (不支持组图 sequential) ## 字段差异 (按 model) - **t2i 模型** (3.0-t2i / 4.0 / 4.5 / 5.0-lite): `prompt` 必填, `image` 可选 - **SeedEdit 3.0 (i2i)**: **`image` 必填** (单张 URL), `prompt` 是编辑指令 - **4.5 / 5.0-lite 专有**: `sequential_image_generation` + `sequential_image_generation_options.max_images` 一次返多张 - **3.0 / 4.0**: 不支持 sequential ## response 格式返回 24h 有效 CDN URL (`data[].url`), 客户需自行下载存储到本地或对象存储. ## 用法提示 - 客户端 OpenAI Python / Node SDK 调 `client.images.generate(model="seedream-5-0-lite-260128", prompt="...", size="2K")` 即可 - watermark 默认 `true` (上游默认带水印, 左下角), 传 `watermark: false` 关闭 - 单张图体积可达 1-3 MB (取决于 size), URL 24h 内下载到本地即可 - 不支持 streaming, `stream` / `partial_images` 字段被忽略

Request body

`model`	string	required	模型 ID, 4 个可选 (新版本优先): `dola-seedream-5-0-pro-260628` ⭐ / `seedream-5-0-lite-260128` / `seedream-4-5-251128` / `seedream-4-0-250828`
`prompt`	string	required	文本描述 (t2i) 或编辑指令 (SeedEdit), 最长 4000 字符
`image`	string \| string[]		参考图 URL (i2i). `dola-seedream-5-0-pro` 支持单/多张 (首张免费, 第 2 张起计费); `seedream-4.5 / 5.0-lite` 支持 ≤14 张数组; `seedream-4.0` 支持单张或 ≤3 张数组
`size`	string		图像规格. 主档位 1K/2K/4K, 或自定义 `WxH` (1024-4096 像素, 16 倍数). `dola-seedream-5-0-pro` 仅 1K/2K (按分辨率分档计费)
`response_format`	string		返回格式. 固定 `url` (返 24h 有效 CDN URL)
`watermark`	boolean		是否带水印 (默认 `true`, 左下角). 商业用途传 `false` 关闭
`seed`	integer		随机种子, 用于复现相同结果 (0 ~ 2^31-1)
`sequential_image_generation`	string		多图连续生成模式 (仅 `seedream-5-0-lite` / `seedream-4-5`). `auto` 启用后会返多张图
`sequential_image_generation_options`	object		sequential 配置, 仅 `sequential_image_generation=auto` 时生效
`max_images`	integer		单次返图最大张数 (1-15)

Responses

200 — 成功返回生成图像
400 — 请求参数错误 (size 不支持 / SeedEdit 漏传 image / 内容审核拒等)
402 — 余额不足

Example

# 文生图 (Seedream 5.0 Pro, 仅 1K/2K)
curl https://api.router.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "雪夜中的东京街头, 霓虹灯倒影在湿润的柏油路上, 电影感",
    "size": "2K",
    "watermark": false
  }'

# 图生图 i2i (Seedream 5.0 Pro, 单/多参考图; 首张参考图免费, 第 2 张起计费)
curl https://api.router.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "把参考图变成赛博朋克风格海报",
    "image": ["https://your-cdn.com/ref1.jpg", "https://your-cdn.com/ref2.jpg"],
    "size": "1K"
  }'

API reference