Seedream 5.0 Pro のレイヤー分解：出力内容と課金の仕組み

Seedream 5.0 Pro のレイヤー分解は、完成した PNG または JPEG 画像を 1 枚受け取り、ベース画像と最大 16 枚の透過 PNG レイヤーを返します。各レイヤーには重ね順、位置、名前、説明が含まれます。課金はリクエスト単位ではなく、返された画像単位です。各レイヤーには、それぞれのピクセル数に応じたレイヤー単価が適用されます。 API ではこの機能を layer decomposition と呼び、layer_decomposition: true で有効にします。1 2

ByteDance は、2026 年 7 月 8 日の Seedream 5.0 Pro リリースでこの機能を発表し、文字、主な被写体、背景など、10 を超えるレイヤーに分解したポスターを紹介しました。被写体に隠れていた領域は補完されるため、レイヤーを移動しても穴が残りません。3 このガイドでは、送信する内容、返される内容、実行前の費用の見積もり方を説明します。Seedream 5.0 Pro Playground でモードをレイヤー分解に切り替えると試せます。

送信する内容見出しのリンクをコピー

レイヤー分解は通常の画像生成と同じエンドポイントを使用しますが、入力条件はより厳しくなります。1

auto は、ベース画像と各レイヤーのピクセル数が 921,600〜4,624,220 の範囲内なら元のサイズを維持し、それより小さい画像は 1K に拡大、大きい画像は 2K に縮小します。各要素のアスペクト比は保持されます。固定のプリセットでは、ベース画像は選択したサイズに、各レイヤーはそれに近い解像度になります。1

Wan API では、レイヤー分解と background: "transparent" は併用できません。各レイヤーはすでに透明部分を保持しており、併用したリクエストは課金前に拒否されます。

返される内容見出しのリンクをコピー

レスポンスではベース画像（z_index: 0）が最初に並び、その後に各レイヤーが続きます。

これらのフィールドを使って、デザインツールで構成を再現できます。各 PNG をバウンディングボックスの位置に、z_index の順序で配置します。1

Seedream 5.0 Pro で生成したフェスティバルのポスターで試し、見出し、日付の行、出演者名、サックス奏者、背景の分離を指定しました。1.5K ではベース画像と 5 枚のレイヤーが返されました。左のベース画像からは文字と奏者が取り除かれ、その背後の背景が補完されています。

各レイヤーの name は、プロンプトに合わせて「BLUE HOUR JAZZ headline」のような英語で返されました。小さな要素は、ポスター内での表示サイズより大きく出力されます。出演者名のレイヤーは 2011×202 ピクセルでした。

組み込む際には二つの動作を把握しておく必要があります。一つでもレイヤーの生成に失敗すると、リクエスト全体が失敗し、一部だけの結果は返されません。また、プロンプトで上限の 16 レイヤーを超える数を指定すると、リクエストが失敗する代わりに、一部のレイヤー内容が省かれる場合があります。1

レイヤー分解の料金見出しのリンクをコピー

Seedream 5.0 Pro のレイヤー分解の公式料金は出力画像 1 枚ごとで、261 万ピクセル以下なら $0.0225、それより大きい画像は $0.045 です。2 Wan API では、返された画像がすべて 261 万ピクセル以下の場合、30% 引きの 1 枚あたり $0.01575 になります。すべての 2K リクエストのように、大きい画像を含む結果には、各画像の公式料金が適用されます。現在の料金は料金表で確認できます。

返すレイヤー数はモデルが決めるため、費用は結果によって変わります。

2K のリクエストでも、小さな要素には低い単価が適用されます。公式例の 1273×265 のタイトルレイヤーは、約 34 万ピクセルです。1

上の実行結果では、6 枚の画像がすべて 261 万ピクセル以下でした。ベース画像は 1344×1792（約 241 万ピクセル）で、最大のレイヤーは 1216×1662 でした。公式料金では 6 × $0.0225 = $0.135 で、ゲートウェイでの実際の課金額は、返されたサイズから計算した額と完全に一致しました。Wan API の料金では、同じ結果は 6 × $0.01575 = $0.0945 です。

Wan API では、リクエスト開始前に最大の結果をまかなえる残高が必要です。その後、実際に返されたベース画像とレイヤーの分だけを支払います。1K または 1.5K を選ぶと、上限は $0.765 から $0.26775 に下がり、通常はすべての画像が割引対象の低い料金区分に収まります。

プランでのレイヤーの数え方を確認する見出しのリンクをコピー

この機能のために画像プランを購入する前に、課金条件を確認してください。2026 年 8 月の投稿で、BytePlus の利用者は、レイヤー分解のために Seedream 5.0 Pro の画像プランを購入したところ、レイヤーのリクエストではプランの画像枠が消費されず、レイヤーごとに従量料金が課金されたと報告しています。サポートは、この違いが「明確に伝えられていなかった可能性がある」と認めました。4 どのサービスを使う場合も、レイヤーがパッケージの対象に含まれるか、1 レイヤーあたりいくらかを確認してください。

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 ガイドには、すべてのフィールド、レスポンス全体の形式、エラーコードを掲載しています。

レイヤー分解が適している場面見出しのリンクをコピー

完成した画像があり、編集可能なパーツが必要な場合に使います。たとえば、ポスターの見出しを差し替える、商品の写真を移動する、レイヤーを使う担当者に 1 枚に統合されたデザインを渡すといった用途です。新しい画像を作りたい場合は通常の画像生成か参照画像による編集を使います。レイヤー一式ではなく、透明背景に一つの被写体が必要な場合は透明背景モードを使ってください。

まずは Playground で画像を 1 枚アップロードし、レイヤー分解を選び、生成前に見積もりを確認してください。

出典見出しのリンクをコピー

1. BytePlus ModelArk: image generation API — Seedream 5.0 Pro の layer_decomposition、size、output_format とレスポンスのフィールド。2026 年 10 月 23 日確認。

2. BytePlus ModelArk: model pricing — Seedream 5.0 Pro の単一画像生成とレイヤー分解の料金。2026 年 10 月 23 日確認。

3. ByteDance Seed: Introducing Seedream 5.0 Pro — 2026 年 7 月 8 日付のリリース記事、レイヤー分解のセクション。2026 年 10 月 23 日確認。

4. Reddit r/generativeAI: "PSA: Why BytePlus Seedream 5.0 Pro's Layer Separation marketing felt misleading" — 2026 年 8 月 31 日に投稿された利用者の体験談。2026 年 10 月 23 日確認。