Wan 3.0 Video Prime API

APIMaster の非同期動画 API を通じて wan3.0-video-prime を使用します。現在の連携では 480P / 720P / 1080P、2～30 の整数秒、1 タスクにつき 1 本の動画を提供します。パラメータと連携のレビュー日: 2026-10-26。

エンドポイントと認証

操作	メソッドと URL
作成	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 を使用します。Alibaba Cloud のキーではなく、APIMaster の API キーを使用してください。APIMaster が上流の非同期ヘッダーを付与するため、X-DashScope-Async は不要です。

互換性のある作成エンドポイント /videos/generations は異なるレスポンスエンベロープを返します。以下の例では一貫して /videos を使用します。

現在のルート機能

現在、このモデルを提供する連携は Alibaba Cloud ネイティブルートと GMI ルートの 2 つです。高度なフィールドには対応するルートが必要であり、フィールドを送信してもそのルートが選択されるわけではありません。ルート固有の例を使用する前に、API キーがどのルートにアクセスできるかを確認してください。

機能	Alibaba Cloud ネイティブ	GMI
テキストから動画、先頭フレーム、先頭/末尾フレーム、参照画像	対応済み	対応済み（メディアフィールドが異なる）
参照音声	metadata.input.media	audio_url
ドキュメント / 公開 Web ページ	ネイティブのメディアフィールドは転送される。完了した生成チェックの対象外	非対応
参照動画、編集、延長	送信前にブロック	非対応
自動時間指定 -1	ブロック	ブロック
アスペクト比 21:9	受け入れ	拒否
明示的な音声スイッチ	generate_audio / audio	非対応。これらのフィールドは省略
プロンプト書き換えの無効化 / 固定シード 0	現在のシリアライズでは prompt_extend: false や seed: 0 が保持されない。これらに依存しないこと	明示的な false と 0 は保持される

2026-10-24 の受け入れチェックでは、ネイティブルートの 5 秒 720P サイレント動画が完了し、ダウンロードとデコードに成功しました。その他のメディアの組み合わせについては、生成テスト済みの組み合わせとして提示するのではなく、アダプターと公式契約に基づいて説明しています。ルートの可用性と価格は変更される可能性があります。モデルカードを参照してください。

共通リクエストパラメータ一覧

これらのフィールドはトップレベルで送信します。最大限の互換性を得るには、明示的な duration、resolution、aspect_ratio と、5,000 文字以内の空でないプロンプトを使用し、ルート固有のオプションは省略してください。

フィールド	型	必須 / デフォルト	APIMaster の動作
model	string	必須	正確に wan3.0-video-prime
prompt	string	両ルートで必須	画像生成時も含め空でないこと。GMI は 1～5,000 文字を検証し、ネイティブアダプターは空でないテキストを要求します。公式ネイティブの上限は 20,000 ですが、ルート間でその高い上限に依存しないでください
duration	integer	5	2～30 秒。-1、小数、自動時間指定は不可
seconds	string	任意	文字列エイリアス（例: "5"）。両方指定する場合は duration と一致していること
resolution	string	720P	480P、720P、1080P。トップレベルの小文字値は正規化されます。この APIMaster のデフォルトは公式ネイティブのデフォルトとは異なります
aspect_ratio	string	16:9	一般的な値: adaptive、16:9、9:16、1:1、4:3、3:4。21:9 はネイティブルートのみ
ratio	string	任意	aspect_ratio のエイリアス。1 つのフィールドのみ使用し、競合する値を送信しないこと
size	string	任意	1280x720 などの寸法エイリアス。ルート固有の検証が適用されます。resolution と aspect_ratio を推奨。GMI では短辺が解像度ティアと一致する必要があり、ネイティブはサポートされる寸法マッピングのみ受け入れます
input_reference	string	任意	先頭フレーム画像 URL。ルート間の互換性のため、公開ダウンロード可能な HTTP(S) URL を使用してください。他の先頭フレーム入力と組み合わせないこと
prompt_extend	boolean	ネイティブ true。GMI は省略時にプロバイダーのデフォルトのまま	プロンプト書き換え。ネイティブは現在 false で確実に無効化できません。GMI は明示的な boolean を転送します
watermark	boolean	公式ネイティブのデフォルト false。GMI は省略時にプロバイダーのデフォルトのまま	ウォーターマークスイッチ
seed	integer	省略時はランダム	移植可能な固定範囲: 1～2147483647。ネイティブはランダム用に -1 も受け入れますが、ネイティブの 0 はシリアライズ時に省略されます。GMI は 0～2147483647 を受け入れ、-1 を拒否します。固定シードは同一出力を保証しません

ネイティブの寸法エイリアスは、一般的な横向き/縦向きの場合、832x480、480x832、1280x720、720x1280、1920x1080、1080x1920 です。一部の正方形寸法マッピングは 1:1 に縮小されますが、他のマッピングされた寸法はアスペクト比の検証で失敗する可能性があります。任意の寸法を要求するために size を使用しないでください。

ルート固有のパラメータテーブル

GMI フィールド

これらは共通テーブルに加えてトップレベルで指定するフィールドです。GMI アダプターは認識されないフィールドを拒否します（metadata、images、image_urls、audio、generate_audio、video_urls、reference_video を含む）。

フィールド	型	必須 / デフォルト	動作
negative_prompt	string	任意	最大 500 文字
first_frame	string	任意	公開 HTTP(S) 画像 URL。input_reference の代替
last_frame	string	任意	公開 HTTP(S) 末尾フレーム画像 URL。先頭フレームも指定すること
reference_image	string または string[]	任意	1～10 個の公開 HTTP(S) 参照画像 URL。複数画像には配列を使用
audio_url	string	任意	公開 HTTP(S) 参照音声 URL。プロバイダーのメディア検証の対象

1 つのリクエストではフレーム制御または参照画像のいずれかを使用してください。ネイティブの metadata.input.media は GMI でこれらのフィールドに変換されません。

Alibaba Cloud ネイティブフィールド

ネイティブの構造化入力は metadata 内に配置します。公式の input や parameters オブジェクトをトップレベルに直接送信することは APIMaster の契約ではありません。必須のトップレベル prompt は常に保持してください。

フィールド	型	必須 / デフォルト	動作
generate_audio	boolean	公式ネイティブのデフォルト true	出力に音声トラックを含めるかどうか。false は保持されます
audio	boolean	任意	generate_audio のエイリアス。1 つのみ指定すること
images	string[]	任意	reference_image メディアエントリに変換されます。順序付きの先頭/末尾フレームではありません。input_reference と組み合わせないこと
metadata	object	任意	ネイティブの input と parameters をラップします。model は変更できません
metadata.input	object	任意	ネイティブ入力コンテナ
metadata.input.prompt	string	任意	ネイティブプロンプトの上書き。トップレベルのプロンプトのみを推奨
metadata.input.media	object[]	任意	ネイティブメディアコレクション。各項目に type と url を含めること
metadata.input.media[].type	string	項目ごとに必須	first_frame、last_frame、reference_image、reference_audio、file、link。reference_video は現在拒否されます
metadata.input.media[].url	string	項目ごとに必須	メディアの場所。公開 HTTP(S) URL を推奨。公式 OSS 一時 URL には別途有効な上流アップロードコンテキストが必要ですが、APIMaster はそのアップロードコンテキストを提供しません
metadata.parameters	object	任意	ネイティブパラメータコンテナ。null であってはなりません
metadata.parameters.resolution	string	720P	大文字の 480P、720P、1080P
metadata.parameters.ratio	string	16:9	adaptive や 21:9 を含むネイティブのアスペクト比
metadata.parameters.duration	integer	5	2～30。-1 は不可
metadata.parameters.audio	boolean	公式ネイティブのデフォルト true	出力音声スイッチ
metadata.parameters.prompt_extend	boolean	true	file / link では true のままである必要があります。明示的な false には上記のシリアライズ制限があります
metadata.parameters.watermark	boolean	公式ネイティブのデフォルト false	ウォーターマークスイッチ
metadata.parameters.seed	integer	ランダム	-1 または 0～2147483647。0 には上記のシリアライズ制限があります

トップレベルのネイティブオプションは対応するメタデータパラメータを上書きします。トップレベルの input_reference はネイティブメディア配列を置き換えます。input_reference が存在しない場合、images は参照画像エントリを追加します。意図しない上書きを避けるため、1 つの入力スタイルと 1 つのパラメータスタイルを使用してください。ネイティブの input 内でレガシーの img_url、first_frame_url、last_frame_url、audio_url を使用しないでください。アダプターは Wan 3.0 に対してこれらのレガシーメディアフィールドを拒否します。

メディア制約

以下の公式ネイティブメディアルールはプロバイダー側の検証も説明しています。アダプターが URL を受け入れることは、メディアが有効であることを証明しません。

メディア	制限 / 連携の注意事項
先頭 / 末尾フレーム	それぞれ最大 1 つ。末尾フレームには先頭フレームが必要です。フレーム制御と reference_image を混在させないでください
参照画像	最大 10 個。JPEG/JPG、透過なし PNG、BMP または WEBP。各辺 240～8,000 px、アスペクト比最大 8:1、画像あたり最大 20 MB
参照音声	ネイティブ: 最大 5 個、WAV/MP3、各 1～15 秒、合計最大 15 秒、ファイルあたり最大 15 MB。GMI は 1 つの audio_url を公開します
ファイル / Web ページ	ネイティブのみ: 最大 1 つのファイルまたは 1 つの公開読み取り可能ページ。file と link を組み合わせないでください。公式ファイル形式: DOCX、DOC、XLSX、XLS、PPTX、PPT、PDF、TXT、KEY、PAGES、NUMBERS、MD。最大 100 MB、該当するページ形式では 50 ページ制限。prompt_extend: true を維持してください
参照動画	公式には利用可能ですが、現在 APIMaster ネイティブの課金検証によりブロックされています。GMI では公開されていません。ここでは公式 API の動画編集や延長の例を使用しないでください

公式ネイティブのメディア合計上限は 20 項目です。個別および組み合わせの制限は引き続き適用されます。画像 Base64 データ URL は公式ネイティブ入力形式の一部ですが、GMI の URL 検証では受け入れられません。ルート間ではダウンロード可能な HTTP(S) URL を推奨します。

例

テキストから動画、共通フィールド

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

先頭フレーム、共通フィールド

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

GMI の先頭 / 末尾フレーム

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

ネイティブの先頭 / 末尾フレームとサイレント出力

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"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-prime","prompt":"Animate the character in image 1, with the mood 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"}]}}}

例のメディア URL を実際の公開ファイルに置き換えてください。ルート固有の例には一致するルートが必要であり、上流の組み合わせチェックの対象となります。

レスポンス、ポーリング、ダウンロード

作成時は APIMaster タスク ID が返されます。例:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

フィールド	意味
id / task_id	APIMaster タスク識別子。上流のタスク識別子ではありません
status	queued、in_progress、completed、failed
progress	報告される進捗。完了を保証するものではありません
error.code / error.message	該当する場合の失敗の詳細
metadata.url	完了時に返される認証済みコンテンツアドレス

同じ API キーを使用して 10～20 秒ごとに終了ステータスまでポーリングしてください。作成の成功は受け入れられたことのみを意味します。生成には数分かかる場合があります。支払い済みタスクを繰り返し作成するのではなく、受け入れられたタスクをポーリングしてください。

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 wan-prime.mp4

完了した動画は速やかにダウンロードして保存してください。上流の結果 URL は期限切れになる可能性があります。ポーリングを繰り返しても追加の生成課金は発生しません。

課金とよくあるエラー

課金は要求された解像度に応じた秒単位で、ルート/アカウントの価格はモデルカードに表示されます。送信時には推定料金が予約されます。ネイティブの完了時は返された課金対象時間と送信時に固定された価格が使用され、GMI は予約時間の契約に従います。失敗したタスクでは生成の予約が解放/返金されます。音声オフは安価なティアを意味しません。最終金額は使用ログで確認してください。

エラー / 症状	対処
duration must be an integer from 2 to 30	明示的な整数を使用してください。-1 は連携されていません
unsupported Wan request field ...	GMI でサポートされていないフィールドを削除するか、一致するネイティブルートへのアクセスを確認してください
unsupported aspect ratio	一般的な比率を使用してください。21:9 にはネイティブルーティングが必要です
reference video requires an input-duration quote	参照動画を削除してください。この機能は現在ブロックされています
prompt is required / メディア取得の失敗	トップレベルのテキストを追加してください。公開ダウンロード可能で有効なメディアを使用してください
prompt_extend: false または seed: 0 がネイティブで効果がない	現在のシリアライズ制限です。正のシードを使用し、書き換えの無効化に依存しないでください

出典: 公式モデル情報、公式ネイティブ API リファレンス、公式使用ガイド。公式の機能は、同じフィールドがすべての APIMaster ルートで公開されていることを意味しません。