Skip to main content
POST
Video edit: create an edit task from a video + reference images + instruction
右側の Playground では直接デバッグできます: Bearer sk-your-api-keyAuthorization に入れ、model / input.media / parameters を入力して、リクエストを送信します。送信が成功すると task_id が返されます。ポーリングとダウンロードについては下記を参照してください。
このページは wan2.7-videoedit(動画編集)の作成エンドポイントです。動画 + 1〜5 枚の参照画像 + 自然言語の編集指示を与えて、衣装や背景の差し替えなどの動画要素を編集します。モデル名にはハイフンがありませんvideoedit)。非同期フロー全体については、Wan 概要を参照してください。
  • input.media には、編集対象の video と少なくとも 1 つの reference_image(参照アセット、≤5)の両方を含める必要があります。
  • モデル名は wan2.7-videoeditハイフンなし)で、HappyHorse の happyhorse-1.0-video-edit(ハイフンあり)とは異なるため、混同しないでください。
  • 作成リクエストは /wan/api/v1/...X-DashScope-Async: enable を付けて送ります。/v1/videos は使用しないでください。

コード例

パラメータとメディアのクイックリファレンス

media[] の値

動画編集の出力尺は入力動画に従い、durationパラメータではなく、そのためこの機能では通常durationを渡しません。

応答形式

ステータス確認とダウンロード

task_id を入手したら、ステータスをポーリングして mp4 をダウンロードするには、次の 3 ステップに従います:
  • ポーリング GET /v1/tasks/{task_id}Authorization 付き。クエリには X-DashScope-Async ヘッダーは不要です)を、5〜10 秒ごと(3 秒未満は不可)に実行し、statuscompleted になるまで続けます。
  • ステータス値: submitted(queued)/ in_progress(generating; progress が 30% で止まっていることが多いのは正常です)/ completed(success)/ failederror を確認)。
  • ダウンロード: レスポンスから result_url を直接 GET します。Authorization ヘッダーなしで(これは OSS の署名付き直接リンクです — Auth を送ると 403 が返ります)。result_url は既定で 24 時間 で期限切れになるため、すぐに保存してください。
上記は、「すでに task_id がある」場合のチェック/ダウンロード用のクイックパスです。タイムアウトのフォールバックを含む完全なポーリングループと Python クライアントについては、Wan の概要 · 非同期呼び出しフロー を参照してください。

承認

Authorization
string
header
必須

The API Key obtained from the APIYI console

ヘッダー

X-DashScope-Async
enum<string>
デフォルト:enable
必須

Async processing switch; must be set to enable

利用可能なオプション:
enable

ボディ

application/json
model
enum<string>
デフォルト:wan2.7-videoedit
必須

Model ID, fixed wan2.7-videoedit (no hyphen)

利用可能なオプション:
wan2.7-videoedit
input
object
必須
parameters
object

レスポンス

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

:

"..."