Skip to main content
POST

認証

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

リクエストパラメータ

string
必須
動画生成モデル名。wan2.7-videoedit で固定
array<string>
必須
編集対象の元動画URL配列
最初の 1 本のみ使用されます
動画の制限:
  • フォーマット:mp4、mov
  • 長さ:2〜10秒
  • 解像度:幅・高さともに [240, 4096] ピクセルの範囲
  • アスペクト比:1:8 〜 8:1
  • ファイルサイズ:100MB 以下
string
編集指示。動画にどのような変更を加えたいかを記述、最大 5000 文字
未指定の場合、モデルはデフォルトのスタイル転送を実行します
例:"人物の衣装を赤いドレスに変える""背景を雪山のシーンに差し替える"
string
出力に含めたくない内容を表すネガティブプロンプト。最大 500 文字まで。
array<string>
参考画像URLの配列。最大 4 枚ターゲットのスタイルや外観の指定に使用(スタイル転送の参考スタイルなど)
string
デフォルト:"1080P"
出力動画の解像度選択肢:
  • 720P - 標準
  • 1080P - 高解像度(デフォルト)
integer
デフォルト:"0"
出力動画の長さ(秒)
  • 0(デフォルト):元動画の全長を保持
  • 2-10 の整数:先頭から指定時間を切り出し
duration=0 の場合、出力動画の実時間で課金されます指定する時間は video_urls の元動画の長さを超えることはできません
string
出力画面のアスペクト比対応フォーマット:
  • 16:9 - 横向きワイド
  • 9:16 - 縦向き
  • 1:1 - 正方形
  • 4:3 - 横向き
  • 3:4 - 縦向き
未指定の場合、入力動画のアスペクト比に従います
boolean
デフォルト:"true"
プロンプトのインテリジェントな書き換えを有効にするか短いプロンプトで効果が顕著ですが、処理時間が増加しますデフォルト:true
boolean
デフォルト:"false"
生成された動画に “AI生成” ウォーターマークを追加するか
  • true:ウォーターマークを追加
  • false:追加しない(デフォルト)
integer
生成内容のランダム性を制御するシード整数範囲:≥0 の整数
  • 同一リクエストで異なるseed値を受け取ると(seedを指定しない場合など)、異なる結果が生成されます
  • 同一リクエストで同じseed値を受け取ると、類似した結果が生成されますが、完全一致は保証されません
object
追加パラメータオブジェクト

レスポンス

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

使用例

例 1:基本動画編集(最小)

例 2:スタイル転送(参考画像付き)

例 3:元動画の音声を保持

重要なBGMや人物の対話がある動画に適します:

例 4:フルパラメータ

音声処理の説明

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