終了まで—Wan モデルが公式価格から最大 45% オフ
LogoWan API
  • モデル
  • 開発者向け
  • 料金
  • APIドキュメント
  • ガイド
Seedream 5.5 API 入門:画像生成・編集・レイヤー分解
2026/11/12

Seedream 5.5 API 入門:画像生成・編集・レイヤー分解

Seedream 5.5 を一度呼び出してタスクをポーリング。参照画像編集、透過 PNG、レイヤー分解の手順と、出力サイズ・現在の画像単価を解説します。

Seedream 5.5 は画像を返す前にタスク ID を返します。リクエストを一度送信し、その ID を保存して、完成結果をポーリングします。画像生成は画像 1 枚を生成し、レイヤー分解はベース画像と透明レイヤーを生成できます。どちらも model: "seedream-5-5" を使いますが、入力の規則は異なります。1

このチュートリアルでは、陶器のティーポットの制作指示から生成と部分的な編集を行い、次に既存のポスターをレイヤーに分解する方法を紹介します。Seedream 5.5 Playground には同じリクエスト設定があり、アプリに組み込む前に JSON を確認できます。

仕様は 2026 年 11 月 12 日に確認しました。連携確認では、互換性のない透明設定、レイヤー上限、使用可能な寸法がない完了出力など、34 件のリクエストとレスポンスを再現しました。これはリクエスト処理と課金入力を検証するもので、生成速度や画質のベンチマークではありません。以下の画像は 11 月 10 日の既存の Seedream 5.5 サンプルです。

キーと小さなリクエストから始める

API キーでキーを作成し、サーバーに保存して、https://api.wanapi.app をベース URL に使います。既存の Wan API キーで利用可能なモデルとグループにアクセスできます。この画像モデル専用のキーを購入・選択する必要はありません。

次を generate.json として保存します。

{
  "model": "seedream-5-5",
  "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
  "size": "1K",
  "output_format": "png",
  "content_filter": true
}

サーバー環境に WAN_API_KEY を設定し、一度送信します。

curl --fail-with-body --retry 0 --max-time 90 \
  https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @generate.json \
  -o submitted.json

成功レスポンスには id、model、処理中のステータスが含まれます。submitted.json ファイル全体を保存してください。画像 URL がないことを生成失敗と判断しないでください。このレスポンスはタスクの受理を示します。ID を受け取る前に接続が切れた場合は、再度 POST する前にタスクログを確認します。応答が不明確でも、同じ有料タスクを再作成してよいという意味にはなりません。

最初のリクエストでは 1K を明示的に選びました。size を省略すると画像生成の既定値は 2K です。既定の形式は PNG、透かしはオフ、コンテンツ審査はオンです。公開 API では content_filter を明示的に変更できますが、Playground は一般アカウントの審査を有効に保ちます。1

更新後も保存した ID をポーリングする

ポーリング URL は GET /seedream55/v1/tasks/{id} です。完了レスポンスは output.data に画像を格納し、同期 Images API のレスポンス形式は使いません。各項目には URL と実際のピクセルサイズがあります。

次の Python スクリプトは保存済みのレスポンスを読み、最大 10 分間ポーリングします。GET リクエストのみを送るため、再実行しても既存のタスクを継続します。

import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path

saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    request = urllib.request.Request(
        url,
        headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            task = json.load(response)
    except urllib.error.HTTPError as error:
        if error.code != 429 and error.code < 500:
            raise
        time.sleep(5)
        continue
    except (urllib.error.URLError, TimeoutError):
        time.sleep(5)
        continue

    if task["id"] != task_id:
        raise RuntimeError("Unexpected task identity")
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
    if task["status"] == "completed":
        Path("result.json").write_text(json.dumps(task, indent=2))
        for index, image in enumerate(task["output"]["data"], start=1):
            print(index, image["size"], image["url"])
        break
    time.sleep(5)
else:
    print("Still waiting. Keep submitted.json and resume this GET later.")

10 分の制限はこのクライアント例のものです。タスクをキャンセルしたり、生成失敗を証明したりするものではありません。この連携の実測遅延範囲は確立していないため、固定の秒数を約束せず、待機状態を実装してください。準備ができたらダウンロードしたファイルを保存し、結果 URL を恒久的な素材保存先として扱わないでください。

Seedream 5.5 で生成した、リネンのテーブルクロス上の陶器のキツネ型ティーポット

このサンプルは 1248 × 832 ピクセルです。1K プリセットは解像度区分であり、縦横が両方 1024 になる保証ではありません。レイアウトや費用計算に正確な寸法が必要な場合は、結果の size を読んでください。

残す要素を指定してシーンを変える

編集では、公開 HTTP(S) URL を image に追加します。ご自身でホストする元写真でも、ダウンロード後にご自身でホストした生成画像でもかまいません。参照画像にはファイルアップロード、Base64、data URI を使えません。処理中もアクセス可能な状態を保つ必要があります。対応する入力形式とメディアの制限は API リファレンスに記載しています。1

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/fox-teapot.png",
  "prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
  "size": "1K"
}

上の URL はプレースホルダーです。アクセス可能な画像に置き換えてください。意図した別の編集タスクとして送信し、新しいファイル名でレスポンスを保存します。モデルは前のタスクを記憶しないため、編集したい画像を送る必要があります。

複数の参照画像では、image に最大 10 個の URL 配列を指定できます。1 枚目の商品、2 枚目の背景など、各画像の役割をプロンプトで指定します。目的を満たす最小限の組み合わせから始めてください。結果で重要な細部が変わった場合、参照画像が少ないほど、どの指示や元画像が変化の原因か特定しやすくなります。

保持の指定は指示であり、ピクセルの固定ではありません。編集のたびに商品の輪郭、ラベル、カメラ角度を元画像と比較してください。ポスターでは正確な見出しを引用符で囲み、想定する表示サイズで句読点、名前、日付を確認します。小さな文字や装飾文字は手作業の修正が必要になることがあります。このガイドは、どの言語についても実測の精度を約束しません。

切り抜き画像には "background": "transparent" を追加し、"output_format": "png" を保ちます。JPEG はこのアルファチャンネルを保持できません。透明設定は画像生成と編集で利用でき、レイヤーモードには後述の専用ルールがあります。

ポスターを再利用できるレイヤーに分解する

レイヤー分解には画像がちょうど 1 枚必要です。プロンプトは任意です。省略してモデルに要素を選ばせるか、分解したい部分を指定してください。デザインを評価する際は、少ない出力上限から始めます。

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  },
  "output_format": "png"
}

max_images にはベース画像も含みます。そのため 4 は、ベース画像と最大 3 レイヤーを許可します。上限の範囲は 2–100、既定値は 30 で、モデルが返す枚数はそれより少ない場合があります。このモードでは auto であっても background を送らないでください。分解されたレイヤーは既に透過 PNG です。output_format はベース画像に適用されます。1

Seedream 5.5 の元ポスターと、分解した背景・ミュージシャン・透明な文字レイヤー

この既存のプレビューは元ポスターと返された透明な要素を組み合わせています。分解の意味を理解するのに役立ちますが、すべてのポスターが同じレイヤー数に分かれ、境界がきれいになる保証ではありません。

各結果とともに任意のメタデータを確認してください。

項目使い方
z_index値が大きいものを小さいものの上に配置します。
bounding_box.absoluteベース画像のピクセル単位の左・上・右・下の座標でレイヤーを配置します。
bounding_box.normalized対応する座標を 0–1000 に換算した値です。
name, descriptionモデルが分解した要素を識別します。
text_recognition認識された文字、行、取得可能なスタイル情報を読みます。

URL だけでなく結果 JSON 全体を保存してください。レイヤーの画像サイズはベースのキャンバスへの配置寸法と異なる場合があります。構図を再構成する際はバウンディングボックスを使い、結果を目視で確認します。フォント候補は推定です。OCR メタデータは元のフォントや完成した PSD ファイルを保証しません。装飾文字、重なる要素、プロンプトで除外した文字によって、結果が不完全になることがあります。

費用を比較する前に寸法を選ぶ

画像生成は 1K、1.5K、2K に加え、合計 921,600–4,624,220 ピクセル、アスペクト比 1:16–16:1 の範囲で正確な WIDTHxHEIGHT 寸法に対応します。レイヤーモードは同じプリセットと auto に対応しますが、正確な寸法は指定できません。この仕様は 3K・4K プリセット、バッチの n、seed、高速プロンプト最適化モードを提供しません。別バージョンの Seedream のパラメーターは、確認せずに引き継がないでください。1

Playground と同じ料金ソースから取得した現在の単価を表示します。

現在、料金を取得できません。ページを更新して再試行してください。

単価は自動更新されます。1 つの API キーですべてのモデルとグループを利用できます。

261 万ピクセル以下の出力単価を L、それを超える単価を H、参照画像単価を R とします。参照画像なしの 1K 生成は L、参照画像 1 枚を使う編集は L + R です。1K と 1.5K はどちらも低い出力単価を使います。最初の 1 枚を含め、すべての参照画像が課金対象です。2

画像 4 枚を上限とする 1K レイヤーリクエストの見積もりは 4L + R です。ベース画像と 2 レイヤーだけが返り、各画像が低い単価の範囲なら、最終費用は 3L + R です。出力サイズが混在する場合は各画像を別々に数えます。低い単価の画像 2 枚と大きい画像 1 枚なら 2L + H + R です。ベース画像も出力画像であり、この計算から省略してはいけません。

最初の仮引き落としは選択した上限をカバーします。実際の出力の精算後に未使用分を戻し、失敗したタスクは返金します。課金テストでは、同じ完了レスポンスを再現しても残高が二重に変動しませんでした。また、必要な画像使用量の事実がすべて揃っていない完了結果は、見積数量を実際の出力として扱わず、未精算のままになることも確認しました。

リクエストや結果の確認が必要な場合

検証エラーは通常、レイヤーモードでの複数参照、透明 JPEG、非対応サイズ、画像生成リクエストでのレイヤーオプションなど、モードの不整合を示します。新しいタスクを作る前にリクエストを修正してください。一時的なポーリングエラーでは、既存の ID を保持して GET を再試行します。判断は別々に行う必要があり、汎用の「すべて再試行」処理にまとめると、有料生成が重複するおそれがあります。

編集結果がよくない場合は、変更を一つずつ元画像と比較してください。大きな出力でも、ラベルの保持や見出しの正確な描画が確認されたことにはなりません。レイヤーは本番デザインに取り込む前に、輪郭と欠けたメタデータを確認します。コンテンツ審査は既定で有効です。コンテンツ拒否を理由に、審査を無効にして自動再送信してはいけません。

Seedream 5.5 は、この仕様のもとで画像生成、参照画像編集、分解可能なデザイン要素を必要とするワークフローに適しています。Seedream 5.0 Pro は既定値と制限が異なる別モデルです。一方が常に優れていると主張できる比較条件を揃えた検証は実施していません。このガイドは別の「5.5 Pro」の提供や無料生成も約束しません。モデルページで現在の Playground と料金を確認するか、OpenAPI ドキュメントを使ってアプリにリクエスト検証を組み込んでください。

参考資料

  1. Seedream 5.5 API リファレンス:リクエスト項目、既定値、URL 入力、非同期レスポンス、レイヤーメタデータ。仕様確認日:2026 年 11 月 12 日。
  1. Seedream 5.5 の現在の料金:出力のピクセル区分と参照画像単価。
すべての記事

著者

avatar for Wan API
Wan API

カテゴリー

  • プロダクト
キーと小さなリクエストから始める更新後も保存した ID をポーリングする残す要素を指定してシーンを変えるポスターを再利用できるレイヤーに分解する費用を比較する前に寸法を選ぶリクエストや結果の確認が必要な場合参考資料

その他の記事

Seedance 2.5 と Seedance 2.0:シーンに合うのは?
プロダクト

Seedance 2.5 と Seedance 2.0:シーンに合うのは?

Seedance 2.5 と Seedance 2.0 の動画の長さ、参照素材の上限、サンプル設定を比較。品質や速度を決めつけず、同じ条件で評価する方法を解説します。

avatar for Wan API
Wan API
2026/10/14
Seedance 2.5 Flashの料金
プロダクト

Seedance 2.5 Flashの料金

5秒のショットにかかるSeedance 2.5 Flashの料金を計算できます。テキスト、参照動画、編集を、最新の480pおよび720pの料金で比較できます。

avatar for Wan API
Wan API
2026/11/18
Seedance 2.0 Fast と Mini:どちらを試す?
プロダクト

Seedance 2.0 Fast と Mini:どちらを試す?

Seedance 2.0 Fast と Mini の上限、参照動画の課金、サンプルを比較。同じ制作指示で品質、所要時間、使えるショットの費用を評価します。

avatar for Wan API
Wan API
2026/10/15

Wan API からのお知らせ

サービスの更新情報とモデルのニュース

登録すると、モデルのニュース、サービスの更新情報、API 連携に関する情報を受け取れます。

LogoWan API

Wan 3.0 と Wan 3.0 Prime。 次のプロジェクトに動画生成を。独立したプラットフォームです。Alibaba、Wan、ByteDance との提携関係や、これらによる推奨はありません。

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
モデル
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • 料金
開発者向け
  • ドキュメント
  • Wan 3.0 ガイド
  • よくある質問
  • Wan API について
  • Wan API へのお問い合わせ
法的情報
  • プライバシー
  • 利用規約
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. 無断転載を禁じます。