Alibaba Cloud Model Studio:AnimateAnyone アクションテンプレート生成 API リファレンス

モデル概要

入力要件

正しい例

正しくない例

HTTP

機能説明

キャラクターアクションテンプレートを生成します。このテンプレートは、AnimateAnyone ビデオ生成 API の入力として使用し、キャラクターアクションビデオを生成できます。

前提条件

• Alibaba Cloud Model Studio を有効化し、API キーを作成済みであること。詳細については、「API キーの作成」をご参照ください。

入力制限

• ビデオフォーマット：MP4、AVI、または MOV。

• ビデオファイルサイズは 200 MB を超えることはできません。

• ビデオの各辺の長さは 200～2,048 ピクセルである必要があります。ビデオフレームレートは 24 fps (1 秒あたりのフレーム数) 以上である必要があります。ビデオは H.264 または H.265 でエンコードされている必要があります。

• ビデオの長さは 2 秒から 60 秒までである必要があります。

• ビデオのアスペクト比は 1:3 から 3:1 の範囲である必要があります。

• HTTP URL のみがサポートされており、ローカルファイルパスはサポートされていません。

ステップ 1：タスクの作成とタスク ID の取得

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/

リクエストパラメーター

レスポンスパラメーター

リクエスト例

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "animate-anyone-template-gen2",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20241210/cwjmsz/1.mp4"
    }
  }'

レスポンス例

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

ステップ 2：タスク ID による結果のクエリ

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

リクエストパラメーター

レスポンスパラメーター

リクエスト例

curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>

レスポンス例

{
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
        "task_status": "SUCCEEDED",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "usage": {
        "video_duration": 10.23,
        "video_ratio": "standard"
    }
}

エラーレスポンス例

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

エラーコード

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