Skip to main content

Wan image-to-action API リファレンス

リファレンス動画からアクションを転送して、キャラクターのイメージをアニメーション化します。

  • 機能概要: リファレンス動画のアクションや表情をキャラクターのイメージに転送し、アニメーション動画を生成します。
  • 利用シーン: 映画やテレビ番組のパフォーマンスからダンス、複雑な身体動作、表情を再現します。モーションキャプチャの低コストな代替手段です。

モデル効果

wan2.2-animate-move モデルは、標準モード wan-std とプロフェッショナルモード wan-pro の 2 つのサービスモードをサポートしており、出力品質と料金が異なります。詳細については、「Wanx-Image-to-Motion」をご参照ください。
キャラクターイメージリファレンス動画出力動画 (標準モードwan-std)出力動画 (プロフェッショナルモードwan-pro)
move_input_image

前提条件

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 はリージョンによって異なります。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
    --header 'X-DashScope-Async: enable' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{
        "model": "wan2.2-animate-move",
        "input": {
            "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
            "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4",
            "watermark": true
        },
        "parameters": {
            "mode": "wan-std"
        }
      }'
リクエストヘッダー
Content-Type string (必須)リクエストのコンテンツタイプです。必ず application/json を指定してください。
Authorization string (必須)Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。
X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストでは非同期呼び出しのみサポートされています。必ず enable を指定してください。
このリクエストヘッダーが指定されていない場合、「current user api does not support synchronous calls」というエラーが返されます。
リクエスト本文
model string (必須)モデル名です。このパラメーターを wan2.2-animate-move に設定します。
input object (必須)入力パラメーターです。以下のフィールドを含みます。

プロパティ

image_url string (必須)キャラクターイメージの公開アクセス可能な HTTP または HTTPS URL です。非 ASCII 文字を含む URL は URL エンコードする必要があります。
  • フォーマット: JPG、JPEG、PNG、BMP、WEBP
  • 寸法: 幅と高さはいずれも [200, 4096] ピクセルの範囲内である必要があります。アスペクト比は 1:3 ～ 3:1 の範囲内である必要があります。
  • ファイルサイズ: 5 MB 以下
  • 例: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg
video_url string (必須)リファレンス動画の公開アクセス可能な HTTP または HTTPS URL です。非 ASCII 文字を含む URL は URL エンコードする必要があります。推奨事項: より良い結果を得るには、解像度とフレームレートが高いリファレンス動画を使用してください。
  • フォーマット: MP4、AVI、MOV
  • 再生時間: 2 ～ 30 秒
  • 寸法: 幅と高さはいずれも [200, 2048] ピクセルの範囲内である必要があります。アスペクト比は 1:3 ～ 3:1 の範囲内である必要があります。
  • ファイルサイズ: 200 MB 以下
  • 例: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4
watermark bool (オプション)出力動画の右下隅に「Generated by Qwen AI」ウォーターマークを追加するかどうかを指定します。
  • false (デフォルト)
  • true
parameters object (必須)

プロパティ

check_image bool (オプション)処理前にイメージを検証するかどうかを指定します。
  • true (デフォルト)
  • false
mode string (必須)サービスモードです。有効な値は以下のとおりです。
  • wan-std: 標準モード。低コストで高速に生成できます。プレビュー用途や基本的なアニメーションに適しています。
  • wan-pro: プロフェッショナルモード。より滑らかなアニメーションと高品質な出力を提供しますが、処理時間が長く、コストも高くなります。
詳細については、「モデル効果」および「課金とレート制限」をご参照ください。

レスポンスパラメーター

  • 成功時のレスポンス
  • エラー時のレスポンス
task_id を保存して、タスクのステータスと結果を照会します。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}
output objectタスクの出力です。

プロパティ

task_id stringタスク ID です。24 時間の間、クエリに使用できます。task_status stringタスクのステータスです。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: タスクが存在しないか、ステータスが不明です。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子です。
message string詳細なエラーメッセージです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。
code stringエラーコードです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。

ステップ 2: タスク ID で結果を照会する

  • シンガポール
  • 中国 (北京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}呼び出し時には、WorkspaceId を実際の ワークスペース ID に置き換えてください。
  • ポーリングの推奨事項: 動画生成には数分かかります。15 秒などの適切な間隔でポーリングメカニズムを使用してください。
  • タスク状態の遷移: PENDING → RUNNING → SUCCEEDED または FAILED。
  • 結果リンク: タスクが成功すると、24 時間 有効な動画 URL が返されます。動画をダウンロードして、OSS などの永続ストレージに保存してください。
  • task_idの有効期間: 24 時間。この期間を過ぎると、クエリに対してタスクステータスが UNKNOWN として返されます。

リクエストパラメーター

  • タスク結果の照会
0385dc79-5ff8-4d82-bcb6-xxxxxx は、実際の task_id に置き換えてください。
以下はシンガポールリージョンの URL です。WorkspaceId は実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。 
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY"
リクエストヘッダー
Authorization string (必須)Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。
URL パスパラメーター
task_id string (必須)タスクの ID です。

レスポンスパラメーター

  • タスク成功
  • タスク失敗
動画 URL の有効期間は 24 時間のみで、その後自動的にパージされます。生成された動画は速やかに保存してください。
{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5.2,
        "video_ratio": "standard"
    }
}
output objectタスクの出力です。

プロパティ

task_id stringタスク ID です。24 時間の間、クエリに使用できます。task_status stringタスクのステータスです。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: タスクが存在しないか、ステータスが不明です。
submit_time 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 です。results object

プロパティ

video_url string生成された動画の URL です。task_status が SUCCEEDED の場合にのみ返されます。有効期間は 24 時間です。動画は H.264 エンコーディングの MP4 形式です。
code stringエラーコードです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージです。失敗したリクエストでのみ返されます。「エラーコード」をご参照ください。
usage object出力統計情報です。成功した結果のみがカウントされます。

プロパティ

video_duration float生成された動画の再生時間（秒）です。video_ratio stringこのリクエストで使用されたサービスモードです。列挙値：standard および pro。wan-std は standard を返します。wan-pro は pro を返します。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子です。

制限事項

データの有効期間: タスク ID および動画 URL の有効期間は 24 時間です。「動画のダウンロード」を速やかに行ってください。 コンテンツモデレーション: 入力および出力のすべてのコンテンツは自動的にモデレーションされます。準拠していないコンテンツの場合、IPInfringementSuspect または DataInspectionFailed エラーが返されます。詳細については、「エラーコード」をご参照ください。

課金とレート制限

  • 無料クォータおよび料金については、「Wanx-Image-to-Motion」をご参照ください。
  • レート制限については、「Wan シリーズ」をご参照ください。
  • 課金の詳細：
    • 出力のみが課金対象となり、動画の再生時間（秒単位）に基づいて計算されます。
    • 失敗した呼び出しは無料であり、新規ユーザー無料クォータ を消費しません。

エラーコード

モデル呼び出しが失敗してエラーメッセージが返された場合は、「エラーコード」をご参照ください。

よくある質問

出力動画の品質を向上させるにはどうすればよいですか？

  1. 入力イメージとリファレンス動画の両方で、キャラクターがフレーム内で占める割合を同じくらいにしてください。
  2. イメージと動画の間で身体の比率を一致させてください。
  3. 高解像度のソース素材を使用してください。ぼやけたイメージやフレームレートの低い動画は、出力品質を低下させます。

一時的な動画リンクを永続的なリンクに変換するにはどうすればよいですか？

リンクを直接変換することはできません。バックエンドから動画をダウンロードし、永続的なオブジェクトストレージ（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 ドメイン名リストを取得してください。