Wanxiang-リファレンス動画モデルは、テキスト、画像、動画などのマルチモーダル入力をサポートします。人物または物体を主役とした単一キャラクターのパフォーマンスや、複数キャラクター間のインタラクションを生成できます。また、インテリジェントなシーンセグメンテーション機能により、マルチショット動画の作成も可能です。
関連ドキュメント: ユーザーガイド
適用範囲
API 呼び出しを正常に実行するには、モデル、エンドポイント URL、API キーがすべて同一リージョンに属していることを確認してください。クロスリージョン呼び出しは失敗します。
モデルの選択: ご利用のモデルのリージョンを確認します。
URL の選択: 対応するリージョンのエンドポイント URL を選択します。HTTP URL をサポートしています。
API キーの構成: リージョンを選択し、API キーを取得します。その後、API キーを環境変数として構成します。なお、この方法は非推奨となっており、今後は API キーの構成に統合されます。
このトピックのサンプルコードは、シンガポール リージョンに適用されます。
HTTP 呼び出し
リファレンス動画タスクは処理に時間がかかるため(通常 1~5 分)、API では非同期呼び出しが採用されています。完全なワークフローは、以下の 2 つのコアステップで構成されます:タスクの作成 → 結果のポーリング。
ステップ 1:タスクを作成してタスク ID を取得
シンガポール
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 または cURL を使用した画像および動画生成 API の呼び出し」をご参照ください。
リクエストパラメーター | 複数キャラクター間のインタラクション(リファレンス画像および動画を使用)
複数キャラクター間のインタラクション(リファレンス動画のみ使用)
単一キャラクターのロールプレイ
無音動画の生成無音動画の生成をサポートするのは 無音動画を生成する場合、 |
リクエストヘッダー | |
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:タスク ID を使用して結果を照会
シンガポール
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` などのエラーを返します。詳細については、「エラー情報」をご参照ください。
エラーコード
モデル呼び出しが失敗してエラーメッセージが返された場合、「エラーメッセージ」をご参照ください。
よくある質問
Q: 動画ストレージへのアクセスに必要なドメイン名のホワイトリストをどのように取得できますか?
A: モデルによって生成された動画は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを構成するには、以下の点にご注意ください:基盤となるストレージは動的に変更される可能性があります。このトピックでは、古くなった情報によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御の要件がある場合は、アカウントマネージャーにお問い合わせいただき、最新の OSS ドメイン名リストを取得してください。