Alibaba Cloud Model Studio:Wan - 動画キャラクター交換 API リファレンス

使用例

Wan wan2.2-animate-mix 動画キャラクター交換モデルは、標準モード wan-std とプロフェッショナルモード wan-pro の 2 種類のサービスモードをサポートしています。これらのモードはパフォーマンスおよび課金方式が異なります。詳細については、「課金およびレート制限」をご参照ください。

HTTP

API キーを取得すること、および API キーを環境変数として設定する必要があります。

動画生成には時間がかかるため、HTTP API は非同期モードで動作します。呼び出し手順は以下の 2 ステップで構成されます。

1. タスクを作成してタスク ID を取得する: タスク作成リクエストを送信します。応答には task_id が含まれます。

2. タスク ID で結果を照会する: task_id を使用してタスクのステータスをポーリングし、タスク完了および動画 URL の返却まで待ちます。

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/zh-CN/20250919/bhkfor/mix_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4",
        "watermark": true
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

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

制限事項

データ保持期間: task_id および動画 URL は 24 時間のみ保持されます。この期間を過ぎると、照会およびダウンロードができなくなります。速やかに動画をローカルデバイスにダウンロードしてください。

コンテンツモデレーション: 入力および出力コンテンツはすべてコンテンツモデレーションの対象となります。準拠していないコンテンツを含むリクエストでは、「IPInfringementSuspect」または「DataInspectionFailed」というエラーが返されます。詳細については、「エラーメッセージ」をご参照ください。

ネットワークアクセス構成: 動画 URL は Object Storage Service (OSS) に保存されます。セキュリティポリシーにより、業務システムが外部 OSS URL にアクセスできない場合は、以下の OSS ドメイン名をネットワークアクセスホワイトリストに追加してください。

# OSS ドメイン名一覧
dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

課金およびレート制限

• 無料クォータおよび単価については、「モデルの価格」をご参照ください。

• レート制限については、「Wan シリーズ」をご参照ください。

• 課金の説明:

  • 入力は課金対象外です。出力のみが課金対象です。正常に生成された動画の 再生時間（秒単位） に基づいて課金されます。

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

エラーコード

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

よくある質問

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)