BytePlus Seedream + SeedEdit 影像生成

Seedream 5.0 Pro / 5.0 Lite / 4.5 / 4.0 文生圖 + 圖生圖 + 多圖連續生成, 相容 OpenAI SDK

POST /v1/images/generations

鉴权: {'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` 欄位被忽略

请求体

`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)

响应

200 — 成功返回生成影像
400 — 請求參數錯誤 (size 不支援 / SeedEdit 漏傳 image / 內容稽核拒等)
402 — 餘額不足

调用示例

# 文生图 (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 文件