Wan 2.2 Animate kombiniert ein Charakterbild mit einem Quellvideo, das die Bewegung vorgibt. Im dokumentierten Ablauf der Character Swap API von AKOOL bestimmt das Bild das Aussehen des Charakters, während das Quell-MP4 die Darbietung liefert. Das Beispiel der API-Antwort nennt wavespeed-ai/wan-2.2/animate als zugrunde liegendes Modell.
AKOOL stellt diese Funktion über seine Character Swap API bereit. Das unterscheidet sich davon, einfach ein allgemeines Text-zu-Video-Modell aus einer Liste von KI-Videotools auszuwählen.
Kurzüberblick
- Das Aussehen stammt aus dem Bild: Laden Sie ein Charakterbild als PNG oder JPEG hoch.
- Die Bewegung stammt aus dem Video: Stellen Sie ein MP4 mit der Darbietung bereit, die Sie übertragen möchten.
- Animate und replace sind unterschiedliche API-Modi:
animateüberträgt Bewegungen auf das Charakterbild, währendreplaceden für diesen Endpunkt dokumentierten Gesichtsaustausch ausführt. - Speichern Sie die Aufgaben-ID: Die Generierung erfolgt asynchron. Prüfen Sie mit der zurückgegebenen
_idden Status und laden Sie das fertige Video herunter, bevor seine URL nach sieben Tagen abläuft.
Inhaltsverzeichnis
- Was ist Wan Animate?
- Wie unterscheiden sich die Modi animate und replace?
- Wie bereiten Sie ein Bewegungsreferenzvideo vor?
- Wie verwenden Sie die Wan Animate API über AKOOL?
- Welche Prompts helfen bei der Charakteranimation?
- Warum scheitert die KI-Bewegungsübertragung auf Charaktere?
- Wie prüfen und speichern Sie das Ergebnis?
- Häufig gestellte Fragen
Was ist Wan Animate?
Wan Animate ist ein referenzbasierter Ablauf zur Charakteranimation: Ein Bild definiert das Aussehen des Charakters, während ein Quellvideo die anzuwendende Bewegung liefert. In AKOOLs Character Swap API kombiniert der dokumentierte Modus animate diese Eingaben und kann das Ergebnis optional mit einem kurzen Textprompt steuern.
Der Ablauf lässt sich anhand von drei Ressourcen leichter verstehen:
| 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 |
AKOOLs Erstellungsendpunkt benötigt eine Charakterbild-URL im Format PNG oder JPEG und eine Quellvideo-URL im Format MP4. Das Beispiel der API-Antwort nennt wavespeed-ai/wan-2.2/animate als Modell; dieser Modellname ist somit durch API-spezifische Angaben belegt. Daraus lässt sich nicht ableiten, dass die öffentliche Website einen gleichnamigen Menüeintrag anbietet.
Wie unterscheiden sich die Modi animate und replace?
Am dokumentierten Endpunkt von AKOOL überträgt animate die Bewegung aus dem Quellvideo auf das Charakterbild. replace ist ein anderer Modus, der mithilfe des bereitgestellten Charakterbilds Gesichter im Quellvideo ersetzt. Diese Definitionen gelten für diesen AKOOL-API-Endpunkt und nicht für jedes Produkt, das die Wan-Modellfamilie verwendet.
| 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 |
Wenn kein Modus angegeben wird, verwendet der Endpunkt standardmäßig animate.
Diese Unterscheidung ist wichtig, weil animate und replace zwei verschiedene Transformationen beschreiben. Wenn Sie eine vollständige KI-Bewegungsübertragung auf Charaktere wünschen, beginnen Sie mit animate.
Einen separaten Produktionsablauf auf Basis von Kling beschreibt AKOOLs Leitfaden zum Charakteraustausch mit Bewegungssteuerung. Kling 2.6 folgt ebenfalls der Grundidee, ein Charakterbild mit einer Referenzdarbietung zu kombinieren, verwendet jedoch ein anderes Modell und einen anderen Ablauf.
Wie bereiten Sie ein Bewegungsreferenzvideo vor?
Verwenden Sie eine klar erkennbare Quelldarbietung, deren Bildausschnitt und sichtbare Körperbereiche zum Charakterbild passen. Je eindeutiger die Referenz, desto leichter lässt sich beurteilen, ob Fehler vom Quellmaterial oder von der Generierung stammen.
Stimmen Sie den Bildausschnitt ab
Wenn Ihr Bewegungsvideo einen gehenden Menschen in Ganzkörperansicht zeigt, verwenden Sie ein Charakterbild, das ebenfalls genügend Informationen zum ganzen Körper liefert.
Ein eng beschnittenes Porträt in Kombination mit Laufen, Tanzen oder großen Beinbewegungen zwingt das Modell, eine Anatomie zu erfinden, die im Bild nie zu sehen war.
Für stärkere referenzbasierte Videokonsistenz empfiehlt AKOOL klar erkennbare Motive, sichtbare Identitätsmerkmale und Referenzmaterial, das die zu erhaltenden Elemente festlegt.
Halten Sie die darstellende Person sichtbar
Wählen Sie eine Bewegungsreferenz, in der die darstellende Person im Bild bleibt.
Vermeiden Sie Quellclips, in denen:
- die Füße wiederholt den Bildausschnitt verlassen,
- die Hände hinter dem Körper verschwinden,
- eine andere Person vor dem Motiv vorbeiläuft,
- die Kamera plötzlich den Bildausschnitt ändert,
- die darstellende Person sehr klein erscheint.
Verringern Sie Verdeckungen
Verschränkte Arme, verborgene Hände, Requisiten vor dem Oberkörper und schnelle Drehungen erschweren die Prüfung der Bewegungsübertragung.
Bessere Referenz: ganzer Körper sichtbar, moderate Bewegung, stabile Kamera.
Schwierigere Referenz: abgeschnittene Füße, wiederholte Drehungen, hinter Requisiten verborgene Hände, mehrere Schnitte.
Wie verwenden Sie die Wan Animate API über AKOOL?
Senden Sie eine Charakterbild-URL und eine Quell-MP4-URL an AKOOLs Character Swap-Erstellungsendpunkt, setzen Sie mode auf animate, ergänzen Sie optional einen Prompt und speichern Sie die zurückgegebene _id. Verwenden Sie diese Kennung mit dem Ergebnisendpunkt, bis die Aufgabe completed erreicht.
Der dokumentierte Erstellungsendpunkt lautet:
POST https://openapi.akool.com/api/open/v4/characterSwap/create
AKOOL akzeptiert entweder einen x-api-key-Header oder eine Bearer-Authentifizierung.
Aktuelle Angaben zur Authentifizierung und zu den Endpunkten finden Sie in der offiziellen Anleitung zur Character Swap API.
Anfragebeispiel mit unkenntlich gemachten Zugangsdaten
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."
}'
Die wichtigen Felder sind:
| 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 |
Diese Werte sind dokumentierte Parameter dieses Endpunkts und keine allgemeinen Wan-Grenzwerte für alle Plattformen. Die Antwort enthält eine _id. Speichern Sie diese.
So prüfen Sie die Aufgabe:
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
Die Aufgabenstatus lauten:
1: in der Warteschlange2: in Bearbeitung3: abgeschlossen4: fehlgeschlagen
Wenn der Status 3 erreicht, erscheint die generierte URL im Feld video.
Welche Prompts helfen bei der Charakteranimation?
Betrachten Sie Text als Anleitung, nicht als Quelle der Darbietung. Die Bewegungsreferenz sollte die Aktion festlegen. Ihr Prompt sollte Identität, Bildausschnitt und Einfachheit unterstützen, statt Bewegungen zu fordern, die dem Quellvideo widersprechen.
1. Einfache Geste
Übertrage die langsame Begrüßungsgeste aus dem Referenzvideo auf den bereitgestellten Charakter. Behalte Kleidung und Frisur bei. Verwende fließende Bewegungen.
2. Präsentierende Person
Folge den Handbewegungen und dem Tempo der Referenzperson. Halte den Charakter der Kamera zugewandt. Füge keine zusätzlichen Gesten hinzu.
3. Gehen
Folge dem bereitgestellten Gehzyklus. Bewahre die Proportionen und das Outfit des Charakters. Halte beide Füße sichtbar.
4. Stilisierter Charakter
Animiere den bereitgestellten illustrierten Charakter mit dem Timing der Referenz. Bewahre seine flächigen Farben und gezeichneten Konturen.
5. Korrekturprompt
Verwende denselben Charakter und einen langsameren, unbeschnittenen Referenzclip. Halte die Bewegung einfach und den ganzen Körper im Bild.
Betrachten Sie diese Beispiele nicht als magische Syntax. Es sind optionale Vorgaben, die eine bereits durch das Video gelieferte Darbietung eingrenzen.
Warum scheitert die KI-Bewegungsübertragung auf Charaktere?
Die meisten sichtbaren Fehler entstehen durch schlecht aufeinander abgestimmte Eingaben oder durch Bewegungen, bei denen das Modell im Charakterbild fehlende Informationen rekonstruieren muss. Korrigieren Sie das Quellpaar, bevor Sie den Prompt weiter ausbauen.
| 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 |
Eine Bewegungsreferenz verringert Vermutungen, garantiert aber keine perfekte Erhaltung des Charakters. Deshalb ist die Vorbereitung der Eingaben genauso wichtig wie der Prompt.
Wie prüfen und speichern Sie das Ergebnis?
Eine abgeschlossene API-Aufgabe bedeutet nur, dass die Generierung beendet ist. Sie bedeutet nicht, dass das visuelle Ergebnis Ihre Qualitätsprüfung bestanden hat. Prüfen Sie Anfang, Mitte und Ende, bevor Sie den Clip akzeptieren.
Prüfen Sie:
- Gesicht: Bleibt die Identität erkennbar?
- Hände: Bleiben die Finger bei Gesten und Überkreuzungen korrekt?
- Füße: Bleiben beide Füße beim Gehen oder bei Ganzkörperbewegungen stabil?
- Kleidung: Bleiben Farben, Muster und Silhouetten konsistent?
- Hintergrund: Bleibt er im Zusammenhang mit der Bewegung stimmig?
AKOOLs Ergebnisendpunkt liefert die tatsächliche Dauer, Auflösung, abgezogene Credits, die endgültige Video-URL und gegebenenfalls den Fehlergrund.
Generierte Ressourcen sind sieben Tage gültig. Laden Sie freigegebene Ergebnisse daher zeitnah herunter und archivieren Sie sie.
Testen Sie den Ablauf
Wenn Sie über diesen API-Ablauf hinausgehende Generierungsoptionen benötigen, entdecken Sie AKOOLs KI-Videotools.
Einen weiteren referenzbasierten Ansatz beschreibt der Charakteraustausch mit Bewegungssteuerung. Hinweise zum Erhalt von Charakteren und visueller Identität über zusammengehörige Clips hinweg finden Sie unter referenzbasierte Videokonsistenz.
