Wan API 連携ガイド

Wan API に接続する見出しのリンクをコピー

API のベース URL は https://api.wanapi.app です。API キー設定でキーを作成し、Authorization: Bearer YOUR_API_KEY ヘッダーで送信してください。キーはサーバー側で保管します。Playground はウェブサイトのログインセッションを使い、同じアカウントの残高から課金します。ブラウザーにキーを貼り付ける必要はありません。

利用には、有効なアカウントと十分な残高が必要です。現在の単価は料金をご確認ください。モデルごとに専用のエンドポイントとモデルページがあります。

GET /v1/models で、そのキーから利用できるモデルを取得できます。高い解像度を選んでも、モデルは自動で切り替わりません。

リクエストフィールド見出しのリンクをコピー

4 モデル共通で、次の 14 個のネイティブフィールドを使います。プロンプト、または 1 つ以上のメディア入力を指定してください。フレームは参照入力、file、link と併用できません。file と link も同時には指定できません。

メディアには、タスクが完了するまで直接アクセスできる安定した URL を使ってください。動画の長さの確認では、HTTP Range リクエストで範囲を限定して読み取ります。動画サーバーはこの読み取りに対応し、MP4/MOV の長さを示すメタデータを読み取れる状態で提供する必要があります。長さの確認時にはリダイレクトをたどりません。プライベートネットワークの URL は利用できません。参照動画と出力動画の合計は 30 秒以内に収めてください。Playground の JSON リクエスト本文は最大 32 MiB です。大きい入力には URL を使ってください。

状態を確認して動画をダウンロードする見出しのリンクをコピー

どのモデルの送信エンドポイントも、API 利用者向けのタスク ID を返します。次の処理に進む前に、必ず保存してください。

{
  "task_info": {
    "id": "task_EXAMPLE",
    "status": "pending"
  }
}

使用したモデルの章にある問い合わせの例を使ってください。最初は 5 秒間隔で確認し、一時的なエラーが発生した場合は間隔を延ばします。各タスクのモデル ID は、タスク ID と一緒に保管してください。別のモデルのエンドポイントから問い合わせないでください。

ネイティブ API のステータスは pending、processing、completed、failed です。完了時のレスポンスには、Bunny CDN の完全な署名付き URL を格納した videos 配列が含まれます。

{
  "task_info": { "id": "task_EXAMPLE", "status": "completed" },
  "videos": ["https://reapiflexible.b-cdn.net/flexible/v1/expires/2026-11/20261113T06/wanapi-task_EXAMPLE/video.mp4?token=HS256_SIGNATURE&expires=1794550071"]
}

返された URL をそのまま再生やダウンロードに使用できます。この URL には API キーや Authorization ヘッダーは不要です。ファイルにはストレージの既存の保存ポリシーが適用されます。タスクを再度問い合わせても、動画の再生成や追加料金は発生せず、ファイルの保存期限も延長されません。長期保存が必要なファイルは、ご自身のストレージに保存してください。タスクの問い合わせには API キーが必要で、自分のアカウントが所有するタスクのみ取得できます。

Responses の同期処理とバックグラウンド処理見出しのリンクをコピー

Responses API を使うクライアントでは、POST /v1/responses にモデル ID、文字列の input、同じネイティブ生成フィールドを指定できます。prompt の代わりに input を使ってください。reference_images などのネイティブメディアフィールドは、引き続き最上位のフィールドとして指定します。

{
  "model": "wan3.0-video",
  "input": "A blue ball rolls across a white table.",
  "resolution": "480p",
  "duration": 2,
  "background": true
}

background: true の場合は、レスポンス ID を保存し、GET /v1/responses/{response_id} で状態を確認します。background を指定しない場合、HTTP リクエストは完了まで待機します。stream: true を指定すると、待機中に Server-Sent Events を受信できます。最終的なアシスタント出力には、署名付きの動画 URL が含まれます。このリンクを持つ人は動画にアクセスできるため、非公開の情報として扱い、誤って公開しないでください。生成に時間がかかる場合やプロキシのタイムアウトが短い場合は、ネイティブのタスク送信または Responses のバックグラウンド処理を推奨します。

同期リクエストの接続が切れたりタイムアウトしたりしても、生成はキャンセルされません。タスクはサーバーに残ります。同じ生成リクエストを自動で再送しないでください。

課金とエラー処理見出しのリンクをコピー

料金は、モデルの解像度別単価に課金対象の秒数を掛けて計算します。参照動画と出力動画の秒数が両方とも対象です。テキスト、画像、音声の入力は動画秒数に加算されません。参照動画を使わない長さ指定のリクエストでは、指定した出力秒数分の残高を確保します。長さの自動設定や参照動画を使うリクエストでは、最大 30 秒分の残高を確保し、実測した使用量で精算して未使用分を返却します。生成に失敗した場合は、確保した残高を解放します。状態確認を繰り返しても、新しい動画の生成や追加の課金は発生しません。

• 無効なパラメーター： リクエストを修正してから再送してください。未定義のネイティブフィールドは拒否されます。
• 残高不足： 次の有料リクエストを送る前に入金してください。キーの利用上限を設定しても、アカウントの残高は増えません。
• レート制限や一時的な状態確認の失敗： 待機間隔を徐々に延ばし、最大待機時間を設けて、状態の問い合わせだけを再試行してください。
• 送信のタイムアウト、通信の中断、タスク ID の未取得： 送信結果を確定できない場合があります。別の有料タスクが作成される可能性があるため、POST を自動で再送しないでください。
• タスクの失敗： 状態の問い合わせができない場合とは区別して、生成の失敗を表示してください。
• ダウンロードの失敗： 別の生成を開始する前に、完了済みのタスクのダウンロードを再試行してください。

生成リクエストの送信は、自動で再試行されたり、別のモデルへ切り替えられたりしません。キャンセル、Webhook、冪等性キーについて、提供を保証する仕様は公開していません。送信結果が不明で調査が必要な場合は、タスク ID を保管し、サポートにお問い合わせください。