Alibaba Cloud Model Studio:Wan - 画像からアニメーション生成 API リファレンス

シンガポール： POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

中国 (北京)： POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

ステップ 1：タスクを作成してタスク ID を取得する

curl --location 'https://dashscope-intl.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"
    }
  }'

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

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "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"
    }
}

{
    "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

wan2.2-animate-move には、異なるシナリオにおける画像からアニメーション生成の効果に対応するため、標準モード (wan-std) およびプロフェッショナルモード (wan-pro) の 2 つのサービスモードがあります。

課金ルール

• 課金方法：このサービスは 従量課金 方式を採用しています。正常に生成された動画の再生時間 (秒単位) に基づいて課金されます。課金対象となる再生時間は、タスクが成功した場合の応答に含まれる usage.video_duration フィールドの値です。

  課金例を表示

  無料クォータを使い切った後に料金が計算されます。計算式は次のとおりです。総費用 = 実際の動画再生時間 (秒) × 選択したサービスモードの単価

  シンガポールリージョンのモデルを呼び出して動画を生成したと仮定します。タスクが成功した場合に返される usage.video_duration が 5.2 秒で、標準モード (wan-std) を選択したとします。

  費用は次のように計算されます。5.2 秒 × $0.12/秒 = $0.624

  注：最終的な課金対象となる再生時間は、タスクが成功した場合の応答に含まれる usage.video_duration フィールドの値です。

• 相殺注文：無料クォータが最初に適用されます。無料クォータを使い切った後は、デフォルトで従量課金方式が使用されます。無料クォータを使い切った後の追加料金を防ぐには、「超過課金防止」機能を有効にしてください。詳細については、「新規ユーザー向け無料クォータ」をご参照ください。

• 失敗した呼び出しは無料：モデルの呼び出しが失敗した場合や処理エラーが発生した場合は、料金は発生せず、無料クォータも消費されません。

レート制限：Alibaba Cloud アカウントおよびその RAM ユーザーの合計リクエスト頻度制限は 1 秒あたり 5 リクエストです。同時に処理できるタスクは最大 1 つです。この制限を超える新しいタスクはキューに追加されます。モデルの速度制限ルールおよびよくある質問については、「レート制限」をご参照ください。

Q：モデルの使用状況を確認するにはどうすればよいですか？

A：モデル呼び出し情報には約 1 時間の遅延があります。モデルを呼び出した後、約 1 時間で モデル観測 (シンガポール または 中国 (北京)) ページにアクセスして、呼び出し量、呼び出し回数、成功率などのメトリックを確認できます。詳細については、「モデル呼び出し記録の確認方法」をご参照ください。

Q：生成される動画の品質を最適化するにはどうすればよいですか？

A：次の推奨事項をご検討ください。

1. 入力画像とリファレンス動画の両方で、人物がフレーム内で占める割合が類似していることを確認してください。

2. 画像と動画の間で、人物の体の比率をできるだけ一致させることを試みてください。

3. 高精細なソース素材を使用してください。ぼやけた画像やフレームレートが低い動画は避け、詳細な認識を確実に行ってください。

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

A：リンクを直接変換することはできません。正しい手順は、バックエンドサービスが URL を使用して動画ファイルをダウンロードし、Alibaba Cloud OSS などの永続的なオブジェクトストレージサービスにアップロードして、新しい永続的なアクセスリンクを生成することです。

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)

Q：返された動画リンクをブラウザで直接再生できますか？

A：これは推奨されません。リンクは 24 時間後に有効期限が切れます。ベストプラクティスは、バックエンドが動画をダウンロードして保存し、再生には永続的なリンクを使用することです。