Wan API

8つの動画モデルを1つのキーで

Wan 3.0、Wan 3.0 Prime、Wan 3.0 Pro、Wan 3.0 Prime Pro の4変種と、Seedance 2.5・Seedance 2.0・Seedance 2.0 Fast・Seedance 2.0 Mini が同一プラットフォームに並びます。GET /v1/models は現在のキーで利用可能なモデルを返し、各モデルに wan3.0-video や w3.0-video-prime-pro といった文書化されたモデル ID があります。

マルチモーダルな入力モード

リクエストはテキストの指示文だけでも、先頭・末尾フレームだけでも、参考素材（画像10点、動画5クリップ、音声5クリップまで）だけでも組めます。ドキュメント1件や公開Webページの指定も可能。キーフレーム入力と参考入力はモードが分離されており同一リクエストでは併用できません。指示文は20,000文字までです。

ネイティブリクエストをプレビューできる Playground

各モデルページには Playground が埋め込まれ、選択したモデル向けのフラットなネイティブ要求ボディを組み立てます。未入力の省略可能フィールドは書き込まれず、送信前にそのモデルの生成可否もチェックされます。サイトセッションと前払い残高をそのまま使うため、キーをブラウザに貼り付ける必要はありません。

非同期タスクAPI

モデルエンドポイントへ送ると公開タスク ID が即座に返ります。ステータスは pending、processing、completed、failed の4つで、完了時のレスポンスには署名付き Bunny CDN URL が含まれ、再生もダウンロードも Authorization ヘッダーなしで可能です。POST /v1/responses は同期待受・バックグラウンド・server-sent events の3通りに対応します。

審査レベルで単価を変える

省略可能な nsfw_checker は Wan 3.0 と Wan 3.0 Prime において厳格／やや寛容なコンテンツ審査を選び分けますが、設定ごとに秒単価が異なります。Pro 系は false のみ対応。審査で明示的に拒否された送信は、同じ公開モデル ID のまま別設定で再提出できます。

残高確認とタスク削除

GET /v1/balance はアカウントの支払可能な残高と、そのキーに残った上限を返します。DELETE /v1/tasks/{task_id} は完了または失敗したタスク1件と、保存済みの動画・末尾フレームを消去します。サイト本文は /llms.txt と /llms-full.txt にも機械可読で公開されています。

• EC・プロダクトチーム：商品の静止画をゆっくり回る、あるいは寄るカットに変え、形・反射・ラベルの再現を確認してから広告素材に使う。
• 脚本・絵コンテ・SNS編集：撮りもキービジュアルもない段階で文章の場面を動画プレビューにし、短いクリップで照明、カメラ方向、テンポを判断して本編の長さを決める。
• ブリーフから作るエージェンシー：簡潔なドキュメントや公開ページを入力に、想定読者と伝えるメッセージを絞った映像のたたき台を生成する。
• 動画APIを統合するエンジニアリングチーム：Wan と Seedance の単価・長さ・参考素材の枠を同じ画面で比べ、決めたモデルを1つのキーと残高で使い続ける。
• レファレンスでキャラクターを作る仕事：アップロード素材ごとに外見・動き・音という役割を割り当て、Seedance 2.5 の長めシーンでも登場人物と場所を判別しやすくする。

Alibaba や ByteDance の公式サービスですか？

いいえ。Wan API は wanapi.app で独立運営されており、Alibaba・Wan・ByteDance からの系列関係も推薦もありません。これらの名称は接続している第三者モデルを示すもので、商標は各所有者に帰属します。

動画生成にサブスクリプションは必要ですか？

月額ビデオパッケージは掲載されていません。生成できるかは有効で残高のあるアカウント次第で、料金は解像度別単価 × 課金秒数です。

課金対象の秒数は？

参考動画の入力秒数と生成出力秒数の合計です。テキスト・画像・音声は秒数を増やさず、生成音をオフにしても単価は下がりません。

タスクをキャンセルや自動リトライできますか？

キャンセル、webhook、冪等キーの取り決めは案内されておらず、送信が自動で再試行やモデル切替されることもありません。タイムアウトや ID 未取得の場合はまず既存タスクを照会してください。再度の POST は有料タスクを2つ目にする恐れがあります。

生成動画はどのくらい利用できますか？

完了タスクはキー不要の署名付き CDN URL を返しますが、ファイルは既存の保存ポリシーに従います。照会しても提供期間は延びないため、残すものは自分のストレージへ。

最初のテストにはどのモデルが良いですか？

Wan 3.0 は 480p〜1080p で最安帯、Prime は別モデルとして別価格、2K と 4K は Pro 系のみ。Seedance 各ページは長さ・参考枠の上限が異なるため、成果物要件から逆算し、安いモデルに高解像度があると想定しないことです。

同じリクエスト体をモデル間で使い回せますか？

4つの Wan モデルは14のネイティブ生成フィールドを共有しますが、解像度の取りうる値、モデル ID、nsfw_checker の対応が異なります。Pro 系は寛容側の設定のみ。未知のフィールドは拒否されるため、対象モデルのページを先に確認してください。

• Google で wanapi.app にサインインし、アカウント設定でチャージする。Web アカウントを持つだけでは動画は生成できない。
• API キー設定でキーを作り、サーバー側にのみ保管する。Playground はサイトのセッションと同じ残高を使うためキーは不要。
• モデル一覧または GET /v1/models から対象を選び、そのページの解像度・長さの範囲・参考素材の上限を確認する。
• そのモデルの Playground でリクエストを組み、プレビューされたネイティブボディをコピーする。ドキュメント化されたモデル ID で JSON を直書きしてもよい。
• 送信したら返ってきたタスク ID を即保存し、5 秒間隔からポーリングを始める。一時的なエラーが続くなら間隔を延ばす。
• 完了レスポンスの署名付き URL で再生またはダウンロードし、保存期間が切れる前に自分のストレージへコピーする。