APIMaster.ai

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 を確認してからリクエストを修正してください。受理されたことを成功とみなさないでください