Skip to main content
POST
Reference-to-Video: create a video task with up to 9 reference images to preserve the subject
右側の Playground で直接デバッグできます。AuthorizationBearer sk-your-api-key を入力し、model / input.media / parameters を設定してから、リクエストを送信してください。正常に送信されると task_id が返ります。ポーリングとダウンロードについては下記を参照してください。
このページでは、happyhorse-1.1-r2v(Reference-to-Video)の create エンドポイントを扱います。参照画像を指定すると、モデルはその中の被写体とシーンの特徴を保持します。HappyHorse-r2v は最大 9 枚の参照画像をサポートしており、複数参照のシナリオでより高い被写体一貫性を実現します。非同期フローの全体については、HappyHorse の概要 を参照してください。
  • happyhorse-1.1-r2v9 件までの reference_image エントリをサポートします(Wan2.7-r2v の合計 5 件以下より多いです)。
  • input.media が必要です。また、メディア url は、GET で直接取得できる公開 https リンクである必要があります。
  • create リクエストは /wan/api/v1/... に、X-DashScope-Async: enable とともに送信します。/v1/videos は使用しないでください。

コード例

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

media[] の値

レスポンス形式

送信後、GET /v1/tasks/{task_id} をポーリングして completed まで待ち、その後 result_url から mp4 をダウンロードします(Authorization ヘッダーなしで、24 時間後に期限切れになります)。完全なポーリングループは HappyHorse 概要 · 非同期呼び出しフロー を参照してください。

承認

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>
デフォルト:happyhorse-1.1-r2v
必須

Model ID, fixed to happyhorse-1.1-r2v for Reference-to-Video

利用可能なオプション:
happyhorse-1.1-r2v
input
object
必須
parameters
object

レスポンス

Task submitted, returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

:

"..."