Wan API 文件Seedream 5.0 Pro
Seedream 5.0 Pro API 參考文件：文字生成圖片、參考圖片編輯、圖層分解、透明 PNG、請求欄位、回應與價格。
Seedream 5.0 Pro 可依提示詞生成一張圖片、編輯或結合最多 10 張參考圖片，也能將單張圖片分解為一張底圖與最多 16 個透明圖層。輸出可選擇 1K、1.5K、2K 或指定像素尺寸。模型詳情與試驗區。
連接 Wan API
使用 https://api.wanapi.app 作為 API 基底 URL。在 API 金鑰設定中建立選用 Wan 模型系列的金鑰，並以 Authorization: Bearer YOUR_API_KEY 傳送。請將金鑰保存在伺服器端。試驗區使用您的網站登入工作階段，費用從同一帳號的餘額扣除。
GET /v1/models 會列出您的金鑰可使用的模型。Seedream 5.0 Pro 使用 OpenAI Images API：POST /v1/images/generations 接受 JSON，POST /v1/images/edits 則接受 JSON 或 multipart 上傳。圖片準備完成後即回傳請求結果，無須輪詢任務。
| 設定 | Seedream 5.0 Pro |
|---|---|
| 模型 ID | bytedance/seedream-5.0-pro |
size | 1K、1.5K、2K（預設），或使用 WIDTHxHEIGHT 指定尺寸，總像素數須介於 921,600–4,624,220，長寬比須介於 1:16 至 16:1。 |
image | 最多 10 張參考圖片。 |
| 輸出 | 每次請求一張圖片；使用 layer_decomposition 時則為一張底圖與最多 16 個圖層。 |
生成圖片
請在伺服器上將 WAN_API_KEY 設為您的金鑰。每次請求只送出一次；生成通常會在一分鐘內完成，因此請將用戶端逾時時間設為至少四分鐘。
curl https://api.wanapi.app/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedream-5.0-pro",
"prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
"size": "1K"
}'回應採用 OpenAI Images 格式。以下範例值僅供示意：
{
"created": 1792022400,
"data": [
{
"url": "https://cdn.example.com/image-1.jpg",
"size": "1024x1024",
"output_format": "jpeg"
}
],
"usage": {
"generated_images": 1
}
}圖片 URL 的有效期限為 30 天。若需保留更久，請自行儲存檔案。傳送 "response_format": "b64_json"，即可另外在 b64_json 中取得每張圖片的 Base64 資料。
Seedream 5.0 Pro 價格
每張生成圖片依自身像素尺寸計費，價格比官方費率低 30%：不超過 261 萬像素（1K 與 1.5K）採較低費率，更大的圖片採較高費率。第一張參考圖片免費，每多一張參考圖片會加收參考圖片費用。在圖片生成前就遭拒絕的請求不收費。
| 計費項目 | 官方價格 | Wan API 價格 |
|---|---|---|
| 不超過 2.61 MP 的圖片（1K、1.5K） | US$0.045 | 無法取得 |
| 超過 2.61 MP 的圖片（2K） | US$0.09 | 無法取得 |
| 圖層分解，每張回傳圖片皆不超過 2.61 MP | US$0.0225 | 無法取得 |
| 圖層結果含較大圖片：其中每張不超過 2.61 MP 的圖片 | US$0.0225 | 無法取得 |
| 圖層結果含較大圖片：其中每張超過 2.61 MP 的圖片 | US$0.045 | 無法取得 |
| 第一張之後的每張參考圖片 | US$0.003 | 無法取得 |
Wan API 的 Seedream 5.0 Pro 圖片、額外參考圖片，以及 1K 或 1.5K 圖層分解，價格均比官方每張圖片費率低 30%。圖層結果若包含超過 2.61 MP 的圖片，則採官方費率。
圖層分解會對底圖與每個回傳圖層計費。若每張回傳圖片都不超過 2.61 MP，各張皆採優惠圖層費率；只要其中一張較大，所有圖片便各依自身尺寸採官方圖層費率。預估費用涵蓋最多 17 張圖片。
官方價格： BytePlus ModelArk. 確認日期：2026-10-23。
圖層分解會對底圖與每個回傳圖層計費。若每張回傳圖片都不超過 261 萬像素，每張價格比官方圖層費率低 30%。只要其中一張更大（2K 一定屬於此情況），所有圖片便各依自身尺寸採官方圖層費率。您的餘額須足以支付最多 17 張圖片的費用；僅對實際回傳的圖片收費。
請求欄位
請傳送 JSON 物件。model 為必填；除非 layer_decomposition 為 true，否則 prompt 也為必填。不明欄位會遭拒絕。
| 欄位 | 型別 | 規範 |
|---|---|---|
model | string | 必填：bytedance/seedream-5.0-pro。 |
prompt | string | 要生成的內容，或圖層分解時要分離的元素。支援英文、中文與其他語言；保持在約 600 個英文單字以內可獲得最佳結果。 |
image | string 或 string[] | 最多 10 張參考圖片，使用 HTTP(S) URL 或 data:image/<format>;base64,...，其中格式名稱須為小寫。格式：JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF；每張最多 30 MB；長寬比為 1:16 至 16:1。 |
size | string | 圖片生成：1K、1.5K、2K（預設）或 WIDTHxHEIGHT。圖層分解：1K、1.5K、2K 或 auto（預設）。 |
layer_decomposition | boolean | 預設為 false。true 會將一張 PNG 或 JPEG 圖片分解為一張底圖與最多 16 個圖層，且必須只提供一張圖片。 |
optimize_prompt_options | object | {"mode": "standard"}（預設）或 {"mode": "fast"}。快速模式可縮短生成時間，但品質略低。 |
output_format | string | jpeg（預設）或 png。圖層分解時，此欄位決定底圖格式；圖層一律為 PNG。 |
background | string | opaque（預設）或 transparent。透明背景必須只使用一張具有 Alpha 色版的輸入圖片，並採 PNG 輸出；不能與圖層分解同時使用。 |
watermark | boolean | 預設為 true：加入小型 AI 生成標籤。傳送 false 即可移除。 |
nsfw_checker | boolean | 預設為 true，維持內容檢查開啟。false 會略過此檢查傳送請求；價格相同。 |
response_format | string | url（預設）或 b64_json。 |
n | integer | 選填；必須為 1。 |
此模型不支援 stream、sequential_image_generation、tools、seed、guidance_scale 與 mask，傳送這些欄位會遭拒絕。
編輯與結合參考圖片
傳送一張圖片並附上編輯指示，或傳送多張圖片進行結合：
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
"image": [
"https://example.com/bottle.png",
"https://example.com/table.jpg"
],
"size": "2K",
"output_format": "png"
}POST /v1/images/edits 接受相同欄位。使用 multipart 時，請透過 image 或 image[] 欄位上傳檔案，並將 optimize_prompt_options 以 JSON 字串傳送。
圖層分解
{
"model": "bytedance/seedream-5.0-pro",
"prompt": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "2K"
}回應會先列出底圖。每個圖層另附堆疊順序、位置與說明：
{
"created": 1792022400,
"data": [
{ "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
{
"url": "https://cdn.example.com/image-2.png",
"size": "1273x265",
"output_format": "png",
"z_index": 1,
"bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
"name": "Title text",
"description": "Yellow serif title text"
}
],
"usage": { "input_images": 1, "generated_images": 2 }
}任何一個圖層失敗，整個請求就會失敗。若提示詞要求的圖層數超過上限，部分圖層內容可能會被省略。
錯誤
錯誤採用 OpenAI 錯誤封裝格式 {"error": {"message", "type", "code"}}。
| HTTP | code | 意義 |
|---|---|---|
| 400 | invalid_request 或驗證訊息 | 不支援某個欄位或組合。請修正請求；未收取任何費用。 |
| 400 | content_policy_violation | 提示詞、輸入圖片或輸出遭內容政策拒絕。未收取任何費用。 |
| 402 | insufficient quota | 再次送出前請先儲值。 |
| 429 | rate_limited | 請求過多。請稍後再試。 |
| 502 | submission_unknown | 未收到結果，且請求未收費。再次送出前，請先檢查用量記錄。 |
| 503 | upstream_unavailable | 圖片生成服務暫時無法使用；請求未收費。 |
請求逾時後，未先檢查用量記錄前，切勿自動重試。