Wan 2.2 Animate は、キャラクター画像と動きを提供する元動画を組み合わせます。AKOOL の Character Swap API の公開手順では、画像が外見を、元の MP4 が演技を指定します。API 応答例では、基盤モデルは wavespeed-ai/wan-2.2/animate と示されています。
AKOOL は Character Swap API でこの機能を提供しています。これは AI 動画ツールの一覧から一般的なテキストから動画への生成モデルを選ぶこととは異なります。
要点
- 外見は画像から：PNG または JPEG のキャラクター画像をアップロードします。
- 動作は動画から：転送したい演技が含まれる MP4 を用意します。
- Animate と replace は別の API モード：
animateは画像に動きを転送し、replaceはエンドポイントで規定された顔交換を行います。 - タスク ID を保存：生成は非同期です。返された
_idで状態を確認し、7 日間有効な URL の期限前に動画をダウンロードします。
目次
- Wan Animate とは？
- animate と replace の違いは？
- モーション参照動画をどう準備しますか？
- AKOOL 経由で Wan Animate API を使うには？
- キャラクターアニメーションに役立つプロンプトは？
- AI キャラクターの動作転送が失敗する理由は？
- 出力を確認して保存するには？
- よくある質問
Wan Animate とは？
Wan Animate は参照素材に基づくキャラクターアニメーションの手順です。1 枚の画像が外見を定義し、元動画が適用する動きを提供します。AKOOL の Character Swap API の animate モードは両方の入力を組み合わせ、必要なら短いテキストプロンプトで結果を誘導できます。
次の 3 つの素材として考えると理解しやすくなります。
| Input/output | Role |
|---|---|
| Character image | Defines the character you want to animate |
| Motion reference video | Supplies timing, body motion, and performance |
| Generated video | Combines the character appearance with the referenced motion |
AKOOL の作成エンドポイントには PNG または JPEG のキャラクター画像 URL と、MP4 の元動画 URL が必要です。API 応答例には wavespeed-ai/wan-2.2/animate とあるため、このモデル名は API 固有の根拠があります。ただし、公開サイトに同名のメニューがある証拠ではありません。
animate と replace の違いは？
AKOOL のドキュメントに記載されたエンドポイントでは、animate は元動画の動きをキャラクター画像に適用します。replace は提供した画像で元動画の顔を交換する別のモードです。この定義は当該 AKOOL API に適用され、Wan モデル群を使う全製品に共通するものではありません。
| Mode | Goal | Required inputs | What to review |
|---|---|---|---|
animate | Animate the supplied character using source-video motion | Character image + motion MP4 | Identity, body motion, clothing, hands, feet |
replace | Replace faces in the source video with the supplied character | Character image + source MP4 | Face match, tracking, pose changes, occlusion |
モードを指定しなければ、既定は animate です。
animate と replace は異なる変換なので、区別が重要です。全身の AI キャラクター動作転送が目的なら、animate から始めてください。
Kling を使う別の制作手順は、AKOOL のモーション制御付きキャラクター交換を参照してください。Kling 2.6 も画像と参照演技を組み合わせますが、モデルと手順は異なります。
モーション参照動画をどう準備しますか？
キャラクター画像と画角や身体の写る範囲が合う、明確な元演技を使います。参照が明瞭なほど、問題が素材由来か生成由来かを判断しやすくなります。
画角を合わせる
動作動画が全身の歩行を示すなら、画像にも十分な全身情報が必要です。
顔のアップ画像と走る動作、ダンス、大きな脚の動きを組み合わせると、モデルは画像にない身体構造を補う必要があります。
参照に基づく動画の一貫性を高めるため、AKOOL は明確な被写体、見える識別特徴、維持したい要素を定義する参照素材を推奨しています。
演者を見える状態に保つ
演者が画面内に留まるモーション参照を選びます。
次のような元動画は避けてください。
- 足が何度も画面外に出る、
- 手が身体の後ろに隠れる、
- 他の人が被写体を横切る、
- カメラの構図が急に変わる、
- 演者が非常に小さくなる。
遮蔽を減らす
腕組み、隠れた手、胴体を覆う小道具、素早い回転は、演技転送の確認を難しくします。
適した参照：全身が見え、動きが適度で、カメラが安定しているもの。
難しい参照：足が切れ、回転が多く、手が小道具に隠れ、カットが多いもの。
AKOOL 経由で Wan Animate API を使うには？
キャラクター画像と元 MP4 の URL を AKOOL の Character Swap 作成エンドポイントに送り、mode を animate に設定します。必要ならプロンプトを追加し、返された _id を保存します。その識別子を結果エンドポイントで使い、タスクが completed になるまで確認します。
公開されている作成エンドポイントは次のとおりです。
POST https://openapi.akool.com/api/open/v4/characterSwap/create
AKOOL は x-api-key ヘッダーか Bearer 認証に対応しています。
最新の認証とエンドポイントの詳細は、公式の Character Swap API 手順を参照してください。
機密情報を伏せたリクエスト例
curl --location 'https://openapi.akool.com/api/open/v4/characterSwap/create' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"image": "https://example.com/approved-character.png",
"video": "https://example.com/reference-motion.mp4",
"resolution": "720p",
"mode": "animate",
"prompt": "Follow the reference performance with smooth motion. Keep the character appearance and clothing consistent."
}'
重要なフィールドは次のとおりです。
| Field | Purpose |
|---|---|
image | PNG/JPEG character-image URL |
video | MP4 motion-reference URL |
duration | Optional, 1 to 120 seconds; otherwise detected from source |
resolution | 480p, 720p, or 1080p |
mode | animate or replace |
prompt | Optional guidance, maximum 500 characters |
webhookurl | Optional completion callback |
これらは当該エンドポイントの公開パラメーターであり、全プラットフォーム共通の Wan の制限ではありません。応答の _id を保存してください。
ジョブを確認するには：
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
タスクの状態は次のとおりです。
1：待機中2：処理中3：完了4：失敗
状態が 3 になると、生成 URL が video フィールドに表示されます。
キャラクターアニメーションに役立つプロンプトは？
テキストは演技の源ではなく補助として扱います。動作は参照動画が定義します。プロンプトは外見、画角、シンプルさを補強し、元動画と矛盾する動きを求めないでください。
1. 簡単なジェスチャー
参照動画のゆっくりした挨拶動作を、提供したキャラクターに適用してください。服装と髪型を維持し、滑らかに動かしてください。
2. プレゼンター
参照演者の手の動きとペースに従ってください。キャラクターはカメラに向け、余計な身振りは追加しないでください。
3. 歩行
提供した歩行サイクルに従ってください。体型と衣装を維持し、両足を見える状態にしてください。
4. スタイライズされたキャラクター
参照のタイミングで、提供したイラストのキャラクターを動かしてください。平面的な色と描線を保ってください。
5. 修正用プロンプト
同じキャラクターと、よりゆっくりした未トリミングの参照動画を使ってください。動きを単純にし、全身を画面内に保ってください。
これらは万能な構文ではありません。動画が提供する演技に対する、任意の範囲指定です。
AI キャラクターの動作転送が失敗する理由は？
目に見える失敗の多くは入力の不一致や、画像にない情報の再構築を求める動きから生じます。プロンプトを長くする前に元素材の組み合わせを修正してください。
| Symptom | Likely cause | First correction |
|---|---|---|
| Feet deform or disappear | Feet cropped in image/reference | Use full-body inputs |
| Hands look unstable | Hands hidden or crossing | Choose clearer hand motion |
| Body proportions drift | Image and performer builds differ strongly | Use a closer body/proportion match |
| Fast turn breaks identity | Large rotation or face occlusion | Slow the reference movement |
| Background shifts | Reference camera/background changes | Use a steadier source clip |
| Illustrated style softens | Motion reconstruction changes edges/textures | Simplify motion and inspect style drift |
モーション参照は推測を減らせますが、キャラクターの完全な維持は保証しません。入力準備はプロンプトと同じくらい重要です。
出力を確認して保存するには？
API タスクの完了は生成が終わったという意味にすぎず、映像の品質合格を意味しません。採用する前に冒頭、中間、終盤を確認してください。
確認項目：
- 顔：同じキャラクターと認識できますか？
- 手：身振りや交差でも指が保たれていますか？
- 足：歩行や全身動作で両足は安定していますか？
- 服装：色、模様、輪郭は一貫していますか？
- 背景：動きに対して整合していますか？
AKOOL の結果エンドポイントは、実際の長さ、解像度、消費クレジット、最終動画 URL、該当する場合は失敗理由を返します。
生成素材は7 日間有効です。承認済みの出力は速やかにダウンロードして保管してください。
手順を試す
この API 以外の幅広い生成方法が必要なら、AKOOL の AI 動画ツールをご覧ください。
別の参照ベースの方法はモーション制御付きキャラクター交換を参照してください。関連クリップ間で外見を維持する方法は、参照に基づく動画の一貫性をご覧ください。
