Wan リファレンス動画モデルは、 マルチモーダル入力 を受け付け、人物やオブジェクトを主人公として、単一キャラクターまたは複数キャラクターのインタラクション動画を生成します。
関連ドキュメント: ユーザーガイド
モデル、エンドポイント URL、API キーは同一リージョンに属している必要があります。リージョン間の呼び出しは失敗します。
動画生成タスクは通常 1~5 分かかります。API は、「タスクの作成 -> 結果のポーリング」の 2 つのステップからなる非同期呼び出しを使用します。詳細は以下の通りです:
SDK パラメーターは、HTTP API と同じ命名規則に従い、言語固有のラッパーでラップされています。
リファレンス動画タスクは通常 1~5 分かかります。SDK は HTTP の非同期ワークフローをラップし、同期呼び出しと非同期呼び出しの両方をサポートします。
モデルのリージョンに応じて
モデルのリージョンに基づいて
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、エラーコードをご参照ください。
利用可能リージョン
モデル、エンドポイント URL、API キーは同一リージョンに属している必要があります。リージョン間の呼び出しは失敗します。
- モデルの選択:モデルのリージョンを確認します。
- URL の選択:対応するリージョンのエンドポイント URL を使用します。HTTP URL がサポートされています。
- API キーの設定:リージョンを選択して API キーを取得 し、次に API キーを環境変数として設定 します。
このトピックのサンプルコードは、シンガポールリージョンに適用されます。
HTTP
動画生成タスクは通常 1~5 分かかります。API は、「タスクの作成 -> 結果のポーリング」の 2 つのステップからなる非同期呼び出しを使用します。詳細は以下の通りです:
ステップ 1:タスクの作成
- シンガポール
- 米国 (バージニア)
- フランクフルト
- 中国 (北京)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} を実際のワークスペース ID に置き換えてください。- タスクが作成されたら、返された
task_idを使用して結果をクエリしてください。task_idは 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。 - 初心者向けのガイダンスについては、「Postman または cURL を使用した API の呼び出し」をご参照ください。
リクエストパラメーターヘッダーContent-Typestring (必須)リクエストのコンテンツタイプは application/json である必要があります。Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストでは、非同期呼び出しのみがサポートされます。値は enable である必要があります。リクエストボディmodelstring (必須)使用するモデル。利用可能なモデルと料金については、「モデルの料金」をご参照ください。例:wan2.6-r2v-flash。input object (必須)プロンプトなどの入力パラメーター。
プロパティ prompt string (必須)生成される動画の望ましい要素と視覚的特徴を記述するテキストプロンプト。中国語と英語をサポートします。各文字は 1 文字としてカウントされます。制限を超えたコンテンツは自動的に切り捨てられます。
string (任意)動画に含めたくない要素を記述するネガティブプロンプト。中国語と英語をサポートします。最大長:500 文字。制限を超えたコンテンツは自動的に切り捨てられます。例:低解像度、エラー、最低品質、低品質、不完全、余分な指、不適切な比率など。reference_urls array[string] (必須)リファレンスファイルの URL の配列。動画と画像の両方の入力をサポートします。キャラクターの外見と音声 (利用可能な場合) を抽出して、リファレンスの特徴に一致する動画を生成するために使用されます。
非推奨 reference_video_urls array[string]リファレンス動画の URL の配列。キャラクターの外見と音声 (利用可能な場合) を抽出して、リファレンスの特徴に一致する動画を生成するために使用されます。
object (任意)解像度、プロンプトリライト、ウォーターマークなどの動画生成パラメーター。
プロパティ size string (任意)生成されるビデオの解像度は width*height フォーマットで、デフォルト値と利用可能なオプションは model パラメーターによって決まります。
integer (任意)生成される動画の持続時間 (秒)。
string (任意)生成される動画のショット構成。動画が単一の連続したショットで構成されるか、複数のショットで構成されるかを決定します。パラメーターの優先度は shot_type > prompt です。例えば、shot_type が "single" に設定されている場合、プロンプトに「multi-shot video を生成する」と記述されていても、モデルはシングルショットビデオを出力します。有効な値:
このパラメーターを使用して、プロダクトのショーケース用のシングルショットや、ストーリークリップ用のマルチショットなど、動画の物語構造をコントロールします。 boolean (任意)サポートされているモデル:wan2.6-r2v-flash。動画に音声を生成するかどうか。有効な値:
boolean (任意)ウォーターマークを追加するかどうか。ウォーターマークは右下隅に「AI-generated」というテキストで表示されます。
integer (任意)乱数シードは、[0, 2147483647] の範囲の整数である必要があります。指定しない場合、ランダムなシードが生成されます。シードを固定すると再現性が向上します。モデルの生成は確率的であるため、同じシードでも同一の結果が保証されるわけではありません。 |
reference_urls を介して画像と動画の URL を渡します。マルチショット動画の場合は、shot_type を multi に設定します。 |
レスポンスパラメーターoutputobjectタスクの出力。
プロパティ task_id stringタスク ID。24 時間クエリに対して有効です。task_status stringタスクのステータス。
列挙値
stringトレースとトラブルシューティングのための一意のリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
task_id を保存して、タスクのステータスと結果をクエリします。 |
ステップ 2:タスク結果の取得
- シンガポール
- 米国 (バージニア)
- フランクフルト
- 中国 (北京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} を実際のワークスペース ID に置き換えてください。- ポーリングの推奨事項:動画の生成には数分かかります。15 秒など、適切な間隔でポーリングメカニズムを使用してください。
- タスク状態の遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク:タスクが成功すると、24 時間有効な動画 URL が返されます。Object Storage Service (OSS) などの永続ストレージに動画をダウンロードして保存してください。
task_idの有効期間:24 時間。この期間を過ぎると、クエリはタスクステータスをUNKNOWNとして返します。
リクエストパラメーターヘッダーAuthorizationstring (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。パスパラメーターtask_idstring (必須)タスクの ID。 |
{task_id} を、前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間、クエリに対して有効です。{WorkspaceId} を、実際の ワークスペース ID に置き換えます。 |
レスポンスパラメーターoutputobjectタスクの出力。
プロパティ task_id string (必須)タスクの ID。task_status stringタスクのステータス。
列挙値
stringタスクが送信された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC + 08:00 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_url string生成された動画の URL。task_status が SUCCEEDED の場合にのみ返されます。24 時間有効です。動画は H.264 エンコーディングの MP4 フォーマットです。orig_prompt stringリクエストパラメーター prompt に対応する元の入力プロンプトです。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。object使用量統計。成功した結果のみをカウントします。
プロパティ input_video_duration integer入力リファレンス動画の持続時間 (秒)。output_video_duration integer出力動画の持続時間 (秒)。duration float合計動画持続時間。課金はこの値に基づきます。式:duration = input_video_duration + output_video_duration。SR integer生成された動画の解像度ティア。例:720。size string生成された動画の解像度。width*height 形式。例:1280*720。video_count integer生成された動画の数。常に 1 です。stringトレースとトラブルシューティングのための一意のリクエスト識別子。 |
動画 URL は 24 時間のみ有効で、その後自動的に削除されます。生成された動画は速やかに保存してください。 |
DashScope SDK
SDK パラメーターは、HTTP API と同じ命名規則に従い、言語固有のラッパーでラップされています。
リファレンス動画タスクは通常 1~5 分かかります。SDK は HTTP の非同期ワークフローをラップし、同期呼び出しと非同期呼び出しの両方をサポートします。
実際の処理時間は、タスクキューとサーバーの負荷によって異なります。
Python
モデルのリージョンに応じて region を設定します(Client 構築時に渡します。リージョンによって region の値は異なります):
- シンガポール
- 中国 (北京)
- フランクフルト
region="ap-southeast-1"{WorkspaceId} を実際のワークスペース ID に置き換えてください。- 同期
- 非同期
同期呼び出しは、動画の生成が完了して結果が返されるまでブロックします。
リクエストの例
Java
モデルのリージョンに基づいて baseHttpApiUrl を設定します。
- シンガポール
- 中国 (北京)
- フランクフルト
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} を実際のワークスペース ID に置き換えます。- 同期
- 非同期呼び出し
同期呼び出しは、動画の生成が完了し、結果が返されるまでブロックします。