Einführung
Wan 2.2 Animate macht aus einem freigegebenen Figurenbild und einer separaten Bewegungsvorlage einen neuen Clip mit der Darbietung dieser Figur. Nutzen Sie es, wenn Aussehen und Bewegung bereits in unterschiedlichen Materialien festgelegt sind, statt beides von einer einzigen Quelle zu verlangen.
Es gibt zwei Modi. Mit animation_mode auf animate bewegt sich die Figur aus Ihrem Bild mit der Bewegung des Steuervideos; mit replace wird die Person im Steuervideo durch die aus Ihrem Bild ersetzt, und die Szene des Videos bleibt erhalten. Die Ausgabe ist so lang wie das Steuervideo, 2 bis 30 Sekunden, in 480p oder 720p.
Wichtige Funktionen und Highlights
Eine saubere A-Pose ist mehr wert als ein langer Prompt
Das veröffentlichte Referenzbild ist genau die Art Bild, die dieser Endpunkt braucht: ganzer Körper im Bild, neutrale A-Pose, nahtloser Hintergrund, gleichmäßiges Licht. Alles, wie die Ausgabe aussieht, kommt aus diesem Bild. Ein beschnittenes oder stark verdecktes Figurenbild begrenzt jeden Clip, den Sie je daraus machen, und kein Prompt holt das zurück.
Der Clip ist so lang wie die Vorlage, bis zu 30 Sekunden
Die Ausgabe ist so lang wie das Steuervideo, das 2 bis 30 Sekunden dauern muss; eine Vorlage von zwei Minuten müssen Sie also zuerst kürzen. Abgerechnet werden die tatsächlich gelieferten Sekunden, nicht die Obergrenze für das Angebot. Das Steuervideo vor dem Hochladen zu kürzen, ist daher der direkte Weg, die Kosten zu steuern.
Die Ähnlichkeit in 480p prüfen, bevor Sie für 720p zahlen
Der veröffentlichte Clip zeigt dasselbe Figurenbild, angetrieben von einem Referenzvideo: dasselbe weinrote Top, dieselbe weite Hose, jetzt mitten in der Drehung. Die Auflösung ist eine Preisstufe, 720p kostet pro Sekunde mehr als 480p. Prüfen Sie also zuerst in 480p mit dem kürzesten brauchbaren Steuervideo, ob Identität und Silhouette halten.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
animation_mode | Nein | Animate bewegt die Figur aus Ihrem Bild mit der Bewegung des Führungsvideos. Replace ersetzt die Person im Führungsvideo durch die aus Ihrem Bild und behält dessen Szene bei. |
image_url | Ja | Das Figurenbild. Die Person hier ist die, die animiert wird – nehmen Sie also eine Ganzkörperplatte mit klarer Silhouette und gleichmäßigem Licht. mindestens 1 Zeichen |
video_url | Ja | Das Antriebsvideo, 2 bis 30 Sekunden lang: Laden Sie ein MP4 hoch oder übergeben Sie eine MP4- oder MOV-URL. mindestens 1 Zeichen |
resolution | Nein | 480p oder 720p, Vorgabe 720p, und eine Preisstufe. Belegen Sie die Übertragung in 480p und rendern Sie dann die Einstellungen neu, die Sie ausliefern wollen. |
prompt | Nein | Optional, bis zu 2000 Zeichen. Er führt Animationsstil und Inhalt – nicht die Identität, die gehört dem Figurenbild. höchstens 2000 Zeichen |
seed | Nein | 0 bis 2147483647; null verlangt einen zufälligen Seed. Festsetzen, um zwei Läufe über demselben Antriebsvideo zu vergleichen. |
Preis
Die Länge des Ergebnisses folgt dem Steuervideo und wird pro Sekunde berechnet.
| Spezifikation | Preis |
|---|---|
| $0.053 / Sekunde |
| $0.11 / Sekunde |
Anwendungsfälle
Ihre Figur in vorhandenes Material setzen
Mit animation_mode auf replace wird die Person im Steuervideo durch die Figur aus Ihrem Bild ersetzt, während das Material seine eigene Szene behält. Nutzen Sie das, wenn der Schauplatz schon als Video existiert und nur die darstellende Person wechseln soll.
Kurze Loops aus einem Figurenblatt
Bis zu 30 Sekunden reichen für einen Feed-Loop, einen Sticker oder einen Reaktionsclip. Behalten Sie ein Figurenbild und tauschen Sie die Steuervideos, um eine Bibliothek von Gesten aufzubauen, etwa Winken, Drehen oder Schulterzucken, die alle als dieselbe Figur erkennbar sind, weil sie dasselbe Referenzbild teilen.
Tanz- und Performance-Abläufe
Ein Figurenbild plus ein Steuervideo des gewünschten Ablaufs: Kleidung und Statur legt das Bild fest, Timing, Gewicht und Kamera kommen aus dem Material. Die Grenze setzt das Eigentum: Sie brauchen die Rechte an Figurenbild und Steuervideo und sind für die Verwendung des Ergebnisses verantwortlich.
Ein Figurenbild vor einem längeren Rendering testen
Führen Sie eine Übertragung von fünf Sekunden in 480p aus, um zu sehen, ob ein neues Figurenbild Gesicht, Hände und Silhouette in Bewegung hält. Das ist der günstigste Weg, ein schlechtes Bild auszusortieren, bevor Sie es für einen vollen 30-Sekunden-Auftrag einsetzen.
Prompt-Leitfaden und Praxistipps
Das Figurenbild erstellen
Ganzer Körper im Bild, neutrale Pose, schlichter Hintergrund, gleichmäßiges Licht. Dieses Bild bestimmt Gesicht, Kleidung und Proportionen jedes Clips, den Sie damit antreiben, es lohnt sich also, einige zu erzeugen und zu verwerfen, bevor Sie sich festlegen. Wird darin kein Gesicht und keine Person gefunden, wird die Aufgabe mit invalid_request abgelehnt. Das veröffentlichte Figurenbild entstand aus diesem Prompt: „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.“
Das Steuervideo auf die nötigen Sekunden kürzen
Die Ausgabelänge entspricht der Länge der Vorlage, die 2 bis 30 Sekunden betragen muss, und bezahlt werden die gelieferten Sekunden. Laden Sie die MP4-Datei hoch oder übergeben Sie einen direkten Link auf eine MP4- oder MOV-Datei; eine Webseite, die das Video nur abspielt, ist keine Datei, und der Aufruf schlägt fehl, wobei der Betrag erstattet wird.
Den Prompt für den Stil nutzen, nicht für die Identität
prompt ist optional und fasst bis zu 2000 Zeichen. Er lenkt Stil und Inhalt der Animation; die Identität gehört zum Figurenbild. Fixieren Sie seed, wenn Sie zwei Durchläufe mit demselben Steuervideo vergleichen wollen.
Das Ergebnis prüfen, bevor Sie iterieren
Beide Eingaben sind Pflicht und nicht austauschbar: Die Identität kommt aus dem Bild, die Bewegung aus dem Video. Im Modus animate bleibt die Umgebung beim Figurenbild; im Referenzlauf wurde das Steuervideo in einer Küche gedreht, das Ergebnis blieb aber vor dem grauen Studiohintergrund des Figurenbilds, übernommen wurden nur Bewegung und Kamera. Eine längere Vorlage wird nicht gestaucht, kürzen Sie sie also vor dem Hochladen.
API-Schnellstart
# 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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
