wan3.0-video-prime API

正確なモデル ID wan3.0-video-prime を使用します。モデル フィールドはこのページと正確に一致する必要があります。

サンプル出力wan3.0-video-primePOST /v1/videos5.0s

パラメータ: duration=5resolution=1080Pratio=16:9

プロンプト： A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.

このサンプルを作成したリクエスト

{
  "model": "wan3.0-video-prime",
  "prompt": "A smooth gimbal shot glides through a sunlit modern living room with concrete walls, warm oak furniture and floor-to-ceiling windows overlooking a pine forest. Dust motes float in the light beams, curtains move gently. Architectural visualization quality, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

認証とエンドポイント

https://modelflare.dev/v1 で Modelflare API キーを使用します。ゲートウェイのエントリ ポイントは POST /v1/videos です。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

タスクの作成

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

ポーリングとダウンロード

タスクIDを保存します。 GET /v1/videos/{task_id} をポーリングし、GET /v1/videos/{task_id}/content でダウンロードします。結果 URL は有効期限が切れている可能性があるため、速やかにファイルを転送してください。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

リクエストメモ

Wan は一般的に input と parameters を使用します。フレームガイドモードとリファレンスメディアモードを混合してはなりません。

リクエストパラメータ

Wan3.0 は input.prompt または input.media を使用し、parameters で出力制御します。メディアは、フレーム、参照、オーディオ、ファイル、または Web ページを表す場合があります。

フィールド	必須	注意事項
model	はい	wan3.0-video-prime
input.prompt	条件付き	これを指定するか、input.media
input.media[]	条件付き	first_frame``last_frame``reference_*``file``link
parameters.resolution	いいえ	480P / 720P / 1080P (デフォルトは1080P)
parameters.ratio	いいえ	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	いいえ	2 ～ 30 秒、または -1 自動持続時間
parameters.audio	いいえ	同期音声を生成するかどうか
parameters.prompt_extend	いいえ	この専用モデル契約で必要な場合は false を設定します
parameters.seed	いいえ	オプションのランダムシード
parameters.watermark	いいえ	ウォーターマークを入れるかどうか

入出力制限

Wan3.0 は、テキスト、最初/最後のフレーム、最大 10 個の参照画像、5 つの参照ビデオ、5 つの参照オーディオ クリップ、および 1 つのファイルまたは Web ページ入力をサポートします。出力は 480P、720P、または 1080P、2 ～ 30 秒、または -1 自動タイミングです。最初/最後のフレーム、参照メディア、ファイル、Web ページは、input.media[].type によって選択される相互に排他的なワークフローです。

文書化されたワークフローの例

Wan3.0 は、テキスト、フレーム ガイダンス、参照メディア、ファイル、および Web ページに 1 つの input/parameters エンベロープを使用します。これらのワークフローは相互に排他的です。

最初と最後のフレーム

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

参考メディア

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

エラーと失敗したタスク

無効なモデル パラメーターは、リクエスト ID を含む 4xx を返します。非同期タスクは、作成が成功した後に失敗することもあります。ポーリング応答からの error_code と error_message を最終タスク理由として使用します。異なる JSON 形式で同じリクエストを再試行しないでください。

サポート範囲

このページでは、Modelflare モデルの生成と編集呼び出しについて説明します。検索またはマップのエンリッチメント、音声管理、および要素ライブラリ管理は、このパブリック モデル呼び出しサーフェスの外部にあるリソース API であり、必須のリクエスト フィールドではありません。

価格設定と請求

動画秒単位課金モデルです。現在の顧客価格、参考定価、完全な仕様については、モデル価格ページを参照してください。

ノート

このページでは、Modelflare のパブリック インターフェイスについて説明します。ここに示されているフィールドと制限は現在の契約です。

バリアント

モデルID	違い
wan3.0-video-prime	このページに記載されているモデル。