Skip to main content
POST
Reference-to-video: create a video task that preserves subject features from reference images/videos
右側の Playground では、直接デバッグできます。Bearer sk-your-api-keyAuthorization に設定し、model / input.media / parameters を入力して、リクエストを送信してください。送信が成功すると、task_id が返ります。ポーリングとダウンロードについては下記をご覧ください。
このページは wan2.7-r2v(reference-to-video)の作成エンドポイントです。参照画像/動画を与えると、モデルがそれらの被写体(人物/動物/物体)とシーンの特徴を保持し、単一キャラクターの演技や複数キャラクターのインタラクションを生成します。さらに多くの参照画像(最大 9 枚)が必要な場合は、HappyHorse r2v を検討してください。非同期フロー全体については、Wan Overview をご覧ください。
  • Reference-asset citation convention: プロンプト内では、reference_image を指すときに “image 1 / image 2” を、reference_video を指すときに “video 1 / video 2” を使い、media 配列と同じ順序にしてください(画像と動画は別々に数えます)。画像/動画が 1 つだけの場合は、単に “the reference image” / “the reference video” と書けます。
  • Count limits: reference_image + reference_video の合計 ≤5; first_frame は最大 1 つです。
  • Creation requests are sent to /wan/api/v1/... with X-DashScope-Async: enable; /v1/videos は使用しないでください。

コード例

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

media[] の値

レスポンス形式

状態を確認してダウンロード

task_id を取得したら、次の 3 つの手順でステータスをポーリングし、mp4 をダウンロードします:
  • ポーリング GET /v1/tasks/{task_id}Authorization を使用し、クエリには X-DashScope-Async ヘッダーは不要)、10 秒ごと(3 秒未満は不可)に、statuscompleted になるまで実行します。Reference-to-video は通常 1〜5 分かかるため、フォールバックとしてクライアントのタイムアウトを 20 分に設定してください。
  • ステータス値: 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-r2v
必須

Model ID; for reference-to-video use wan2.7-r2v (legacy versions wan2.6-r2v / wan2.6-r2v-flash)

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

レスポンス

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

:

"..."