はじめに
このエンドポイントの役割
Seedream 5.0 Pro レイヤー分解は、完成した画像を 1 枚受け取り、パーツに分解します。分離した要素を取り除いて背景を補修したきれいなベース画像と、人物、見出し、商品、小物といった要素ごとの透過 PNG が返ります。どのパーツも移動、拡大縮小、差し替え、色替えができ、外すこともできます。
効いてくる入力
image_url は元になる 1 枚の画像です(png、jpeg、webp、bmp、tiff、gif、30 MB まで。HEIC は非対応)。prompt は任意で、空のままなら自動検出、分けたい要素を書けばそれを分離し、<bbox>x1 y1 x2 y2</bbox> を 0〜1000 の座標で添えて囲むこともできます。resolution は auto、1k、1.5k、2k です。output_format(jpeg か png)が効くのはベース画像だけです。
コンテンツについて
フィルターなしの元画像も分割できます。お送りいただいた画像は、そのままモデルに渡されます。私たちのテストでは、かなり強めのレベルの元画像はモデルが拒否し、料金はかかりませんでした。
返ってくるもの
1 枚目はベース画像で、分離した要素を取り除いて背景を補ったものです(layer.zIndex は 0)。それ以外の画像はすべて、重なり順に並んだ透過 PNG のレイヤーです。各レイヤーには、ベース画像のピクセル座標で [x1, y1, x2, y2] の形をした boundingBox と、モデルが付けた name が付くので、元の位置にそのまま戻せます。合計は最大 17 枚で、課金はベース画像を含めた実際の枚数に従います。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | Text to Image、Image to Image |
| 必須入力 | プロンプト(最大 5,000 文字)。Image to Image では参照画像 1〜10 枚も必要 |
| アスペクト比 | 1:3〜3:1 の 15 種類。Image to Image の既定は auto(1 枚目の参照に最も近い比率) |
| 解像度 | 1k、1.5k、2k のいずれか(既定は 2k)。段で画素数と価格が決まります |
| 再現性 | seed フィールドなし。同じリクエストでも別の絵が返ります |
| コンテンツポリシー | 検閲なし。成人向けフラグもリクエストごとの申告もありません |
主な機能とハイライト
濡れた肌、シルク、蝋燭の影。近づいても崩れません
質感が示唆にとどまらず、実際に描かれるようになる段です。鎖骨に結ぶ水滴、重いシルクの重量感、黒い背景に落ちるソフトボックス 1 灯の減衰。方向がすでに定まったあとで、速い姉妹ティアではなくここに 1 回を使う理由がそこにあります。
顔と衣装と部屋を、1 回の編集でまとめます
編集エンドポイントは参照画像を 1〜10 枚受け取ります。1 枚目から被写体、3 枚目から衣服、5 枚目から部屋というようにプロンプトで役割を割り当てれば、それらを 1 枚に組み上げます。参照が 1 枚増えるごとに見積もりに乗り、送信前に見た金額がそのまま精算されます。
15 種類の比率と、元画像の形を保つ編集
aspect_ratio は 1:3 から 3:1 まで、フィード向けの 4:5 やバナー向けの 21:9 を含む 15 種類で、resolution で 1k、1.5k、2k のいずれかの段を選びます。編集エンドポイントの既定は auto です。出力は 1 枚目の参照に最も近い対応比率を取るので、縦長の元画像は別の形を指定しない限り縦長のまま返ります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 分割する画像 1 枚:png、jpeg、webp、bmp、tiff、gif、30 MB まで、総画素数は 262,144〜36,000,000、アスペクト比は 1:16〜16:1。HEIC は非対応です。 1 文字以上 |
prompt | いいえ | 任意で、文字数の制限はありません。空のままならモデルが主要な要素を自分で選び、要素を名指しすればそれらを分割します。 1 文字以上 · 5000 文字以内 |
resolution | いいえ | auto、1k、1.5k、2k から選びます。ベース画像は入力のアスペクト比を保ち、各レイヤーは要素の縦横比を保ちます。 |
output_format | いいえ | ベース画像だけの jpeg か png。レイヤーはどちらを選んでも常に透過 PNG です。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.042 / 枚 |
| $0.042 / 枚 |
| $0.084 / 枚 |
| $0.084 / 枚 |
ユースケース
規制のないエディトリアルの完成カット
キャンドルの灯る室内、濡れた質感のビューティーポートレート、ハードライトのシルク。キャンペーンが実際に出す一枚です。切り替えるフラグも別のエンドポイントもなく、同じ 2 本のエンドポイントが香水の物撮りとフィルターなしの最終カットを同じように扱います。
ビューティーとフレグランスの本番カット
硬いソフトボックス 1 灯、深い黒の地、艶のある肌と水のディテール。素材の再現がプレースホルダーと言い訳されずにクライアントレビューを通るくらいまで来ています。
参照 10 枚でシーンを組み立てる
被写体の写真、衣服の参照 2 枚、小道具の素材、ロケーションのカットを 1 回の編集呼び出しに送り、それぞれの担当を名指しします。1 リクエストが合成作業 1 セッションを置き換え、光合わせは手作業ではなくモデルが行います。
方向が定まったあとの仕上げ
構図はより速いモデルで探り、うまくいった文言をここに持ち込んで納品するフレームを作ります。プロンプトを組み直す必要はなく、見直す価値があるのは参照の組み合わせ、アスペクト比、解像度の段だけです。
プロンプトガイドと実践のヒント
生成なのか、組み立てなのかを決める
参照がなければ text-to-image、1〜10 枚あれば編集エンドポイントです。編集では
aspect_ratioを指定しない限り、画面は 1 枚目の参照に合わせます。どちらも同じ 5,000 文字のプロンプトを受け付けるので、選ぶ基準は出発点の素材であって、指示の書き直しではありません。トリートメントを書いてから、画面を決める
被写体、衣装、光源とその方向、レンズ、グレード。続けてアスペクト比と 1k / 1.5k / 2k の段を選んでください。このページのポートレートは次のプロンプトから生まれています。"High-resolution beauty editorial photograph, close portrait of an adult woman with wet hair slicked back, water beading on her collarbone and bare shoulders, a heavy ivory silk robe slipping off one shoulder, arms folded across her chest, dramatic single softbox from camera left, glossy skin texture, deep black background, luxury fragrance campaign look."
タスクをポーリングし、指示文を素材と一緒に残す
タスクを作成し、終了状態になるまでポーリングして、プラットフォーム側のストレージから画像を取得します。seed フィールドがないので、まったく同じフレームを描き直す手段はありません。残す結果には必ずプロンプトを添えて保管してください。
はじめに
Seedream 5.0 Pro レイヤー分解は、完成した画像 1 枚を、ベース画像と最大 16 枚の透過 PNG レイヤーに分割します。各レイヤーには位置の枠と名前が付くので、元の構図を組み直したり、キャンバス上で並べ替えたりできます。
ByteDance が開発したモデルです(モデル ID は dola-seedream-5-0-pro-260628)。レイヤーを元の位置にそのまま戻したいときにお使いください。
出発点となる素材でモードを選ぶ
| 出発点となる素材 | モード |
|---|---|
| パーツごとに使いたい完成画像 | Seedream 5.0 Pro レイヤー分解 |
| 文章のアートディレクションやデザインブリーフ | Seedream 5.0 Pro テキストから画像 |
| 手直ししたい承認済みの元画像 | Seedream 5.0 Pro 画像編集 |
| 名前と位置の枠も付く同じ分割を、1 枚あたり低い料金で | Seedream 5.0 Flash レイヤー分解 |
レイヤー分解は Pro か Flash か
どちらの段階も、レイヤーごとに boundingBox と name を返します。同じ映画ポスターをプロンプトなしで実行したところ、Pro は 9 枚、Flash は 8 枚を返しました。違いは料金と、コンテンツ上の境界が 1 つある点です。料金は、Pro が出力画像 1 枚あたり 1K と 1.5K で $0.042、2K で $0.084、Flash はどの段階でも $0.026 です。Pro は、かなり強めのレベルの元画像を拒否しますが、Flash は同種の画像を人物ごとに分割しました。私たちの実行では、どちらかが安定して速いということはありませんでした。
主な特長
位置の枠と名前
レイヤーごとに、ベース画像のピクセルで [x1, y1, x2, y2] の形をした boundingBox と、「赤いトレンチコートの女性」のような name が返ります。私たちのポスターでの実行では、レイヤーをそれぞれの枠に重ね直すと、元のポスターが再現されました。レイヤーの PNG は、それが占める枠より大きいことがよくあります(671 × 139 の枠に対して 1233 × 256 の PNG が付いた例)。戻すときは、PNG を枠に合わせて縮小してください。
きれいなベース画像
分離した要素は取り除かれ、背景が補われます。香水広告を分割したときは、ボトル、リボン、文字があった場所が、何もない黒い大理石の面になりました。
言葉でも座標でも誘導できる
要素を名指しするか、<bbox> の座標で位置を指定します。プロンプトなしなら、モデルが主要な要素を自分で選びます。
透過 PNG のレイヤー
レイヤーは output_format の指定に関わらず、常に透過 PNG です。この設定で変わるのはベース画像だけです。
ユースケース
ポスターの文字を変える
タイトルのレイヤーを取り出し、差し替えたりスタイルを変えたりして、返された枠の位置にすべてを重ね直します。
商品の背景を差し替える
広告から商品と文字を切り出し、ベース画像は残すか差し替えて、新しいキャンペーン用に組み直します。
パララックスやアニメーション用の素材を作る
イラストを、位置のわかる順序付きのレイヤーにし、奥行きのある動きやリグに使えます。
場面から人物を切り離す
人物だけを指定すれば、透過レイヤー 1 枚と、その人物のいない場面が得られます。
プロンプトのコツ
欲しいパーツを名指しする
ポスターなら、平易な言葉で並べます。「ダイナーの建物、キャッチコピー、LATE SHIFT のタイトル、赤いトレンチコートの女性、ADMIT ONE の半券を分けてください。」この実行では 6 枚が返りました。ベース画像と、まさにその 5 枚のレイヤーです。
バウンディングボックスで要素を囲む
要素の名前の後ろに <bbox>x1 y1 x2 y2</bbox> を加えます。座標は左上を原点とする 0〜1000 に正規化されているので、画像のピクセルサイズに左右されません。
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
解像度を選ぶ
1k と 1.5k は出力画像 1 枚あたりの料金が同じで、2k と auto は 2K の料金です。auto は 2K で出力することがあるためです。作業用の分割で足りるなら 1k か 1.5k を使ってください。
確保額に備える
リクエストでは 17 枚分の料金を先に確保し、実際のレイヤー数が確定した時点で差額を返金します。結果は数枚のことが多いです。
コンテンツに関する注意
Seedream 5.0 Pro · レイヤー分解。 SpicyAPI はこのエンドポイントにプラットフォーム側のコンテンツフィルターを追加していません。モデル側の制限は引き続き適用され、結果は保証されません。私たちのテストでは、かなり強めのレベルを除き、試したフィルターなしの元画像をすべて分割しました。その中の、かなり強めのレベルの画像はモデルが拒否し、料金はかかりませんでした。ご利用にあたっては、コンテンツポリシーを遵守してください。
フィルターなしの元画像も分割できますが、結果は保証されません。かなり強めのレベルの元画像はモデルが拒否し、料金はかかりません。未成年者を含む素材、同意のない性的な画像、実在する人物へのなりすましを目的とする素材は送信しないでください。これは利用上の禁止事項であり、すべてのリクエストを自動審査するという意味ではありません。
商用利用への適合性、必要な権利の確認、最終的な編集判断は、利用者の責任で行ってください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。











