Wan 3.0 動画 API
APIMaster 上の wan3.0-video のパラメータ、メディアの組み合わせ、非同期タスク、ダウンロード、秒単位の課金。
Wan 3.0 動画 API
wan3.0-video は標準の Wan 3 モデルであり、wan3.0-video-prime とは別のモデルです。テキスト、画像、動画、音声、ドキュメント、公開ウェブページをサポートします。成功した各タスクは 1 つの MP4/H.264 動画を生成し、最大 30 秒です。統合レビュー日: 2026-11-17。
1回のリクエストで指定できるメディアは合計20件までです。生成動画は 30 fps です。
エンドポイントと認証
| 操作 | エンドポイント |
|---|---|
| 作成 | POST https://apimaster.ai/v1/videos |
| クエリ | GET https://apimaster.ai/v1/videos/{task_id} |
| ダウンロード | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
すべてのリクエストパラメータ
リクエストごとにメディア形式を 1 つ選択してください。複数種類の参照メディアや文書には metadata.input.media を使用します。
| パラメータ | 型 | 必須 / デフォルト | 意味と有効な値 |
|---|---|---|---|
model |
string | 必須 | 厳密に wan3.0-video。Prime で代用しないこと |
prompt |
string | 必須 | 結果を中国語または英語で記述します。公式の上限は 20,000 文字で、それを超えるネイティブテキストは切り捨てられます。メディアの順序に従って Image 1、Video 1、Audio 1 を参照してください。メディア種別ごとに独自の番号付けがあります |
duration |
integer | 5 |
出力秒数は 2~30。-1 を指定するとモデルが長さを選択します。参照動画を使用する場合、入力と出力の合計時間は 30 秒を超えられません |
seconds |
string | 任意 | 長さのエイリアス(例: "5" や "-1")。両方を指定する場合は duration と一致している必要があります |
resolution |
string | 1080P |
480P、720P、1080P。トップレベルの小文字の値は正規化されます |
aspect_ratio |
string | adaptive |
adaptive、21:9、16:9、4:3、1:1、3:4、9:16 |
ratio |
string | 任意 | aspect_ratio のエイリアス。動画延長には adaptive を推奨します |
size |
string | 任意 | 互換性のためのエイリアス。解像度ティア、または 1280x720 のようなサポート済みのピクセルマッピング。任意のピクセルサイズではなく、明示的な resolution と ratio の使用を推奨します |
generate_audio |
boolean | true(上流) |
出力に音声トラックを含めるかどうか。明示的な false は保持されます。音声の有無は 1 秒あたりの料金に影響しません |
audio |
boolean | 任意 | generate_audio のエイリアス。音声スイッチは 1 つだけ使用してください |
prompt_extend |
boolean | true |
プロンプトのインテリジェントな書き換え。明示的な false は保持されます。ドキュメント/ページ入力では true である必要があります |
watermark |
boolean | false(上流) |
出力にウォーターマークを追加します。明示的な false は保持されます |
seed |
integer | ランダム | -1 または 0~2147483647。省略または -1 はランダムシードを要求します。0 はそのまま転送されます。同じシードを繰り返しても同一の出力は保証されません |
input_reference |
string | 任意 | 先頭フレーム画像の URL。ネイティブの media 配列を置き換えます。入力スタイルを混在させないでください |
images |
string[] | 任意 | input_reference がない場合に reference_image 項目として追加される便宜的な配列 |
metadata |
object | 任意 | 以下のネイティブオブジェクトのコンテナ。選択したモデルを変更することはできません |
metadata.input |
object | 任意 | ネイティブの input オブジェクト |
metadata.input.prompt |
string | 任意 | ネイティブの prompt 上書き。必須のトップレベル prompt は保持してください |
metadata.input.media |
object[] | 任意 | 順序付きメディア配列。各項目には type と url が必要です。制限は後述します |
metadata.input.media[].type |
string | 項目ごとに必須 | first_frame、last_frame、reference_image、reference_video、reference_audio、file、link |
metadata.input.media[].url |
string | 項目ごとに必須 | 公開 HTTP(S) メディア URL。画像タイプは data:{MIME_type};base64,... 文字列も受け付けます。画像以外のメディアには公開 URL が必要です |
metadata.parameters |
object | 任意 | ネイティブのパラメータオブジェクト。null にはできません |
metadata.parameters.resolution |
string | 1080P |
大文字の 480P、720P、1080P |
metadata.parameters.ratio |
string | adaptive |
上記と同じアスペクト比の値 |
metadata.parameters.duration |
integer | 5 |
2~30、または -1。合計時間の制約は同じです |
metadata.parameters.audio |
boolean | true(上流) |
出力音声スイッチは同じです |
metadata.parameters.prompt_extend |
boolean | true |
プロンプト書き換えスイッチは同じです。file/link では true が必要です |
metadata.parameters.watermark |
boolean | false(上流) |
ウォーターマークスイッチは同じです |
metadata.parameters.seed |
integer | ランダム | シード範囲は同じで、明示的な 0 も含みます |
ネイティブの negative_prompt、img_url、first_frame_url、last_frame_url、audio_url フィールドは Wan 3 のメディア制御ではありません。代わりにドキュメント記載の media 配列を使用してください。
メディアの制限と有効な組み合わせ
| メディア種別 | 数と制約 |
|---|---|
first_frame、last_frame |
それぞれ最大1件。last_frame には first_frame が必要です。フレーム制御は、参照、ファイル、リンクのいずれの種別とも組み合わせられません |
reference_image |
最大10件。JPEG/JPG、透過なしPNG、BMP、WEBP。各辺 240~8,000 ピクセル、アスペクト比は最大 8:1、各ファイル最大 20 MB |
reference_video |
最大5本の MP4/MOV クリップ。各 1~15 秒、合計入力は最大15秒。最低 16 fps。各辺 240~4,096 ピクセル、アスペクト比は最大 8:1、各ファイル最大 100 MB |
reference_audio |
最大5本の WAV/MP3 クリップ。各 1~15 秒、合計最大15秒。各ファイル最大 15 MB |
file |
DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD ファイルを最大1件。最大 100 MB。PDF、DOCX、DOC、PPTX、PPT、KEY/PAGES のページ付き文書は50ページ制限 |
link |
ログイン不要で公開アクセス可能なページを最大1件。file と組み合わせないでください |
参照画像、参照動画、参照音声は組み合わせ可能です。file または link は参照メディアに併用できます。first_frame/last_frame モードはフレーム制御のみを受け付けます。音声駆動生成には reference_image と reference_audio のモードを使用してください。メディア解析とコンテンツモデレーションは、引き続き上流のチェック対象です。
テキストから動画への生成では、メディアなしのプロンプトを使用します。first_frame アニメーションでは first_frame を使用し、トランジションでは first_frame と last_frame を使用します。参照生成では参照タイプを使用します。編集または拡張では、reference_video を指定し、編集または拡張内容をプロンプトで記述してください。拡張には adaptive を使用します。
例
テキストから動画
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
最初と最後のフレーム
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
参照画像と音声
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}
動画編集 / 延長とスマート duration
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
ドキュメント / Web ページ
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
すべてのサンプル URL を実際の公開メディアに置き換えてください。Web 入力の場合は、file 項目を {"type":"link","url":"https://example.com/product"} に置き換えてください。first_frame の例は、last_frame 項目なしでも動作します。
レスポンス、ポーリング、ダウンロード、ログ
作成時に返されるのは APIMaster のタスク ID であり、上流の ID ではありません:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| レスポンスフィールド | 意味 |
|---|---|
id / task_id |
クエリとダウンロードで使用されるプラットフォームのタスク識別子 |
status |
queued、in_progress、completed、failed |
progress |
進捗インジケーター。最終ステータスまで待機します |
error.code、error.message |
該当する場合の失敗情報 |
metadata.url |
完了時に返されるコンテンツの場所 |
同じ API キーを使用して約 15 秒ごとにポーリングします。進捗を確認するために別のタスクを作成しないでください。ネイティブプロバイダーのタスク ID と出力 URL は 24 時間後に期限切れになります。成功した結果は速やかにダウンロードして保持してください。一時的な上流の URL を保存するよりも、APIMaster の認証済みコンテンツエンドポイントを使用することをお勧めします。
curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4
使用状況ログにはタスクと成功した動画結果が含まれます。完了後に最終的な課金を確認してください。受理は生成成功の証明ではありません。ポーリングを繰り返しても、追加の生成料金は発生しません。
課金
秒単価はこちら モデルカード.
APIMaster はすべての入力動画の長さと出力動画の長さを合計し、合計を秒単位で一度だけ切り上げ、選択した出力解像度の秒単価を掛けます。入力 2.3 秒と出力 5 秒なら 8 秒分です。入力動画がない場合は出力時間だけが課金対象です。見積もりや入力時間の指定は不要です。生成に失敗した場合は仮押さえ分が返却されます。最終金額は使用ログで確認できます。
エラーと修正
| 症状 | 修正 |
|---|---|
| 無効な duration/resolution/ratio | 上記の enum と範囲を使用してください。smart duration は正確に -1 です |
| フレーム/参照の競合、最初のフレームなしの最後のフレーム | 組み合わせルールに従ってください |
| ファイル/リンクと無効化されたリライト | prompt_extend:true を設定してください |
| メディアの取得/フォーマット/長さの失敗 | サイズ、フォーマット、長さのすべての制約を満たす公開ファイルを使用してください |
| prompt の欠落 | APIMaster API のために空でないトップレベルの prompt を保持してください |
| タスクの失敗またはモデレーション | error を確認してからリクエストを修正してください。受理されたことを成功とみなさないでください |
