
Seedream 5.0 Pro 圖層分解:回傳內容與計費方式
瞭解 Seedream 5.0 Pro API 圖層分解的輸入規則、尺寸選項與回傳的圖層資料,並在執行前確認每個圖層的計費方式。
Seedream 5.0 Pro 圖層分解可將一張完成的 PNG 或 JPEG 圖片分解為一張底圖與最多 16 個透明 PNG 圖層,每個圖層均附有堆疊順序、位置、名稱與說明。費用依每張回傳圖片計算,而非依請求次數計算:每個圖層各依自身像素尺寸套用圖層費率。 這項功能在 API 中稱為 layer decomposition,使用 layer_decomposition: true 開啟。1 2
ByteDance 於 2026 年 7 月 8 日發布 Seedream 5.0 Pro 時推出這項功能,並展示將海報分解為十多個圖層的範例,包含文字、主要主體與背景。主體後方原本被遮住的區域會補齊,因此移動圖層時不會留下空洞。3 本指南說明要傳送的內容、回傳結果,以及執行前如何估算費用。您可以在 Seedream 5.0 Pro 試驗區將模式切換為圖層分解,實際試用。
要傳送哪些內容
圖層分解與一般圖片生成使用相同的圖片端點,但輸入規則更嚴格。1
| 欄位 | 圖層分解規則 |
|---|---|
image | 僅限一張圖片。PNG 或 JPEG,最多 30 MB,總像素數介於 512×512 至 6000×6000(262,144 至 36,000,000),長寬比為 1:16 至 16:1。提供第二張圖片會遭拒絕。 |
prompt | 選填。指定要分離的元素,例如標題文字與鸚鵡。未提供提示詞時,模型會自行分離主要元素。 |
size | 1K、1.5K、2K 或 auto(預設)。此模式不接受指定像素尺寸。 |
output_format | jpeg(預設)或 png,僅套用至底圖。圖層一律為 PNG。 |
使用 auto 時,底圖與各圖層若原本介於 921,600 至 4,624,220 像素,便保留原始尺寸;較小的會放大至 1K,較大的會縮小至 2K,並保留各元素自身的長寬比。使用固定預設尺寸時,底圖會符合所選尺寸,各圖層則以接近該尺寸的解析度輸出。1
在 Wan API,圖層分解不能與 background: "transparent" 同時使用;圖層本身已有真正的透明背景,這種組合的請求會在收費前遭拒絕。
會回傳哪些內容
回應會先列出底圖(z_index: 0),再列出各圖層:
| 欄位 | 意義 |
|---|---|
url | PNG 圖層,或採用您所選格式的底圖。 |
size | 該張輸出圖片的像素尺寸,例如標題圖層的 1273x265。 |
z_index | 堆疊順序;0 為底圖,數字越大越靠上層。 |
bounding_box.absolute | 在底圖中的位置,以像素表示。 |
bounding_box.normalized | 相同位置,以 0–1000 的尺度表示,不受解析度影響。 |
name, description | 模型在該圖層辨識到的內容,例如官方範例中的標題文字,並附簡短說明。 |
這些欄位足以在設計工具中重建構圖:依 z_index 順序,將各張 PNG 放置在其邊界框位置。1
我們使用一張由 Seedream 5.0 Pro 生成的音樂節海報進行測試,要求分離主標題、日期列、演出者名稱、薩克斯風手與背景。在 1.5K 設定下,結果回傳一張底圖與五個圖層。左側底圖已不含文字與演奏者,並補齊了原本位於他們後方的背景。

每個圖層回傳的 name 都是英文,例如「BLUE HOUR JAZZ headline」,與提示詞一致。小元素的交付尺寸會比海報中的呈現尺寸更大:演出者名稱圖層為 2011×202 像素。
整合時有兩項行為需要留意。任何一個圖層失敗,整個請求就會失敗,不會提供部分結果。此外,若提示詞要求的圖層數超過 16 個圖層的上限,部分圖層內容可能會被省略,而非讓請求失敗。1
圖層分解如何計費
Seedream 5.0 Pro 圖層分解的官方費率依每張輸出圖片計算:不超過 261 萬像素的圖片為 US$0.0225,超過則為 US$0.045。2 在 Wan API,若每張回傳圖片都不超過 261 萬像素,價格比官方低 30%,每張為 US$0.01575。若結果包含更大的圖片(每次 2K 請求都屬於此情況),則每張圖片採官方費率。即時價格請見價格表。
由於回傳的圖層數由模型決定,費用也會隨結果而變:
| 結果 | 官方費率 | Wan API |
|---|---|---|
| 2K 底圖 + 8 個小圖層(每個皆不超過 2.61 MP) | US$0.045 + 8 × US$0.0225 = US$0.225 | US$0.225 |
| 2K 底圖 + 8 個超過 2.61 MP 的圖層 | 9 × US$0.045 = US$0.405 | US$0.405 |
auto 或 2K 的最大可能結果:17 張超過 2.61 MP 的圖片 | 17 × US$0.045 = US$0.765 | US$0.765 |
1K 或 1.5K 的最大可能結果:17 張不超過 2.61 MP 的圖片 | 17 × US$0.0225 = US$0.3825 | US$0.26775 |
即使是 2K 請求,小元素仍採較低級距:官方範例中的 1273×265 標題圖層約為 34 萬像素。1
在上述測試中,六張圖片都不超過 261 萬像素:底圖為 1344×1792(約 241 萬像素),最大圖層為 1216×1662。依官方費率計算為 6 × US$0.0225 = US$0.135,而我們的閘道實際收費與依回傳尺寸預期的金額完全一致。依 Wan API 價格計算,相同結果為 6 × US$0.01575 = US$0.0945。
在 Wan API,開始請求前,您的餘額必須足以支付最大可能結果的費用,之後僅對實際回傳的底圖與圖層收費。選擇 1K 或 1.5K 可將費用上限從 US$0.765 降至 US$0.26775,且通常能讓每張圖片都落在享有優惠的較低級距。
確認方案如何計算圖層用量
為這項功能購買圖片方案前,請先閱讀計費條款。在 2026 年 8 月的一篇貼文中,一位 BytePlus 客戶表示,自己為了圖層分解購買 Seedream 5.0 Pro 圖片方案,卻發現圖層請求是依隨用隨付費率逐層計費,未使用方案內的圖片額度;客服承認這項差異「可能未清楚說明」。4 無論使用哪種服務,請先確認圖層是否計入套裝方案額度,以及每個圖層的價格。
在 Wan API 執行
使用您的 API 金鑰,將請求送至 POST https://api.wanapi.app/v1/images/generations,只送出一次。所有圖層準備完成後,便會回傳結果。
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": "Separate the title text, the parrot and the background",
"image": "https://example.com/poster.png",
"layer_decomposition": true,
"size": "1.5K"
}'請在 30 天內下載圖層。Seedream 5.0 Pro API 指南列出所有欄位、完整回應結構與錯誤碼。
什麼情況適合使用圖層分解
已有完成的圖片,且需要可編輯的部分時,適合使用圖層分解:例如替換海報標題、移動產品圖片,或將平面設計交給使用圖層工作的設計者。想要新圖片時,請使用一般圖片生成或參考圖片編輯;若只需要透明背景上的單一主體,而非完整的圖層堆疊,請使用透明背景模式。
從試驗區開始:上傳一張圖片、選擇圖層分解,並在生成前確認預估費用。
資料來源
- BytePlus ModelArk: image generation API,Seedream 5.0 Pro 的
layer_decomposition、size、output_format與回應欄位。確認日期:2026 年 10 月 23 日。
- BytePlus ModelArk: model pricing,Seedream 5.0 Pro 單張圖片與圖層分解費率。確認日期:2026 年 10 月 23 日。
- ByteDance Seed: Introducing Seedream 5.0 Pro,2026 年 7 月 8 日發布文章中的圖層分解章節。確認日期:2026 年 10 月 23 日。
- Reddit r/generativeAI: "PSA: Why BytePlus Seedream 5.0 Pro's Layer Separation marketing felt misleading",客戶於 2026 年 8 月 31 日發布的經驗分享。確認日期:2026 年 10 月 23 日。
更多文章

Wan 3.0 API 指南:模型、輸入與第一支影片
比較 Wan 3.0、Wan 3.0 Prime、Wan 3.0 Pro 與 Wan 3.0 Prime Pro 的 API 輸入與影片輸出規格,準備素材並規劃首次整合測試。


Seedance 2.5 與 2.0:哪款適合您的場景?
比較 Seedance 2.5 與 2.0 的影片長度、參考素材上限與範例設定,規劃條件一致的測試,不預設畫質或速度的優勝者。


Seedance 2.0 Fast 與 Mini:該測試哪款?
比較 Seedance 2.0 Fast 與 Mini 的限制、參考影片計費及範例場景。以相同創作說明測試品質、耗時與可用鏡頭成本。

Wan API 最新消息
服務更新與模型消息
訂閱以接收模型消息、服務更新與 API 整合資訊。