img_uuid und verarbeiten Sie das asynchrone Ergebnis per Polling oder HTTPS-Callback.AI Dance Move API
Nutzen Sie die AI Dance Move API über GoEnhance, um die Person in einem Quellbild mit der Bewegung eines Referenztanzvideos zu animieren. Senden Sie beide öffentlichen URLs, wählen Sie 480p oder 720p, speichern Sie die zurückgegebene
API-Key erstellen
Ein Porträt mit Referenztanzbewegung animieren
Ein Quellbild definiert die tanzende Person.
Senden Sie eine erforderliche öffentliche image_url. Die Person auf diesem Bild wird zum Motiv des generierten Tanzvideos. Verwenden Sie daher eine klare, unverdeckte Ganzkörperquelle, wenn die Lesbarkeit der Bewegung wichtig ist.
Ein Referenzvideo liefert die Bewegung.
Senden Sie eine erforderliche öffentliche video_url, die die zu übernehmende Tanzbewegung enthält. Die dokumentierte maximale Eingabevideolänge beträgt 30 Sekunden; längere Referenzen werden abgelehnt.
Validieren Sie vor der Übermittlung Quell-URLs, Dauer, Auflösung und die Abschlussbehandlung.
Funktionen und Limits der AI Dance Move API
Exakte Modellkennung
Setzen Sie <code>model</code> für diese Route auf <code>ai_dance_move</code>.
Zwei erforderliche Medien-URLs
Geben Sie sowohl <code>image_url</code> für die Person als auch <code>video_url</code> für das Referenztanzvideo an.
30-Sekunden-Eingabelimit
Referenztanzvideos dürfen nicht länger als 30 Sekunden sein; längere Eingaben werden abgelehnt.
480p- oder 720p-Ausgabe
Wählen Sie <code>480p</code> oder <code>720p</code>. Der dokumentierte Standardwert ist <code>480p</code>.
Asynchrone Aufgaben-ID
Eine erfolgreiche Übermittlung gibt <code>data.img_uuid</code> zurück, nicht das fertige Video.
Polling oder Callbacks
Fragen Sie den Auftragsdetail-Endpunkt ab oder stellen Sie eine öffentliche HTTPS-Callback-URL für Statusänderungen bereit.
GoEnhance berechnet jede aufgerundete Sekunde des eingehenden Referenzvideos zur gewählten Ausgabeauflösung.
Preise der AI Dance Move API
480p: 2 Token pro Sekunde
Eine Eingabe von fünf Sekunden entspricht 10 Token und wird in der aktuellen GoEnhance-Dokumentation mit $0.20 ausgewiesen.
720p: 4 Token pro Sekunde
Eine Eingabe von fünf Sekunden entspricht 20 Token und wird in der aktuellen GoEnhance-Dokumentation mit $0.40 ausgewiesen.
Schätzung anhand der Eingabedauer
Runden Sie die Dauer des Eingabevideos auf eine ganze Sekunde auf und multiplizieren Sie dann mit 2 Token für 480p oder 4 Token für 720p. Prüfen Sie vor Produktions-Batches die Live-Preisreferenz.
AI Dance Move API in sechs Schritten integrieren
1
1. API-Key erstellen und schützen
Erstellen Sie einen GoEnhance-Schlüssel und senden Sie die Autorisierung aus vertrauenswürdigem serverseitigem Code.
2
2. Quellmedien hosten
Geben Sie öffentlich erreichbare URLs für ein Personenbild und ein Referenztanzvideo von nicht mehr als 30 Sekunden an.
3
3. Anfrage erstellen
Senden Sie einen POST an
https://api.goenhance.ai/api/v1/videos/generations mit model: ai_dance_move, beiden URLs und 480p- oder 720p-Auflösung. 4
4. Aufgabenkennung speichern
Bestätigen Sie den Erfolg auf Antwortebene und speichern Sie die zurückgegebene
data.img_uuid, bevor Sie den Request-Handler verlassen. 5
5. Jeden Status verfolgen
Fragen Sie
GET /api/v1/jobs/detail wiederholt ab oder empfangen Sie processing-, success- und failed-Ereignisse über eine öffentliche HTTPS-Callback-URL. 6
6. Endergebnis verarbeiten
Verarbeiten Sie Erfolgs- und Fehlerfälle idempotent, prüfen Sie die zurückgegebenen Medien und vermeiden Sie doppelte nachgelagerte Arbeit, wenn Polling und Callbacks sich überschneiden.
Erstellen Sie kontrollierte Workflows zur Bewegungsübertragung auf Basis von Quellmedien, die Sie verwenden dürfen.
Anwendungsfälle der AI Dance Move API
Tanzclips für Creator
Verwandeln Sie ein freigegebenes Ganzkörperporträt in ein kurzes Tanzkonzept, das von einer ausgewählten Referenzroutine gesteuert wird.
Bewegungsstudien für Figuren
Testen Sie, wie eine Originalfigur oder ein Performer in Bewegung wirkt, bevor Sie eine größere Produktion angehen.
Kampagnenkonzept-Varianten
Parametrisieren Sie Quellbilder und freigegebene Choreografie-Referenzen für kreative Review-Warteschlangen.
Previsualisierung für Musikvideos
Erkunden Sie Tanzrichtung und Bildausschnitt, bevor Sie Zeit in einen fertigen Dreh oder Schnitt investieren.
Lokalisierte Social-Creatives
Lassen Sie regionale Quellmedien durch eine validierte Einreichungs- und Abschluss-Pipeline laufen.
Automatisierte Medien-Workflows
Verbinden Sie Generierung, Aufgabenstatus-Persistenz, Callback-Verarbeitung, Speicherung und menschliche Freigabe in Ihrer Anwendung.
Antworten zu Eingaben, Preisen, Dauer, Auflösung und asynchroner Zustellung.