Alibaba Cloud Model Studio:LivePortrait video generation API reference

モデルの概要

HTTP API

機能説明

ダイナミックなポートレート動画を生成します。

前提条件

• Alibaba Cloud Model Studio を有効化し、API キーを取得します。詳細については、「API キーの作成と設定」をご参照ください。

• 入力画像は LivePortrait 画像検出 を経る必要があります。

入力制限

• 画像フォーマット：JPEG、JPG、PNG、BMP、または WebP。

• 画像解像度：画像ファイルのサイズは 10 MB 未満である必要があります。アスペクト比は 2 以下、最大辺長は 4096 ピクセル以下である必要があります。

• 音声フォーマット：WAV または MP3。

• 音声制限：音声ファイルのサイズは 15 MB 未満である必要があります。長さは 1 秒から 3 分の間である必要があります。

• 音声コンテンツ：音声には、環境ノイズ、BGM、その他の音の干渉がなく、明瞭で十分な音量の人の声が含まれている必要があります。

• 画像と音声ファイルは、HTTP または HTTPS の URL を使用してアップロードします。ローカルファイルパスはサポートされていません。

ジョブの送信

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/

リクエストパラメーター

レスポンスパラメーター

アクションテンプレート

リクエストの例

curl --location 'https://dashscope.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": "liveportrait",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20250911/ynhjrg/p874909.png",
        "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20251226/fwnqyq/liveportrait_boy.mp3"
    },
      "parameters": {
         "template_id": "normal",
         "eye_move_freq": 0.5,
         "video_fps":30,
         "mouth_move_strength":1,
         "paste_back": true,
         "head_move_strength":0.7
    }
  }'

レスポンスの例

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

ジョブステータスのクエリと結果の取得

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

リクエストパラメーター

レスポンスパラメーター

リクエストの例

86ecf553-d340-4e21-xxxxxxxxx を実際のタスク ID に置き換えてください。

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスの例 (成功)

{
    "request_id": "b64e9c68-3923-462d-b25a-xxxxxx",
    "output": {
        "task_id": "a1c69ca5-810b-49ae-8b20-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-26 11:33:03.146",
        "scheduled_time": "2025-12-26 11:33:13.312",
        "end_time": "2025-12-26 11:33:22.455",
        "results": {
            "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxx"
        }
    },
    "usage": {
        "video_duration": 2.79,
        "video_ratio": "standard"
    }
}

レスポンスの例 (失敗)

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

ステータスコード

一般的なステータスコードについては、「エラーメッセージ」をご参照ください。