LogoWan API ドキュメント
ホーム
X (Twitter)
ホーム

はじめに

概要連携ガイド残高を確認タスクを削除

Wan モデル

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance モデル

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

画像モデル

Seedream 5.0 ProSeedream 5.5 API

言語モデル

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

Seedream 5.5 API

Seedream 5.5 で画像生成・編集・レイヤー分解。リクエスト項目、非同期タスク、画像メタデータ、現在の画像単価を解説します。

Seedream 5.5 はテキストまたは最大 10 枚の参照画像から画像を 1 枚生成します。レイヤー分解では 1 枚の画像からベース画像と透明レイヤーを返し、任意で印刷文字の認識結果も取得できます。

Playground で試す · OpenAPI JSON · 連携チュートリアル

認証とエンドポイント

Wan API キーを Bearer トークンとして使用します。1 つのキーですべての利用可能なモデルとグループにアクセスでき、キーでグループを選択する必要はありません。

メソッドURL用途
POSThttps://api.wanapi.app/seedream55/v1/images/generations画像タスクを 1 件送信
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}そのタスクを取得

モデル ID は seedream-5-5 です。これらは非同期エンドポイントです。一度送信し、タスク ID を保存して、completed または failed になるまでポーリングしてください。ネットワークの応答が不明確でも、再送信してよいという意味にはなりません。

画像を生成する

curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'

受理されたリクエストは画像データではなくタスクを返します。

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"

数秒おきに同じ ID をポーリングします。アプリが待機を停止しても、後から再開できるよう ID を保存してください。このガイドのタスク ID とタイムスタンプは説明用の例です。

パラメーター

パラメーター型既定値規則
modelstring必須seedream-5-5
promptstring画像生成では必須レイヤー分解では任意。
imageURL または URL 配列なし参照画像は最大 10 枚、レイヤー分解ではちょうど 1 枚。すべての参照画像が課金対象。
sizestring2K、レイヤーでは auto下記のサイズ規則を参照。
output_formatstringpngpng または jpeg。レイヤーではベース画像のみに適用。
backgroundstringautoauto、opaque、transparent。透明背景には PNG が必要。レイヤーモードではこの項目を完全に省略。
layer_decompositionbooleanfalse参照画像 1 枚をベース画像と透明 PNG レイヤーに分解。
layer_decomposition_options.max_imagesinteger30ベース画像を含む合計画像数の上限、2–100。レイヤーモードのみ。
layer_decomposition_options.text_recognitionbooleanfalseレイヤー内の印刷文字メタデータを要求。レイヤーモードのみ。
optimize_prompt_options.modestringstandard対応するモードは standard のみ。
watermarkbooleanfalseAI 生成を示す透かしを要求。
content_filterbooleantrue顧客 API は false を受け付けます。Playground では管理者のみ無効にできます。

n、seed、stream、resolution、aspect_ratio、image_urls、response_format パラメーターには対応していません。未記載の項目は破棄され、これらの機能を有効にはしません。multipart アップロード、Base64、data URI は拒否されます。

出力サイズ

画像生成は 1K、1.5K、2K または正確な WIDTHxHEIGHT ピクセル指定に対応します。正確なサイズは合計 921,600–4,624,220 ピクセル、アスペクト比 1:16–16:1 の範囲にする必要があります。たとえば 2048x1152 は有効です。16:9 のような比率はサイズの値ではありません。

レイヤー分解は auto、1K、1.5K、2K に対応し、正確なピクセル指定には対応しません。auto は入力に合わせ、高い出力単価で仮引き落としします。3K・4K プリセットはありません。

参照画像と編集

認証情報を含まない、ご自身でホストする公開 HTTP(S) URL を指定してください。対応形式は JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF で、画像 1 枚あたり最大 30 MB、合計最大 36,000,000 ピクセルです。AVIF と JP2 は非対応です。URL はログインやブラウザーの検証画面なしで画像を直接配信する必要があります。

{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}

複数の参照画像は URL 配列で渡し、プロンプトで各画像の役割を説明します。その場合も結果は画像 1 枚です。例の参照 URL はプレースホルダーなので、ご自身のアクセス可能なファイルに置き換えてください。

レイヤー分解と文字認識

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

上限にはベース画像を含みます。4 は返される画像が最大 4 枚という意味で、4 レイヤーとベース画像ではありません。返される枚数はそれより少ない場合があります。自動分解では prompt を省略するか、分解したい要素を指定してください。プロンプトで除外した文字は出力されないことがあります。

レイヤーは透明部分を持つ PNG ファイルです。ベースを 0 として、z_index の昇順に重ねて画像を再構成します。バウンディングボックスがあれば、配置前にその寸法にレイヤーをリサイズしてください。レイヤーファイルのピクセル寸法と配置寸法は異なる場合があります。

任意の text_recognition には全文の text と lines が含まれます。各行には bounding_box とスタイル付きの runs が含まれる場合があります。各 run の style には similar_font_family、foreground_color(#RRGGBB)、bold、italic、underline、strikethrough、shadow、translucent が含まれる場合があります。これらはモデルによる推定です。装飾文字や手書き文字では認識結果がないこともあるため、任意の項目として扱ってください。

完了時のレスポンス

{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}

各画像には url と size があります。ほかに output_format、background、z_index、name、description、bounding_box、text_recognition が含まれる場合があります。bounding_box.absolute はベース画像のピクセル単位の [left, top, right, bottom] です。bounding_box.normalized は同じ座標を 0–1000 に換算した値です。任意のメタデータがすべての画像にあると仮定しないでください。

画像 URL は非公開のダウンロードリンクとして扱い、必要なファイルを保存してください。access トークン付き URL はアカウントの API キーを公開せずに開けます。

料金

課金対象画像USD / 枚
2.61 MP 以下の出力(1K / 1.5K)$0.017
2.61 MP を超える出力(2K)$0.02975
最初の 1 枚を含むすべての参照画像$0.0068

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

出力のピクセル数の境界は 2,610,000 ピクセル です。料金は次のように計算します。

lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate

最初の 1 枚やレイヤー用の元画像を含め、すべての参照画像が課金対象です。画像生成とレイヤー分解には同じ出力単価を使います。送信時は出力 1 枚、またはレイヤーの max_images 上限と参照画像分を仮引き落としします。完了時は返された各画像自体のピクセル寸法で精算し、未使用分を戻します。実行中に単価が変わっても、受理されたタスクは受付時の料金を保持します。失敗したタスクは返金されます。

エラーと再試行

無効なパラメーターは送信前に拒否されます。残高やキーのクォータが不足すると生成できません。送信とポーリングの両方に認証と所有権の確認が適用されます。失敗したタスクは status: "failed" と error オブジェクトを返します。

ステータス取得に失敗した場合は同じタスク ID で再試行します。タイムアウト後も含め、生成 POST を自動で繰り返さないでください。既に受理されている可能性があります。上流が正常な進行状況を返す間はタスクを待機状態に保ちます。正常な上流ステータスも正常な配信も連続 3 時間ないタスクは失敗となり、返金されます。

タスク ID を保存して再開するアプリのループは、Seedream 5.5 チュートリアルをご覧ください。

Seedream 5.0 Pro

Seedream 5.0 Pro API の使い方。画像生成、参照画像による編集、レイヤー分解、透過 PNG、リクエスト項目、レスポンス、料金を解説します。

Claude API

Anthropic Messages と OpenAI Chat Completions で Claude を呼び出す方法。モデル ID、ストリーミング例、グループ別の入力・出力・キャッシュ料金を掲載。

目次

認証とエンドポイント画像を生成するパラメーター出力サイズ参照画像と編集レイヤー分解と文字認識完了時のレスポンス料金エラーと再試行