AI Dance Replace API für bewegungsgesteuerte Videos

Greifen Sie über die GoEnhance API auf ai_dance_replace zu, um die Person in einem Referenztanzvideo durch die Person aus einem Quellbild zu ersetzen, während die Referenzbewegung beibehalten wird. Übermitteln Sie eine asynchrone Aufgabe, speichern Sie die zugehörige img_uuid und fragen Sie dann den Status ab oder nutzen Sie Callbacks für den Abschluss.
API-Schlüssel abrufen
Tänzer in einem Filmproduktionsstudio für AI-Dance-Replace-API-Workflows

Erstellen Sie Tanzvideo-Workflows zur Personenersetzung

Ersatzperson definieren

Geben Sie eine öffentliche image_url an. Die Person in diesem Bild wird zum Motiv, das im generierten Tanzvideo verwendet wird. Validieren Sie die URL daher vor der Übermittlung.
Porträtaufnahme-Setup für ein Personenbild, das von einer Tanz-Ersetzungs-API verwendet wird

Bewegung aus einem Tanzvideo ableiten

Geben Sie eine öffentliche video_url an, die den Referenztanz enthält. Das dokumentierte Limit beträgt 30 Sekunden; längere Videos werden abgelehnt.
Tänzer und Filmkamera erfassen Bewegung für einen AI-Dance-Replace-Workflow
Validieren Sie vor der Übermittlung die exakte Modellkennung, die Medien-URLs und die Ausgabeauflösung.

Funktionen und Eingaben der AI Dance Replace API

Exakte Modellkennung

Setzen Sie model auf ai_dance_replace; es ist ein Pflichtfeld der Anfrage.

Erforderliches Personenbild

Übergeben Sie image_url als gültige öffentliche URI für die Person, die in der Ausgabe erscheinen soll.

Erforderliches Tanzvideo

Übergeben Sie video_url als öffentliches Referenzvideo, das nicht länger als das dokumentierte Maximum von 30 Sekunden ist.

Zwei Auflösungsoptionen

Wählen Sie 480p oder 720p. Die dokumentierte Standardeinstellung ist 480p.

Optionale Callback-Zustellung

Fügen Sie eine öffentliche HTTPS-custom_callback_url hinzu, um Statusmeldungen zu Verarbeitung, Erfolg und Fehler zu erhalten.

Asynchrone Aufgabenantwort

Eine erfolgreiche Übermittlung gibt img_uuid zurück; speichern Sie diese Kennung für Statusabfragen und die Ergebnisverarbeitung.
Die Abrechnung verwendet die aufgerundete Dauer des Eingangsvideos. Berechnen Sie die Kosten anhand der gewählten Auflösung und der abgerechneten Sekunden.

AI Dance Replace API-Preise

480p-Preise

2 Token pro Sekunde des Eingangsvideos, also $0.04 pro Sekunde bzw. $0.20 pro 5 Sekunden bei $0.02 pro Token.

720p-Preise

4 Token pro Sekunde des Eingangsvideos, also $0.08 pro Sekunde bzw. $0.40 pro 5 Sekunden bei $0.02 pro Token.

Abrechnung nach Dauer

Die Dauer des Eingangsvideos wird für die Abrechnung aufgerundet; schätzen Sie die Kosten als abgerechnete Sekunden multipliziert mit dem gewählten Preis.

Integrieren Sie die GoEnhance-API in sechs Schritten

1

1. API-Schlüssel erstellen

Erstellen Sie einen GoEnhance-API-Schlüssel und senden Sie ihn als Bearer-Token im Authorization-Header.
2

2. Validieren Sie beide Medien-URLs.

Bestätigen Sie, dass das Personenbild und das Tanzvideo öffentlich erreichbar sind und dass das Video nicht länger als 30 Sekunden ist.
3

3. Erstellen Sie die Anfrage

Setzen Sie model: ai_dance_replace, fügen Sie image_url und video_url hinzu, und wählen Sie dann 480p oder 720p.
4

4. Übermitteln Sie die Aufgabe

Senden Sie den JSON-Body per POST an https://api.goenhance.ai/api/v1/videos/generations.
5

5. Speichern und nachverfolgen

Speichern Sie die zurückgegebene img_uuid, rufen Sie dann GET /api/v1/jobs/detail ab oder empfangen Sie Callback-Ereignisse.
6

6. Behandeln Sie Endzustände

Behandeln Sie Erfolgs- und Fehlerfälle idempotent, überprüfen Sie das zurückgegebene Asset und vermeiden Sie doppelte nachgelagerte Arbeiten.
API-Schlüssel abrufen
Verwenden Sie eine einwilligungsbewusste Medien-Pipeline für Creator-Tools, Kampagnenproduktion und wiederholbare Videoautomatisierung.

Entwickler-Anwendungsfälle für Tanz-Ersatzvideo

Tanzvorlagen für Ersteller

Ermöglichen Sie Benutzern, ein genehmigtes Personenbild auf einen lizenzierten Referenztanz innerhalb eines geführten Erstellungsablaufs anzuwenden.

Kampagnenvideo-Varianten

Generieren Sie Motivvarianten aus freigegebenen Quellmedien für die interne Prüfung und anschließende Bearbeitung.

Charakterdarstellungstests

Erkunden Sie, wie ein bereitgestelltes Charakterbild einer vorhandenen Bewegungsreferenz vor der Produktion folgt.

Lokalisierte Creator-Assets

Verwenden Sie eine genehmigte Tanzreferenz mit verschiedenen autorisierten Subjekten für regionale Content-Pipelines.

Automatische Inhaltswarteschlangen

Verbinden Sie Task-IDs und Callbacks mit der Batch-Orchestrierung, ohne den Thread Ihrer Anwendungsanfrage zu blockieren.

Bewegungserlebnisse prototypisieren

Validieren Sie ein Produktkonzept für Bild und Bewegung, bevor Sie in eine maßgeschneiderte Aufnahme-Pipeline investieren.
Antworten auf häufige Fragen zu Eingabe, Preisen, Status, Callback und Integration.

FAQ zur AI Dance Replace API

Welchen Endpoint verwendet die AI Dance Replace API?

Senden Sie POST https://api.goenhance.ai/api/v1/videos/generations mit model: ai_dance_replace, einer öffentlichen image_url und einer öffentlichen video_url.

Wie funktioniert die Preisgestaltung für die AI Dance Replace API?

Die Preisberechnung basiert auf der aufgerundeten Dauer des Eingabevideos: 2 Token pro Sekunde bei 480p und 4 Token pro Sekunde bei 720p, was $0.20 bzw. $0.40 pro 5 Sekunden entspricht.

Welche Felder sind erforderlich?

Die dokumentierten Pflichtfelder sind model, image_url und video_url. Auflösung und Callback-URL sind optional.

Wie lang kann das Referenztanzvideo sein?

Die dokumentierte Maximaldauer beträgt 30 Sekunden. Validieren Sie die Dauer vor der Übermittlung, da längere Videos abgelehnt werden.

Welche Ausgabeauflösungen sind verfügbar?

Der Endpunkt akzeptiert 480p und 720p. Falls nicht angegeben, ist der dokumentierte Standardwert 480p.

Wie überprüfe ich den Aufgabenstatus?

Speichern Sie die zurückgegebene img_uuid und rufen Sie GET /api/v1/jobs/detail ab, oder geben Sie eine öffentliche HTTPS-Callback-URL an.

Wie werden Callback-Fehler behandelt?

GoEnhance dokumentiert bis zu drei Wiederholungsversuche, wenn Ihr Callback-Endpunkt nicht HTTP 200 zurückgibt, mit einem Timeout von drei Sekunden pro Versuch.

Welche Berechtigungen sollte meine App benötigen?

Verwenden Sie nur Bilder und Tanzvideos, zu deren Verarbeitung Sie berechtigt sind, und holen Sie die entsprechende Einwilligung von identifizierbaren Personen im Quellmaterial ein.

Entwickeln Sie mit der AI Dance Replace API

AI Dance Replace API-Preise & Integration | GoEnhance