AnimateAnyone アクションテンプレート生成 API - Alibaba Cloud Model Studio

AnimateAnyone アクションテンプレート生成モデルは、キャラクターモーションのビデオからキャラクターの動きを抽出し、キャラクターアクションテンプレートを生成します。このテンプレートは、AnimateAnyone ビデオ生成モデルで使用できます。このドキュメントでは、このモデルのアクションテンプレート生成機能の API を呼び出す方法について説明します。

重要

このドキュメントは、中国 (北京) リージョンにのみ適用されます。モデルを使用するには、中国 (北京) リージョンの API キーを使用する必要があります。

モデル概要

モデル	説明
animate-anyone-template-gen2	animate-anyone-template-gen2 は、キャラクターアクションテンプレートを生成するためのモデルです。キャラクターモーションのビデオからキャラクターの動きを抽出し、テンプレートを作成できます。

モデルの入力要件

正しい例:

アクションテンプレート作成の要件を満たすビデオの例

説明

アップロードされたビデオの人物は、体の一部が隠れることなく全身が見え、顔がはっきりしている必要があります。
キャラクターはビデオの最初のフレームから表示される必要があります。アクションは連続しており、ワンテイクで撮影されている必要があります。シーンの変更があるビデオは、複数のセグメントに分割することをお勧めします。
推奨事項: キャラクターは最初のフレームでカメラの方を向いている必要があります。過度に曲げたり、しゃがんだり、かがんだりするようなアクションは避けてください。

正しくない例:

かがんだり、体が隠れたりしている

フレーム内に複数の人物がいる

キャラクターがぼやけている

キャラクターが小さすぎる

顔が不鮮明

キャラクターが大きすぎる

キャラクターが完全に見えていない

身体遮挡@3x

多人物@3x

f3e2df6643d44db7a7d65d4571609bff_3 (1)

人物过小@3x

人物过大@3x

説明

生成されるテンプレートの品質を確保するために、アップロードするビデオに、正しくない例に示されている問題が含まれていないことを確認してください。
正しくない例に示されている問題のいずれかが ビデオの最初のフレーム に表示された場合、送信されたタスクは失敗し、中止される可能性があります。

重要

ビデオコンテンツが関連する法律および規制に準拠していることを確認してください。
生成されたアクションテンプレートには、アップロードされたビデオファイルと同じ音声が含まれています。この音声を使用したくない場合、または音声 (音楽など) を使用するライセンスを取得していない場合は、アップロードする前にビデオファイルから音声を削除してください。

HTTP の使用

機能説明

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

前提条件

サービスを有効化し、API キーを取得していること。詳細については、「API キーの取得」をご参照ください。

入力制限

ビデオフォーマット: MP4、AVI、または MOV。
ビデオファイルサイズは 200 MB 未満である必要があります。
ビデオの各辺の長さは 200 ～ 2,048 ピクセルである必要があります。ビデオフレームレートは 24 フレーム/秒 (fps) 以上である必要があります。ビデオは H.264 または H.265 でエンコードされている必要があります。
ビデオの長さは 2 秒から 60 秒である必要があります。
ビデオの縦横比は 1:3 から 3:1 の間である必要があります。
HTTP URL のみがサポートされており、ローカルファイルパスは許可されていません。

タスクの送信

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

説明

このアルゴリズムは実行に時間がかかるため、タスクは非同期呼び出しを使用して送信されます。
タスクを送信すると、システムはタスク ID を返します。その後、タスクのステータスと結果をクエリする API を使用して、タスクのステータスと結果を取得できます。

リクエストパラメーター

パラメーター	タイプ	メソッド	必須	説明	例
Content-Type	String	Header	はい	リクエストタイプ: application/json	application/json
Authorization	String	Header	はい	API キー。例: Bearer d1**2a	Bearer d1**2a
X-DashScope-Async	String	Header	はい	タスクが非同期で送信されることを示すには、`enable` に設定します。	enable
model	String	Body	はい	呼び出すモデルを指定します。この場合は、`animate-anyone-template-gen2` に設定します。	animate-anyone-template-gen2
input.video_url	String	Body	いいえ	アップロードするビデオの URL。このビデオは、モーションテンプレートを生成するために使用されます。ビデオファイルサイズは 200 MB 未満である必要があります。ビデオの幅と高さは、それぞれ 200 ～ 2,048 ピクセルである必要があります。ビデオフレームレートは 24 fps 以上である必要があります。ビデオは H.264 または H.265 でエンコードされている必要があります。ビデオの長さは 2 秒から 60 秒である必要があります。ビデオの縦横比は 1:3 から 3:1 の間である必要があります。サポートされているビデオフォーマット: MP4、AVI、MOV。説明ファイルのアップロードは HTTP リンクのみをサポートし、ローカルファイルパスはサポートしません。	http://aaa/bbb.mp4

応答パラメーター

パラメーター	タイプ	説明	例
output.task_id	String	送信された非同期タスクの ID。実際のタスク結果は、タスククエリインターフェイスを介して取得する必要があります。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	送信後のタスクステータス	"PENDING"
request_id	String	リクエスト ID	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエストの例

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "animate-anyone-template-gen2",
    "input": {
        "video_url": "http://xxx/1.mp4"
    },
    "parameters": {
    }
  }'

応答の例

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

リクエストパラメーター

パラメーター	タイプ	メソッド	必須	説明	例
Authorization	String	Header	はい	API キー。例: Bearer d1**2a。	Bearer d1**2a
task_id	String	Url Path	はい	クエリするタスクの ID。	a8532587-fa8c-4ef8-82be-0c46b17950d1

応答パラメーター

パラメーター	タイプ	説明	例
output.task_id	String	クエリされたタスクの ID。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	クエリされたタスクのステータス。	タスクステータス: PENDING RUNNING SUCCEED FAILED UNKNOWN: タスクが存在しないか、ステータスが不明です。
output.template_id	String	プラットフォームによって出力されるアクションテンプレート ID。この ID は、「Animate-Anyone ビデオ生成 API」のリクエストパラメーターとして使用できます。アクションテンプレート ID は検証されます。使用する template_id が現在の Alibaba Cloud アカウントによって作成されたものであることを確認してください。	AACT.xxx.xxx-xxx.xxx
usage.video_duration	Float	このリクエストで生成されたテンプレートの期間。単位: 秒。	"video_duration": 10.23
usage.video_ratio	String	このリクエストで生成されたビデオテンプレートの縦横比タイプ。値は `standard` です。	"video_ratio": "standard"
request_id	String	リクエスト ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエストの例

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

ステータスコード

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

このモデルには、次の特定のエラーコードがあります:

HTTP ステータスコード*	code	message	説明
400	InvalidParameter	Field required: xxx	リクエストパラメーターが欠落しているか、フォーマットが正しくありません。
400	InvalidURL.ConnectionRefused	Connection to ${url} refused, please provide available URL	ダウンロードが拒否されました。利用可能な URL を指定してください
400	InvalidURL.Timeout	Download ${url} timeout, please check network connection.	ダウンロードがタイムアウトしました。タイムアウト期間は 60 秒です。
400	InvalidFile.Size	Invalid file size. The video file size must be less than 200MB, and the audio file size must be less than 15MB.	ビデオファイルサイズは 200 MB 未満、オーディオファイルサイズは 15 MB 未満である必要があります。
400	InvalidFile.Resolution	Invalid video resolution. The height or width of video must be 200 ~ 2048.	ビデオの幅と高さは、それぞれ 200 ～ 2,048 ピクセルである必要があります。
400	InvalidFile.Duration	Invalid file duration. The file duration must be 2s ~ 60s.	ビデオまたはオーディオファイルの長さは 2 ～ 60 秒である必要があります。
400	InvalidFile.AspectRatio	Invalid file ratio. The file aspect ratio (height/width) must be between 3:1 and 1:3.	ビデオファイルの縦横比は 3:1 から 1:3 の間である必要があります。
400	InvalidFile.Openerror	Invalid file, cannot open file as video.	ビデオファイルを開けません。
400	InvalidFile.Content	No human body	ビデオの最初のフレームに人物が存在する必要があります。
400	InvalidFile.Content	The person is too small in the first frame of input video. Please choose another clip.	人物が小さすぎます
400	InvalidFile.Content	The person is not clear in the first frame of input video. Please choose another clip.	人物が不鮮明です
400	InvalidFile.FullBody	Human not fullbody	人物が完全に見えていません