Skip to main content
POST
Image-to-video: create a video generation task from a first frame (+ optional driving audio)
右側のプレイグラウンドでは直接デバッグできます。AuthorizationBearer sk-your-api-key を入れ、model / input.media / parameters を入力して、リクエストを送信してください。正常に送信されると task_id が返ります。ポーリングとダウンロードについては以下をご覧ください。
このページは wan2.7-i2v(画像から動画への変換)の作成エンドポイントです。最初のフレーム + prompt を指定して画像に命を吹き込み、必要に応じて driving_audio を渡すと、ポートレートが音声の口の動きとリズムに追従します。完全な非同期フローについては、Wan の概要 をご覧ください。
  • オーディオドライブは wan2.7-i2v 専用です: HappyHorse i2vdriving_audio をサポートしていないため、リップシンク / ラップには wan2.7-i2v を使う必要があります。
  • input.media が必須です。そうでない場合、上流は image-to-video model ... must provide an image を返します。各メディア url は、GET で直接取得できる公開 https リンクでなければなりません。
  • 作成リクエストは /wan/api/v1/...X-DashScope-Async: enable で送信します。/v1/videos は使用しないでください。

コード例

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

media[] の値

レスポンス形式

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

task_id を取得したら、mp4 をポーリングしてダウンロードするには、次の 3 つの手順に従ってください。
  • ポーリング GET /v1/tasks/{task_id}Authorization を使用し、クエリには X-DashScope-Async ヘッダーは不要です)を 5〜10 秒ごとに(3 秒未満は不可)実行し、statuscompleted になるまで待ちます。
  • ステータス値: submitted(キュー中)/ in_progress(生成中; progress が 30% で止まっていることが多いのは正常です)/ completed(成功)/ 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-i2v
必須

Model ID; for image-to-video, fixed wan2.7-i2v (legacy version wan2.6-i2v)

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

レスポンス

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

:

"..."