Wan 2.2 Animate APIは何をするものですか?

Wan 2.2 Animate APIは、キャラクター画像と駆動用動画から、そのキャラクターが動画の動きを演じる新しいクリップを作ります。エンドポイントは character-animation の1つで、2つのモードがあります。animate は画像側の背景を保ち、replace はキャラクターを駆動用動画側の場面に入れます。出力は駆動用動画の長さ（2〜30秒）に一致し、解像度は480pか720pです。

Wan 2.2 Animateのanimateモードとreplaceモードの違いは何ですか?

Wan 2.2 Animateでは、animateモードは image_url のキャラクターを駆動用動画の動きで動かしつつ画像自身の背景を保ちます。replaceモードは video_url 内の人物をそのキャラクターに差し替え、動画側の場面を保ちます。animation_mode のデフォルトはanimateなので、映像内のロケーションが重要ならreplace、キャラクター自身の背景が重要ならanimateを選びます。

Wan 2.2 Animateに適した駆動用動画の条件は何ですか?

Wan 2.2 Animateに適した駆動用動画は2〜30秒で、全編にわたって演者の体と顔が映っている必要があります。AlibabaのWan-Animate論文によると、体の動きは骨格信号から、表情は顔の特徴から再現されるため、手足が切れていたり顔がそむいていたりすると手がかりが減ります。長さがそのまま出力の長さになるので、望む動きの部分だけにトリミングしてください。

Wan 2.2 Animateはreplaceモードで場面の照明をどう扱いますか?

Wan 2.2 Animateには照明を制御するフィールドがなく、その調整はモデルに任されます。AlibabaのWan-Animate論文では、置き換えは場面の照明と色調を挿入するキャラクターに適用するものとされ、外見の一貫性を保つ補助的なRelighting LoRAが使われていると説明されています。リクエストごとに調整できる項目はないため、長いレンダーに進む前に短い480pテストで仕上がりを確認してください。

Wan 2.2 Animate APIの料金はどう決まりますか?

Wan 2.2 Animate APIは配信された動画の秒数で課金され、料金を決める唯一のフィールドは解像度で、480pと720pの2階層があります。現在の秒単位料金はこのページにリアルタイムで表示されます。各タスクはまず30秒上限で見積もられ、実際の出力の長さで確定した際に差額が返金されます。

Wan 2.2 Animateのキャラクター画像に明確な顔や人物がない場合どうなりますか?

image_url に顔も人物も見つからない場合、Wan 2.2 Animateはタスクを invalid_request として拒否します。対処法は別のキャラクター画像を使うことで、人物の全身が切れたり隠れたりせずはっきり見えているものを選んでください。promptや駆動用動画を変えても解決にはなりません。このチェックはキャラクター画像単独に対して行われるためです。

Wan 2.2 Animateはseedに対応していますか?

はい、Wan 2.2 Animateは0から2,147,483,647までのseedを受け付け、0はランダムなseedを要求します。固定値は同じ駆動用動画でのテイク比較に役立ちます。seedを固定し、promptやanimation_modeなど別の入力だけを変えて、2つの結果を並べて確認してください。実行のたびに新しいランダムseedが欲しいときは0を使います。

Wan 2.2 Animateはどのファイル形式に対応していますか?

Wan 2.2 Animateはキャラクター画像としてJPEG、PNG、WebPのアップロードに対応しています。駆動用動画は最大90MBのMP4アップロード、またはMP4かMOVファイルを指すURLです。その駆動用動画は2〜30秒である必要があり、その長さが生成されるクリップの長さを決めます。

Wan 2.2 AnimateはWan 2.2のimage-to-videoとどう違いますか?

Wan 2.2 Animateは駆動用動画から動きを得ますが、Wan 2.2のimage-to-videoは1枚の開始フレームと最大5,000文字の必須テキストプロンプトから何が起こるかを記述して開始します。Wan 2.2 Animateの出力は駆動用動画の長さ（2〜30秒）に従い秒単位で課金され、Wan 2.2のimage-to-videoはリクエスト単位で課金されます。どちらも480pと720pに対応します。

Wan 2.2 Animateで実在の人物の写真や映像を使えますか?

Wan 2.2 Animateは写真内の人物を実写映像に配置できるため、両方のファイルに権利と同意が関わります。所有しているか使用許可を得た画像と動画を使い、成人のみを写し、出力を特定の人物になりすます目的や本人の同意のない親密な映像を作る目的に使わないでください。プラットフォームはリクエストを個別に審査せず、モデル自身の制限が適用され、結果についてはアカウント保有者が責任を負います。

Wan 2.2 Animate API — キャラクターに動きを転写

alibaba/wan-2.2-animate/character-animation

Alibaba の Wan 2.2 Animate は、画像 1 枚の人物を駆動動画の動きで動かすキャラクターアニメーションです。動画は 2〜30 秒で、出力も同じ長さ、480p または 720p です。

最低価格 $0.053/秒

モデルを実行 API を見る

入力

キャラクターアニメーション

プロンプト0/2000

アニメーション方式

画像の人物を動かす動画の人物を差し替える

入力画像1/1

ファイルやメディアのリンクをドロップ、貼り付け、または選択 · 1 ファイル・1 件 10 MB まで・JPG · PNG · WEBP

入力動画1/1

動画をここにドロップ、またはここから選択 · 1 ファイル・1 件 90 MB まで・MP4

解像度料金に影響

シード値

セーフティチェックオフ

SpicyAPI はこのモデルにセーフティチェックをかけません。プロンプトと素材はそのままモデルに渡り、出力はモデル自身が決めます。

送信と料金見積もりを有効にする前にアカウントを確認しています。

出力

実行待ち

サンプル出力

延長

動画アップスケール

動画編集

{
  "model": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "resolution": "480p",
    "image_url": "https://cdn.spicyapi.ai/models/examples/inputs/f404aa8717ae6a4f.webp",
    "video_url": "https://cdn.spicyapi.ai/models/examples/inputs/96d541c6c1ffdf0e.mp4"
  }
}

はじめに

Wan 2.2 Animate は、確定済みのキャラクター画像と、別に用意した動きの参照動画から、そのキャラクターが演じる新しいクリップを作ります。見た目と動きがすでに別々の素材で決まっていて、1 つの素材に両方を求めたくないときに使います。

モードは 2 つあります。animation_mode を animate にすると、画像のキャラクターが元動画の動きで動きます。replace にすると、元動画の人物が画像の人物に置き換わり、動画のシーンはそのまま残ります。出力は元動画と同じ 2〜30 秒で、解像度は 480p か 720p です。

主な機能とハイライト

長いプロンプトより、きれいな A ポーズ

公開している参照画像は、このエンドポイントが求める画像そのものです。全身がフレームに収まり、ニュートラルな A ポーズで、継ぎ目のない背景に均一な光が当たっています。出力の見た目はすべてこの画像から来ます。見切れていたり大きく隠れていたりする画像は、そこから作るすべてのクリップの限界になり、プロンプトでは取り戻せません。

クリップの長さは元動画と同じ、最長 30 秒

出力は元動画と同じ長さで、元動画は 2〜30 秒である必要があります。2 分の素材なら先に切り詰めてください。課金は見積もりに使った上限ではなく実際に納品された秒数に基づくので、アップロード前に元動画を切り詰めることが、コストを直接抑える方法です。

720p を払う前に 480p で似ているかを確認

公開しているクリップは、同じ画像を参照動画で動かしたものです。同じバーガンディのトップス、同じワイドパンツのまま、今度は回転の途中です。解像度は料金帯で、720p は 480p より 1 秒あたりの料金が高いので、まず使える最短の元動画を使い、480p で人物の同一性とシルエットが保たれるかを確認しましょう。

リクエストパラメーター

Wan 2.2 Animate · Character Animation のリクエストパラメーター
パラメーター	必須	説明
`animation_mode`	いいえ	Animate は画像のキャラクターを駆動動画の動きで動かします。Replace は駆動動画の人物を画像のキャラクターに差し替え、場面はその動画のまま残します。 `animate` · `replace` · デフォルト値: `animate`
`image_url`	はい	キャラクター画像です。ここに写っている人物が動かされるので、シルエットのはっきりした、均一な光の全身プレートを使ってください。 1 文字以上
`video_url`	はい	駆動動画です（2〜30 秒）。MP4 をアップロードするか、MP4 または MOV の URL を指定してください。 1 文字以上
`resolution`	いいえ	480p か 720p、既定は 720p で、単価の段でもあります。480p で転送を証明してから、出すつもりのテイクを再レンダリングしてください。 `480p` · `720p` · デフォルト値: `720p`
`prompt`	いいえ	任意、最大 2000 文字。アニメーションの作風と内容を導きます。 2000 文字以内
`seed`	いいえ	0〜2147483647。0 はランダム seed の要求です。 `≥ 0` · `≤ 2147483647`

料金

出力の長さはドライビング動画に合わせられ、その秒数で課金されます。

料金
仕様	料金
`480p`	$0.053 / 秒
`720p`	$0.11 / 秒

ユースケース

既存の映像にキャラクターを入れる

animation_mode を replace にすると、映像自体のシーンは保ったまま、元動画の人物が画像のキャラクターに置き換わります。ロケーションはすでに動画としてあり、演じる人だけを変えたいときに使います。

1 枚のキャラクターシートから短いループを

最長 30 秒あれば、フィード用のループ、スタンプ、リアクションクリップに十分です。画像は 1 枚のまま元動画を差し替えれば、手を振る、振り向く、肩をすくめるといったジェスチャーのライブラリができ、同じ参照画像を共有しているのでどれも同じキャラクターに見えます。

ダンスやパフォーマンス

キャラクター画像と、求める振り付けの元動画を用意します。衣装と体型は画像で固定され、タイミング、重心、カメラは映像から来ます。制約になるのは権利です。画像と元動画の両方の権利が必要で、結果の使い方にはお客様が責任を負います。

長いレンダリングの前に画像を試す

480p で 5 秒の転写を試し、新しいキャラクター画像が動いても顔、手、シルエットを保てるかを確認します。30 秒の本番に使う前に、出来の悪い画像を最も安く見極める方法です。

主なユースケースのチュートリアルを見る

プロンプトガイドと実践のヒント

キャラクター画像を作る

全身がフレームに収まり、ニュートラルなポーズで、無地の背景に均一な光を当てます。この画像が、それで動かすすべてのクリップの顔、衣装、プロポーションを決めるので、いくつか作って選び抜く価値があります。画像から顔や人物が見つからない場合、タスクは invalid_request で拒否されます。公開している画像は次のプロンプトから作りました。「Full-body studio photograph of an adult female dancer standing in a neutral A-pose against a seamless grey backdrop, wearing a cropped burgundy tank top and high-waisted wide-leg trousers, barefoot, hair tied back, even soft studio lighting, sharp full-length framing, clean reference plate for character animation.」

元動画を必要な秒数に切り詰める

出力の長さは元動画と同じで、元動画は 2〜30 秒である必要があり、料金は納品された秒数に対してかかります。MP4 をアップロードするか、MP4 または MOV ファイルへの直接リンクを渡してください。動画を再生するだけの Web ページはファイルではないため呼び出しは失敗し、料金は返金されます。

プロンプトは人物ではなくスタイルに使う

prompt は任意で、最大 2000 文字です。アニメーションのスタイルと内容を導くもので、人物の同一性はキャラクター画像が担います。同じ元動画で 2 回の実行を比べたいときは seed を固定します。

繰り返す前に結果を確かめる

2 つの入力はどちらも必須で、入れ替えはできません。人物は画像から、動きは動画から来ます。animate モードでは背景はキャラクター画像のまま残ります。参照の実行では元動画はキッチンで撮影されていましたが、結果は画像のグレーのスタジオ背景のままで、引き継がれたのは動きとカメラだけでした。長い素材が圧縮されることはないので、アップロード前に切り詰めてください。

API クイックスタート

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://example.com/reference.png",
    "resolution": "720p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。

駆動用動画の動きを1枚のキャラクター画像に転写する

Wan 2.2 Animate API の character-animation エンドポイントは image_url と video_url という2つの必須入力を受け取り、駆動用動画の動きを画像内の人物へ移します。animation_mode で方向を選びます。animate なら画像側の背景を保ったままそのキャラクターを動かし、replace なら駆動用動画側の背景を保ったまま人物を画像内のキャラクターに差し替えます。出力は駆動用動画と同じ長さの2〜30秒で、解像度は480pか720pです。

プレイグラウンドを開く

必須入力: image_url（キャラクター）と video_url（駆動用クリップ）
モード: animation_mode: animate（デフォルト）または replace
駆動用動画の長さ: 2〜30秒。出力もこの長さに一致
解像度: 480pまたは720p、デフォルトは720p、料金階層も同じ
プロンプト: 任意、最大2,000文字。動きのスタイルと内容を指示する
動画入力: 最大90MBのMP4アップロード、またはMP4かMOVのURL

モード: animate は画像側の背景を残し、replace は動画側の背景を残すanimation_mode がどちらの背景が残るかを決めます。animate はキャラクター画像自身の設定を保ったままそのキャラクターを駆動用動画の動きで動かし、replace は駆動用動画の背景を保ったまま元の人物の位置に画像のキャラクターを差し込みます。
役割分担: 見た目は image_url、動きは video_url が担う両方のURLが必須で、それぞれ結果の異なる部分を受け持ちます。任意の prompt（最大2,000文字）は動きのスタイルと内容を指示しますが、画面に映る人物を決めるものではありません。人物はキャラクター画像に属します。
長さ: 長さを設定するフィールドは存在しない出力の長さは video_url に渡した動画そのものの長さで、その駆動用動画は2〜30秒である必要があります。つまりアップロードするファイルが長さの設定そのものなので、送信前に望む区間ぴったりにトリミングしてください。

Wan 2.2 Animate API が得意なこと

1つのAlibabaモデルがアニメーション化と置き換えの両方をカバーする

Alibabaは2025年9月19日にWan2.2-Animate-14Bを、キャラクターアニメーションとキャラクター置き換えを1つのモデルで扱うオープンウェイトモデルとして公開しました。このAPIは両方の動作を1つのエンドポイントにまとめており、animation_mode で切り替えるだけで、解像度からseedまで他のすべてのフィールドはどちらのモードでも同じように動作します。

体の動きと表情はどちらも駆動用動画から得られる

AlibabaのWan-Animate論文によると、このモデルは空間的に整列させた骨格信号で体の動きを再現し、ソース画像から抽出した暗黙の顔特徴で表情を再現します。演者の体と顔が全編にわたって映っている駆動用動画なら、モデルに両方の手がかりを与えられます。

replace モードは手元にある映像を再利用できる
animation_mode を replace に設定すると、video_url 内の人物を image_url のキャラクターに差し替えつつ、動画の背景とカメラワークはそのまま残ります。1つの撮影場所を、キャラクターごとに1枚の画像を用意するだけで、再撮影せずに何通りものバージョンに使い回せます。
価格に影響するのは解像度と実際の出力秒数だけ
課金は出力秒数に基づき、料金を決める唯一のフィールドは解像度で、480pと720pの2階層です。animation_mode、prompt、seedは料金を変えません。各タスクはまず30秒の上限で見積もられ、実際の長さで確定した際に差額が返金されます。
キャラクター画像には顔か人物が写っている必要がある
image_url に顔も人物も見つからない場合、タスクは invalid_request として拒否されます。キャラクター画像は見た目全体の情報源でもあるため、エンドポイン自身のガイドラインでも、輪郭がはっきりした全身と均一な光でモデルに人物を明確に伝えることを勧めています。
テイクを比較するためのseed
seed は0から2,147,483,647までの整数を受け付け、0はランダムなseedを要求します。ある値を固定しつつ prompt や animation_mode などの他の1点だけを変えると、同じ駆動用動画から作った2つのテイクを比較しやすくなります。

Wan 2.2 Animate はどんな人に向くか

キャラクター/IPの権利者
承認済みキャラクターに新しい動きを与える
完成したキャラクターデザインを持つチームは、その1枚の静止画を animate モードで録画済みの演技と組み合わせられます。人物が写っていれば、素材は描画でもレンダリングでも構いません。見た目は image_url に残り、タイミングと仕草は駆動用動画から得られるため、新しいクリップにキャラクターの再レンダリングは不要です。
動画編集者
撮影済みのショットの人物を差し替える
animation_mode を replace に設定すれば、既存のテイクに別のキャラクターを入れられます。背景とカメラワークは駆動用動画から得られるため、1つのロケーション撮影を複数のキャラクターで使い回せます。映像内の人物とキャラクター画像側の人物、両方からの同意は依然として必要です。
ダンス・フィットネス系クリエイター
キャラクターに一連のルーティンを演じさせる
全身が写ったキャラクター画像と、最大30秒の振り付けやワークアウトの動画を animate モードで組み合わせます。出力はそのルーティンと同じ長さになるため、駆動用動画が長ければクリップも長くなり、料金は解像度ごとの同じ秒単位レートで課金されます。
アプリ開発者
プロダクト内でモーションテンプレートを提供する
アプリ側で短い駆動用クリップのライブラリを持ち、ユーザーには自分自身または権利を持つキャラクターの1枚の画像だけを求められます。各リクエストに必要なのは2つのURLと animation_mode だけで、テンプレートに応じて prompt と seed を追加します。

Wan 2.2 Animate API の使い方

まず animate か replace かを決める
animation_mode が出力にどちらの背景が残るかを決めます。animate ならキャラクター画像自身の背景、replace なら駆動用動画側の背景です。フィールドを未設定にすると animate になります。
キャラクター画像と駆動用動画を用意する
image_url にはJPEG、PNG、WebPのいずれかでキャラクターをアップロードします。video_url には最大90MBのMP4アップロード、またはMP4かMOVのURLで駆動用クリップを指定します。どちらも必須です。
駆動用動画は2〜30秒に収める
出力の長さは入力とぴったり同じになるため、アップロード前に動かしたい範囲へトリミングしてください。2秒未満または30秒を超える駆動用動画は、課金される前に invalid_request として拒否されます。
解像度階層を選ぶ
resolution を480pか720pに設定するか、省略すると720pになります。秒単位のレートを変える唯一のフィールドなので、新しい画像と動画の組み合わせを試すには480pパスが低コストです。
動きを誘導したいときだけpromptを追加する
そのまま転写するだけならpromptは省略し、動きのペースやエネルギーといったスタイルについて最大2,000文字を加えます。キャラクターの見た目は image_url から読み取られるため、外見に関する記述は避けてください。
seedを設定し、送信して結果を受け取る
テイクを比較する予定なら seed に1から2,147,483,647の固定値を、ランダムにしたいなら0を指定します。タスクは非同期で実行されるため、返されたタスクIDを保持してポーリングするか、コールバックURLを登録してください。

Wan 2.2 Animate の実際の例

全身キャラクターにダンスルーティンを踊らせる
全身が写ったキャラクター画像とダンスルーティンの駆動用動画を animate モードで組み合わせます。キャラクターが振り付けを演じ、キャラクター画像側の背景はそのまま残り、クリップの長さはダンス動画とぴったり同じになります。
```
Smooth, energetic dance movement with confident posture and fluid arm gestures
```
既存ショットの演者を差し替える
animation_mode を replace に設定し、駆動用動画内の人物を image_url のキャラクターに差し替えます。駆動用動画のロケーションとカメラワークはそのまま残るため、新しいキャラクターは元は別の人物のために撮影された映像の中に現れます。
```
Natural, expressive movement matching the pace of the original performance
```
同じ駆動用動画で2つのseedを比較する
同じ image_url と video_url を animation_mode を animate に固定したまま2回実行し、seed だけを変えて、最終レンダー用に1つの値を選ぶ前に結果のばらつきを確認します。
```
Subtle, natural motion with relaxed shoulders and a steady gaze toward camera
```

Wan 2.2 Animate API のよくある質問

image_url と video_url を、結果を決める2つの入力として扱ってください。キャラクター画像は見た目と、animateモードでは背景を提供し、駆動用動画は動きと、replaceモードでは場面を提供します。ペースや雰囲気のメモにはpromptを使い、見た目は画像に任せます。駆動用動画は必要な動きを示す最短の範囲までトリミングしてください。短いクリップほどテストのコストが低く、結果も判断しやすくなります。