すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:AnimateAnyone ビデオ生成 API リファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:AnimateAnyone ビデオ生成 API リファレンス

    最終更新日:Oct 22, 2025

    AnimateAnyone モデルは、AnimateAnyone-template によって作成されたアクションテンプレートと AnimateAnyone-detect によって検出されたキャラクターイメージに基づいて、キャラクターアニメーションビデオを生成します。このトピックでは、このモデルが提供するビデオ生成機能の API の呼び出し方法について説明します。

    重要

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

    モデル概要

    モデル紹介

    モデル

    説明

    animate-anyone-gen2

    animate-anyone-gen2 は、キャラクターイメージとアクションテンプレートに基づいてビデオを生成するキャラクターアニメーションモデルです。

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

    キャラクターイメージ

    アクションテンプレート

    出力 (イメージ背景)

    出力 (ビデオ背景)

    05-9_16

    04-9_16

    説明

    • 上記の例は、AnimateAnyone を統合した Tongyi App によって生成されました。

    • アクションテンプレートは、AnimateAnyone アクションテンプレート生成 API を通じて作成する必要があります。アクションテンプレートのソースビデオが関連する法律および規制に準拠していること、およびビデオコンテンツ (オーディオを含む) を使用するためのライセンスを取得していることを確認してください。

    HTTP の使用

    機能説明

    キャラクターアクションビデオの生成に使用されます。

    前提条件

    入力制限

    • イメージフォーマット: JPEG、PNG、BMP。

    • イメージ要件: イメージファイルサイズ < 5MB、最大縦横比 2:1、最大エッジ長 ≤ 4096 ピクセル。

    • アップロードされたイメージファイルは HTTP リンクをサポートしますが、ローカルパスはサポートしません。Model Studio が提供する 一時記憶領域 を使用してローカルファイルをアップロードし、リンクを作成することもできます。

    • 入力イメージとビデオ生成タイプの関係:

      入力イメージ

      イメージ背景で生成

      (use_ref_img_bg を true に設定)

      ビデオ背景で生成

      (use_ref_img_bg を false に設定)

      全身ポートレート

      サポート

      サポート

      半身ポートレート

      サポート

      非推奨

      説明

      ビデオ背景で生成する場合、イメージ内のキャラクターをビデオ内のキャラクターの対応する位置に一致させる必要があります。半身ポートレートイメージに表示されない領域 (脚など) については、モデルが欠落部分をランダムに生成するため、大きな不確実性が生じます。したがって、この条件下でのビデオ生成は推奨されません。

    タスクの送信

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

    • このアルゴリズムは時間がかかるため、非同期呼び出しメソッドを使用してタスクを送信します。

    • タスクが送信されると、システムは対応するタスク ID を返します。この ID を使用して、「タスクステータスクエリと結果取得インターフェイス」を通じてタスクのステータスと対応する結果を取得できます。

    リクエストパラメーター

    パラメーター

    タイプ

    メソッド

    必須

    説明

    例

    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-gen2

    input.image_url

    String

    Body

    はい

    ユーザーがアップロードしたイメージの URL。このイメージは、まず AnimateAnyone イメージ検出 API を通じて処理され、目的の出力フレームに従って適切にトリミングされる必要があります。

    • イメージファイルサイズ < 5MB、最大縦横比 2:1、最大エッジ長 ≤ 4096

    • サポートされているフォーマット: JPEG、PNG、BMP。

    説明

    ファイルのアップロードは HTTP リンクのみをサポートし、ローカルファイルパスはサポートしません。

    http://aaa/bbb.jpg

    input.template_id

    String

    Body

    はい

    アクションテンプレート ID。使用するアクションテンプレートを指定するために使用されます。AnimateAnyone アクションテンプレート生成 API によって生成された template_id を入力する必要があります。

    説明

    アクションテンプレート ID は検証されます。使用する template_id が現在の Alibaba Cloud アカウントによって作成されたものであることを確認してください。

    使用上の提案: テンプレートビデオの解像度とフレームレートを上げると、生成されるビデオの品質を効果的に向上させることができます。

    AACT.xxx.xxx-xxx.xxx

    parameters.use_ref_img_bg

    Boolean

    Body

    いいえ

    生成されるビデオの背景コントロール。

    • true に設定すると、ビデオは入力イメージの背景を使用します。

    • false に設定すると、ビデオは元のビデオの背景を使用します。これがデフォルト値です。

    false

    parameters.video_ratio

    String

    Body

    いいえ

    イメージ背景でビデオを生成する場合、利用可能な縦横比は "9:16" または "3:4" で、デフォルトは "9:16" です。

    説明

    ビデオ背景で生成する場合 (use_ref_img_bg が false に設定されている場合)、このパラメーターは効果がありません。新しいビデオは、テンプレートビデオの縦横比に従って生成されます。

    説明

    生成されるビデオの歪みを避けるために、入力イメージの縦横比が選択した縦横比と一致していることを確認する必要があります。

    "9:16"

    応答パラメーター

    パラメーター

    タイプ

    説明

    例

    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/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": "http://xxx/1.jpg",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
      "parameters": {
         "use_ref_img_bg": false,
         "video_ratio": "9:16"
    }
  }'

    応答の例

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

    はい

    クエリ対象のタスクの 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

    リクエスト 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",
        "video_url":"https://xxx/1.mp4"
    },
    "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

    InvalidURL.ConnectionRefused

    ${url} への接続が拒否されました。利用可能な URL を指定してください

    ダウンロードが拒否されました。利用可能な URL を指定してください

    400

    InvalidURL.Timeout

    ${url} のダウンロードがタイムアウトしました。ネットワーク接続を確認してください。

    ダウンロードがタイムアウトしました。タイムアウト期間は 10 秒です

    400

    InvalidFile.Size

    無効なファイルサイズです。イメージファイルサイズは 5 MB 未満である必要があります。

    イメージファイルが 5 MB を超えています

    400

    InvalidFile.Resolution

    最長辺が 4096 ピクセル未満、最短辺が 224 ピクセルより大きいことを確認してください。

    アップロードされたイメージサイズが要件を満たしていません

    400

    InvalidFile.AspectRatio

    無効なファイル比率です。ファイルの縦横比 (高さ/幅) は 0.5 から 2.0 の間でなければなりません

    イメージファイルの最大縦横比は 2:1 である必要があります

    400

    InvalidFile.Template.Content

    無効なテンプレートコンテンツです。

    アクションテンプレートに権限がないか、テンプレートコンテンツが要件を満たしていません。

    400

    InvalidParameter

    parameters.video_ratio は 9:16 または 3:4 である必要があります

    video_ratio 入力パラメーターは "9:16" または "3:4" のみ可能です