メインコンテンツへスキップ
POST

認証

Authorization
string
必須
すべてのAPIエンドポイントでBearer Token認証が必要ですAPIキーの取得:APIキー管理ページからAPIキーを取得してくださいリクエストヘッダーに追加:

モードルーティング

wan2.7 はテキストから動画および画像から動画の統一エンドポイントです。バックエンドは受信したパラメータに基づいて自動的にモードを判定します。両モードの料金は同一です

リクエストパラメータ

model
string
必須
動画生成モデル名。wan2.7 で固定
prompt
string
動画内容の説明、最大 5000 文字
  • テキストモード(画像/動画なし):必須
  • 画像モード:任意だが、カメラワークやアクションの指示のため推奨
例:"猫が草原で蝶を追いかける、晴天、スローモーション"
image_urls
array<string>
画像URLの配列。指定すると自動的に画像モードに入ります
  • 1 枚:先頭フレームから動画
  • 2 枚:先頭・最終フレームから動画(1枚目が先頭、2枚目が最終)
image_with_roles とどちらか一方を使用
image_urlsaudio_url は競合するため、同時に指定することはできません
image_with_roles
array<object>
ロール付き画像の配列。image_urls の代わりに使用し、各画像のロールを精密に指定各オブジェクトのフィールド:
  • url (string):画像URL(http/httpsに対応)
  • role (string):画像ロール、first_frame(先頭フレーム)/ last_frame(最終フレーム)、デフォルト first_frame
例:
image_with_rolesaudio_url は競合するため、同時に指定することはできません
video_urls
array<string>
動画URLの配列。指定すると動画継続モードに入ります(最初の1本のみ使用)
video_urlsaudio_url は競合するため、同時に指定することはできません
動画の制限:
  • フォーマット:mp4、mov
  • 長さ:2〜10秒
  • 解像度:幅・高さともに [240, 4096] ピクセルの範囲
  • アスペクト比:1:8 〜 8:1
  • ファイルサイズ:100MB 以下
negative_prompt
string
ネガティブプロンプト。含めたくない内容を記述、最大 500 文字例:"ぼやけ、歪み、低品質"
resolution
string
デフォルト:"1080P"
動画解像度選択肢:
  • 720P - 標準
  • 1080P - 高解像度(デフォルト)
duration
integer
デフォルト:"5"
動画の長さ(秒)対応範囲:215デフォルト:5
size
string
デフォルト:"16:9"
画面のアスペクト比。テキストモードのみ有効(画像/動画なしの場合)対応フォーマット:
  • 16:9 - 横向きワイド(デフォルト)
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
画像モードではこのパラメータは無視され、アスペクト比は入力画像により自動決定されます
audio_url
string
カスタムオーディオURL
  • テキストモード:動画のBGMとして使用
  • 画像モード:駆動音声として使用、画面のアクションに同期
形式:wav / mp3、長さ2〜30秒、ファイルサイズ≤15MB
audio_urlvideo_urlsimage_urlsimage_with_roles と競合するため、これらと同時に指定することはできません
prompt_extend
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするか短いプロンプトで効果が顕著ですが、処理時間が増加しますデフォルト:true
watermark
boolean
デフォルト:"false"
生成された動画に “AI生成” ウォーターマークを追加するか
  • true:ウォーターマークを追加
  • false:追加しない(デフォルト)
seed
integer
生成内容のランダム性を制御するシード整数範囲:≥0 の整数
  • 同一リクエストで異なるseed値を受け取ると(seedを指定しない場合など)、異なる結果が生成されます
  • 同一リクエストで同じseed値を受け取ると、類似した結果が生成されますが、完全一致は保証されません

レスポンス

code
integer
レスポンスステータスコード。成功時は 200
data
array
レスポンスデータ配列

使用例

例 1:テキストから動画(最小リクエスト)

例 2:テキストから動画(フルパラメータ)

例 3:先頭フレームから動画

例 4:先頭・最終フレームから動画

2枚指定の場合:1枚目が先頭フレーム、2枚目が最終フレーム。image_with_roles で精密指定も可能。

例 5:動画継続

例 6:画像 + 駆動音声

モード選択ガイド

タスク結果の取得動画生成は非同期タスクで、送信時に task_id が返されます。タスクステータス取得 エンドポイントで生成進捗と結果を取得してください。