リファレンス動画からアクションを転送して、キャラクターのイメージをアニメーション化します。
- 機能概要: リファレンス動画のアクションや表情をキャラクターのイメージに転送し、アニメーション動画を生成します。
- 利用シーン: 映画やテレビ番組のパフォーマンスからダンス、複雑な身体動作、表情を再現します。モーションキャプチャの低コストな代替手段です。
モデル効果
wan2.2-animate-move モデルは、標準モード wan-std とプロフェッショナルモード wan-pro の 2 つのサービスモードをサポートしており、出力品質と料金が異なります。詳細については、「Wanx-Image-to-Motion」をご参照ください。
| キャラクターイメージ | リファレンス動画 | 出力動画 (標準モード | 出力動画 (プロフェッショナルモード |
|---|---|---|---|
![]() |
前提条件
API キーを取得し、API キーを環境変数としてエクスポートします。
重要中国 (北京) リージョンおよびシンガポールリージョンでは、それぞれ専用の API キー および リクエストエンドポイント を使用します。これらは相互に使用できません。リージョンをまたいだ呼び出しを行うと、認証エラーまたはサービスエラーが発生します。
重要シンガポールリージョン向けのレガシドメイン https://dashscope-intl.aliyuncs.com はまもなく廃止されます。できるだけ早く新しいドメイン https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com に移行してください。
HTTP
動画生成は非同期呼び出しを使用します。処理は次の 2 ステップで構成されます:タスクを作成し、結果をポーリングします。
ステップ 1: タスクを作成し、タスク ID を取得する
シンガポール: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
WorkspaceId は、実際の ワークスペース ID に置き換えてください。
中国 (北京): POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
注記
- タスク作成後は、返された
task_idを使用して結果を照会します。task_idの有効期間は 24 時間です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得します。 - 初心者向けのガイドについては、「Postman または cURL を使用した API 呼び出し」をご参照ください。
リクエストパラメーター | Image to action以下はシンガポールリージョンの URL です。WorkspaceId は実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。 |
リクエストヘッダー | |
Content-Type リクエストのコンテンツタイプです。必ず | |
Authorization Model Studio API キーを使用してリクエストを認証します。例:Bearer sk-xxxx。 | |
X-DashScope-Async 非同期処理を有効にします。HTTP リクエストでは非同期呼び出しのみサポートされています。必ず 重要このリクエストヘッダーが指定されていない場合、「current user api does not support synchronous calls」というエラーが返されます。 | |
リクエスト本文 | |
model モデル名です。このパラメーターを | |
input 入力パラメーターです。以下のフィールドを含みます。 | |
parameters |
レスポンスパラメーター | 成功時のレスポンス
エラー時のレスポンスタスクの作成に失敗しました。「エラーコード」をご参照ください。 |
output タスクの出力です。 | |
request_id トレースおよびトラブルシューティング用の一意のリクエスト識別子です。 | |
message 詳細なエラーメッセージです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。 | |
code エラーコードです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。 |
ステップ 2: タスク ID で結果を照会する
シンガポール
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
呼び出し時には、WorkspaceId を実際の ワークスペース ID に置き換えてください。
中国 (北京)
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
注記
- ポーリングの推奨事項: 動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
- タスク状態の遷移: PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク: タスクが成功すると、24 時間 有効な動画 URL が返されます。動画をダウンロードして、OSS などの永続ストレージに保存してください。
task_idの有効期間: 24 時間。この期間を過ぎると、クエリに対してタスクステータスがUNKNOWNとして返されます。
リクエストパラメーター | タスク結果の照会
|
リクエストヘッダー | |
Authorization Model Studio API キーを使用してリクエストを認証します。例:Bearer sk-xxxx。 | |
URL パスパラメーター | |
task_id タスクの ID です。 |
レスポンスパラメーター | タスク成功動画 URL の有効期間は 24 時間のみで、その後自動的にパージされます。生成された動画は速やかに保存してください。 タスク失敗タスクが失敗した場合、 |
output タスクの出力です。 | |
usage 出力統計情報です。成功した結果のみがカウントされます。 | |
request_id トレースおよびトラブルシューティング用の一意のリクエスト識別子です。 |
制限事項
データの有効期間: タスク ID および動画 URL の有効期間は 24 時間です。「動画のダウンロード」を速やかに行ってください。
コンテンツモデレーション: 入力および出力のすべてのコンテンツは自動的にモデレーションされます。準拠していないコンテンツの場合、IPInfringementSuspect または DataInspectionFailed エラーが返されます。詳細については、「エラーコード」をご参照ください。
課金とレート制限
-
無料クォータおよび料金については、「Wanx-Image-to-Motion」をご参照ください。
-
レート制限については、「Wan シリーズ」をご参照ください。
-
課金の詳細:
- 出力のみが課金対象となり、動画の再生時間(秒単位)に基づいて計算されます。
- 失敗した呼び出しは無料であり、新規ユーザー無料クォータ を消費しません。
エラーコード
モデル呼び出しが失敗してエラーメッセージが返された場合は、「エラーコード」をご参照ください。
よくある質問
出力動画の品質を向上させるにはどうすればよいですか?
- 入力イメージとリファレンス動画の両方で、キャラクターがフレーム内で占める割合を同じくらいにしてください。
- イメージと動画の間で身体の比率を一致させてください。
- 高解像度のソース素材を使用してください。ぼやけたイメージやフレームレートの低い動画は、出力品質を低下させます。
一時的な動画リンクを永続的なリンクに変換するにはどうすればよいですか?
リンクを直接変換することはできません。バックエンドから動画をダウンロードし、永続的なオブジェクトストレージ(OSS など)にアップロードして、永続的な URL を取得してください。
例:動画をローカルデバイスにダウンロードするコード
import requests
def download_and_save_video(video_url, save_path):
try:
response = requests.get(video_url, stream=True, timeout=300) # タイムアウトを設定
response.raise_for_status() # HTTP ステータスコードが 200 でない場合、例外を発生
with open(save_path, 'wb') as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
print(f"動画のダウンロードが完了しました: {save_path}")
# ここに永続ストレージへのアップロードロジックを追加できます
except requests.exceptions.RequestException as e:
print(f"動画のダウンロードに失敗しました: {e}")
if __name__ == '__main__':
video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
save_path = "video.mp4"
download_and_save_video(video_url, save_path)
返された動画リンクをブラウザで直接再生できますか?
推奨されません。リンクの有効期間は 24 時間です。バックエンドから動画をダウンロードして保存し、永続的なリンク経由で配信してください。
動画ストレージのドメイン名ホワイトリストを取得するにはどうすればよいですか?
A: モデルによって生成された動画は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを設定する場合、以下の点にご注意ください。基盤となるストレージは動的に変更される可能性があります。このトピックでは、古い情報によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御の要件がある場合は、アカウントマネージャーに連絡して最新の OSS ドメイン名リストを取得してください。
