`Wan - reference-to-video` モデルは、テキスト、画像、動画などのマルチモーダル入力に対応しており、1 人または複数のキャラクターが登場する動画を生成します。シングルキャラクターのパフォーマンスや、複数キャラクターがインタラクションするシーンの生成が可能です。また、マルチショット動画のインテリジェントなショット分割もサポートしています。
リファレンス:ユーザーガイド
利用可能リージョン
API 呼び出しを正常に実行するには、モデル、エンドポイント URL、API キーが同じリージョンに属している必要があります。リージョンをまたいだ呼び出しは失敗します。
モデルの選択:対象リージョンでモデルが利用可能であることを確認します。
URL の選択:対応するリージョンのエンドポイント URL を選択します。HTTP と HTTPS の両方がサポートされています。
このトピックのサンプルコードは、シンガポールリージョンに適用されます。
HTTP
`reference-to-video` タスクは時間がかかるため (通常 1~5 分)、API は「タスクの作成 → 結果のポーリング」の 2 つのステップからなる非同期呼び出しを使用します。
ステップ 1:タスクの作成
シンガポール
POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
バージニア
POST https://dashscope-us.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
北京
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
タスクが作成された後は、返された
task_idを使用して結果をクエリします。task_idは 24 時間有効です。重複タスクを作成しないでください。代わりに、ポーリングを使用して結果を取得します。初心者向けのチュートリアルについては、「Postman」をご参照ください。
リクエストパラメーター | 複数キャラクターのインタラクション (参照画像と動画)マルチショット動画を生成するには、 複数キャラクターのインタラクション (参照動画)複数の動画 URL を 単一文字ロールの仮定単一の動画URLを サイレントビデオの生成
サイレント動画を生成するには、 |
リクエストヘッダー | |
Content-Type リクエストのコンテンツ タイプ。 | |
Authorization Model Studio API キーを使用した認証情報です。 例: | |
X-DashScope-Async 非同期処理を有効にします。HTTP リクエストは非同期処理のみをサポートするため、 重要 このヘッダーを含めないと、「current user api does not support synchronous calls」というエラーが返されます。 | |
リクエストボディ | |
model モデル名です。モデルのリストとその料金については、「モデルの料金」をご参照ください。 例:wan2.6-r2v-flash | |
input プロンプトを含む基本的な入力情報です。 | |
parameters 動画の解像度、プロンプトの再書き込み、ウォーターマークのパラメーターです。 |
レスポンスパラメーター | 成功時のレスポンスタスクのステータスと結果を照会するために、 エラーレスポンスタスクの作成に失敗しました。エラーコードを参照して問題を解決してください。 |
output タスクの出力です。 | |
request_id リクエストの一意の識別子です。問題の追跡とトラブルシューティングに使用します。 | |
code エラーコードです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 | |
message 詳細なエラーメッセージです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 |
ステップ 2:結果のクエリ
シンガポール
GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}
バージニア
GET https://dashscope-us.aliyuncs.com/api/v1/tasks/{task_id}
北京
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
ポーリングの推奨事項:動画の生成には数分かかる場合があります。15 秒などの妥当なクエリ間隔でポーリングメカニズムを使用して結果を取得することを推奨します。
タスクステータスの遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
結果の URL:タスクが成功すると、動画の URL が返されます。URL は 24 時間有効です。URL を取得した後、すぐに動画をダウンロードし、Object Storage Service (OSS) などの永続的なストレージサービスに保存する必要があります。
task_id の有効期間: 24 時間。この期間が過ぎると、結果をクエリできなくなり、API はタスクのステータスとして
UNKNOWNを返します。
リクエストパラメーター | タスク結果のクエリ
|
リクエストヘッダー | |
Authorization Model Studio API キーを使用した認証情報です。 例: | |
URL パスパラメーター | |
task_id クエリ対象のタスクの ID です。 |
レスポンスパラメーター | タスク成功動画 URL は 24 時間のみ保持され、その後自動的に消去されます。生成された動画は速やかに保存してください。 タスク失敗タスクが失敗すると、 タスククエリの期限切れ「 |
output タスクの出力です。 | |
usage 出力統計です。成功したタスクに対してのみカウントされます。 | |
request_id リクエストの一意の識別子です。問題の追跡とトラブルシューティングに使用します。 |
制限事項
データの有効性:
task_idおよび動画video_urlは 24 時間のみ保持されます。有効期限が切れると、クエリもダウンロードもできません。コンテンツモデレーション:入力プロンプトと出力動画の両方がコンテンツモデレーションの対象となります。非準拠のコンテンツを含むリクエストは、`IPInfringementSuspect` または `DataInspectionFailed` エラーを返します。詳細については、「エラーメッセージ」をご参照ください。
ネットワークアクセス設定:動画リンクは Object Storage Service (OSS) に保存されます。セキュリティポリシーにより、ご利用のシステムが外部の OSS リンクにアクセスできない場合は、次の OSS ドメインをネットワークアクセスのホワイトリストに追加してください。
# OSS ドメイン名リスト dashscope-result-bj.oss-cn-beijing.aliyuncs.com dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com dashscope-result-sh.oss-cn-shanghai.aliyuncs.com dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com dashscope-result-hy.oss-cn-heyuan.aliyuncs.com dashscope-result-cd.oss-cn-chengdu.aliyuncs.com dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーメッセージ」を参照して解決してください。