AnimateAnyone 動画生成 API - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

AnimateAnyone モデルは、AnimateAnyone-template モデルによって作成されたアクションテンプレートと、AnimateAnyone-detect モデルによって検出されたキャラクター画像に基づいて、キャラクターのアクション動画を生成します。このドキュメントでは、この動画生成機能の API を呼び出す方法について説明します。

重要

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

モデル概要

モデル紹介

モデル	説明
animate-anyone-gen2	animate-anyone-gen2 は、キャラクターのアクション動画を生成するモデルです。キャラクター画像とアクションテンプレートに基づいて、キャラクターのアクション動画を作成します。

パフォーマンスショーケース

キャラクター画像	アクションテンプレート	出力 (画像背景で生成)	出力 (動画背景で生成)

説明

上記の例は、AnimateAnyone を統合した Tongyi App を使用して生成されました。
アクションテンプレートは AnimateAnyone アクションテンプレート生成 API を使用して作成できます。アクションテンプレートのソース動画が関連する法令を遵守していることを確認してください。また、音声を含む動画コンテンツを使用する権利を所有している必要があります。

HTTP

機能説明

キャラクターのアクション動画を生成します。

前提条件

Alibaba Cloud Model Studio を有効化し、API キーを作成済みであること。詳細については、「API キーの作成」をご参照ください。
入力アクションテンプレートは、AnimateAnyone アクションテンプレート生成 API を使用して生成されている必要があります。
入力画像は、AnimateAnyone 画像検出 API によって処理済みである必要があります。

入力制限

画像フォーマット：JPG、PNG、JPEG、または BMP。
画像要件：画像ファイルは 5 MB 未満である必要があります。アスペクト比は 2 以下、最も長い辺は 4096 ピクセル以下である必要があります。
ローカルパスはサポートされていないため、HTTP URL を使用して画像ファイルを指定する必要があります。ローカルファイルの URL を作成するには、プラットフォームが提供する一時的なストレージスペースにファイルをアップロードできます。

動画生成タイプごとの入力画像要件：

入力画像

画像背景で生成

(use_ref_img_bg が true に設定されている場合)

動画背景で生成

(use_ref_img_bg が false に設定されている場合)

全身ポートレート

サポート

半身ポートレート

サポート

非推奨

説明

動画の背景で動画を生成する場合、画像内のキャラクターは動画内のキャラクターの位置と一致する必要があります。半身ポートレート画像を使用すると、モデルは脚などの欠落部分をランダムに生成します。このプロセスは大きな不確実性を伴うため、これらの条件下で動画を生成することは推奨しません。

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

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

説明

これは時間のかかる API 呼び出しです。そのため、タスクを非同期で送信する必要があります。
タスクを送信すると、システムはタスク ID を返します。この ID を使用して、結果クエリ API でタスクステータスをクエリし、結果を取得できます。

リクエストパラメーター

フィールド	型	パラメーター渡し	必須	説明	例
Content-Type	String	ヘッダー	はい	リクエストのタイプ：application/json。	application/json
Authorization	String	ヘッダー	はい	API キー。例：Bearer d1**2a。	Bearer d1**2a
X-DashScope-Async	String	ヘッダー	はい	値を enable に設定して、タスクを非同期で送信します。	enable
model	String	ボディ	はい	呼び出すモデルを指定します。	animate-anyone-gen2
input.image_url	String	ボディ	はい	アップロードした画像の URL。画像は、まず AnimateAnyone 画像検出 API で処理し、目的の出力フレームに合わせて必要に応じてトリミングする必要があります。画像ファイルは 5 MB 未満である必要があります。アスペクト比は 2 以下、最も長い辺は 4096 ピクセル以下である必要があります。サポートされているフォーマット：JPG、PNG、JPEG、BMP。説明ファイルのアップロードは HTTP または HTTPS リンクのみをサポートし、ローカルファイルパスはサポートしていません。	http://aaa/bbb.jpg
input.template_id	String	ボディ	はい	アクションテンプレート ID。使用するアクションテンプレートを指定します。AnimateAnyone アクションテンプレート生成 API によって生成された template_id を入力します。説明アクションテンプレート ID は権限検証を受けます。使用する template_id が、現在の Alibaba Cloud アカウントによって作成されたものであることを確認してください。提案：テンプレート動画の解像度とフレームレートを上げると、生成される動画の品質が向上します。	AACT.xxx.xxx-xxx.xxx
parameters.use_ref_img_bg	Boolean	ボディ	いいえ	生成される動画の背景を制御します。値は true または false です。 true に設定すると、入力画像の背景で動画が生成されます。 false に設定すると、テンプレートファイルの元の動画の背景で動画が生成されます。デフォルト値は false です。	false
parameters.video_ratio	String	ボディ	いいえ	画像の背景で動画を生成する場合、利用可能なアスペクト比は "9:16" または "3:4" です。デフォルトは "9:16" です。説明このパラメーターは、動画の背景で動画を生成する場合 (use_ref_img_bg が false に設定されている場合) は無効です。新しい動画は、テンプレート動画のアスペクト比で生成されます。説明生成される動画の歪みを避けるために、入力画像のアスペクト比が選択したアスペクト比と一致していることを確認してください。	"9:16"

レスポンスパラメーター

フィールド	型	説明	例
output.task_id	String	送信された非同期タスクの ID。実際のタスク結果は、非同期タスククエリ API を通じて取得する必要があります。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	送信後のタスクのステータス。	"PENDING"
request_id	String	このリクエストの一意のシステムコード。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエストの例

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": "animate-anyone-gen2",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "parameters": {
        "use_ref_img_bg": false,
        "video_ratio": "9:16"
    }
}'

レスポンスの例

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

リクエストパラメーター

フィールド	型	パラメーター渡し	必須	説明	例
Authorization	String	ヘッダー	はい	API キー。例：Bearer d1**2a。	Bearer d1**2a
task_id	String	URL パス	はい	クエリするタスクの task_id。	a8532587-fa8c-4ef8-82be-0c46b17950d1

レスポンスパラメーター

フィールド	型	説明	例
output.task_id	String	クエリされたタスクの task_id。	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	クエリされたタスクのステータス。	タスクステータス： PENDING PRE-PROCESSING RUNNING POST-PROCESSING SUCCEEDED FAILED UNKNOWN：タスクが存在しないか、ステータスが不明です。
output.video_url	String	プラットフォームによって出力された動画の結果。video_url はタスク完了後 24 時間有効です。	https://xxx/1.mp4"
usage.video_duration	Float	このリクエストで生成された動画の長さ (秒単位)。	"video_duration": 10.23
usage.video_ratio	String	このリクエストで生成された動画のアスペクト比タイプ。値は standard です。	"video_ratio": "standard"
request_id	String	このリクエストの一意のシステムコード。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエストの例

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスの例

{
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://xxx/1.mp4"
    },
    "usage": {
        "video_duration": 10.23,
        "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"
    }
}

エラーコード

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