Alibaba Cloud Model Studio:デジタルヒューマン wan2.2-s2v による動画生成 API リファレンス

デジタルヒューマン wan2.2-s2v モデルは、 1 枚の画像と 1 つのオーディオファイル に基づいて、自然に話したり、歌ったり、パフォーマンスしたりする動画を生成します。

• オーディオ駆動： 人間の音声を入力して静止画像内の人物を駆動し、唇の動き、表情、動作を音声と同期させます。
• 豊富なシナリオ： リップシンクの 3 つのシナリオ "speaking"、"singing"、"performing" に対応しています。
• 多様なキャラクタースタイル： 実写の人物 (ポートレート、上半身、全身) とアニメキャラクターに対応しています。
• 出力動画の解像度： 480P と 720P の解像度オプションを提供します。

モデルと料金

HTTP API

前提条件

• サービスを有効化して API キーを取得します：API キーの取得。
• 環境変数を設定します：API キーを環境変数として設定。

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

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

{WorkspaceId} を実際の ワークスペース ID に置き換えてください。

リクエストパラメーター

レスポンスパラメーター

リクエスト例

curl 'https://{WorkspaceId}.cn-beijing.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-s2v",
     "input": {
            "image_url": "https://img.alicdn.com/imgextra/i3/O1CN011FObkp1T7Ttowoq4F_!!6000000002335-0-tps-1440-1797.jpg",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/iaqpio/input_audio.MP3"
        },
        "parameters": {
            "resolution": "480P"
        }
    }'

レスポンス例

{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx"
}

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

前の手順で取得した task_id を使用して GET リクエストを送信し、タスクのステータスと結果を照会します。 URL の {task_id} を実際のタスク ID に置き換え、{WorkspaceId} を実際の ワークスペース ID に置き換えます。

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}

リクエストパラメーター

レスポンスパラメーター

リクエスト例

86ecf553-d340-4e21-xxxxxxxxx を実際の task_id に置き換え、また {WorkspaceId} を実際の ワークスペース ID に置き換えます。

curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンス例

{
    "output": {
        "task_id": "bcae8761-f242-4775-a11e-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-01 09:37:27.468",
        "scheduled_time": "2025-09-01 09:37:34.885",
        "end_time": "2025-09-01 09:40:20.734",
        "results": {
            "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/1d/xxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "duration": 18.13,
        "size": "512*640",
        "fps": 16,
        "video_count": 1,
        "SR": 480
    },
    "request_id": "28cfedb1-cd60-9e0c-b920-xxxxxx"
}

{
    "request_id": "8d49f522-f6a4-9eed-b322-xxxxxx",
    "output": {
        "task_id": "101ad32f-7653-4ae9-8f22-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2025-09-01 11:43:41.174",
        "scheduled_time": "2025-09-01 11:43:48.937",
        "end_time": "2025-09-01 11:43:49.802",
        "code": "InvalidURL",
        "message": "Required URL is missing or invalid, please check the request URL."
    }
}

課金とスロットリング

• モデルの無料クォータと料金については、 Wanx-Digital Human をご参照ください。

• モデルのスロットリングについては、 Wanxiang series をご参照ください。

• 課金に関する注意事項：

  • 入力は課金対象外で、出力が課金対象です。課金は、生成に成功した動画の秒数に基づいて行われます。
  • モデル呼び出しの失敗または処理エラーは課金されず、 Free quota for new users も消費されません。

エラーコード

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