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-mix",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20250919/bhkfor/mix_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20250919/wqefue/mix_input_video.mp4"
    },
    "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-mix` モデルは、さまざまなシナリオでのビデオのキャラクター置換効果をサポートするために、標準モード wan-std とプロフェッショナルモード wan-pro の 2 つのサービスモードを提供します。

課金ルール

• 課金モード： このサービスは従量課金制です。正常に生成されたビデオの時間 (秒単位) に基づいて課金されます。課金対象期間は、成功したタスクの応答に含まれる usage.video_duration フィールドによって決まります。

  クリックして課金の例を表示

  料金は無料クォータを使い切った後に計算されます。数式は次のとおりです： 合計料金 = 実際のビデオ時間 (秒) × 選択したサービスモードの単価。

  たとえば、シンガポールリージョンのモデルを呼び出して、標準モード wan-std を使用してビデオを生成し、タスクが成功した後に返される usage.video_duration が 5.2 秒の場合。

  料金は次のように計算されます： 5.2 秒 × $0.18/秒 = $0.936

  注：課金対象期間は、タスクが正常に完了した後に返される usage.video_duration フィールドに基づきます。

• 消費順序： 無料クォータが最初に消費されます。無料クォータを使い切った後は、デフォルトで従量課金方式が使用されます。無料クォータを使い切った後の追加料金を避けるために、「無料クォータのみ」機能を有効にすることができます。詳細については、「新規ユーザー向けの無料クォータ」をご参照ください。

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

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

Q：モデルの呼び出し使用量を確認する方法は？

A：モデルの呼び出し情報は、1 時間ごとに集計されるため、表示に遅延が生じます。モデルが呼び出されてから約 1 時間後に、モデル観測 (シンガポール または 北京) ページに移動して、呼び出し数や成功率などのメトリックを確認できます。モデル呼び出しレコードの確認方法

Q：生成される動画の品質を向上させる方法は？

A：以下の方法をお試しください：

1. 入力画像と参照動画で、人物が同様のフレームに収まるようにしてください。

2. 画像と動画で、人物の体の比率を一致させるようにしてください。

3. 高解像度のソース素材を使用してください。詳細を正確に認識させるため、ぼやけた画像や低フレームレートの動画は避けてください。

Q：一時的な動画 URL を永続的なものに変換する方法は？

A：URL を直接変換することはできません。正しい手順は、バックエンドサービスで URL を取得し、コードを使用して動画ファイルをダウンロードした後、Alibaba Cloud 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)

Q：返された動画 URL はブラウザで直接再生できますか？

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