GoEnhance APIGoEnhance API

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.

Bildeingabe prüfen
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.

Videoeingabe prüfen
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 <code>model</code> auf <code>ai_dance_replace</code>; es ist ein Pflichtfeld der Anfrage.

Erforderliches Personenbild

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

Erforderliches Tanzvideo

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

Zwei Auflösungsoptionen

Wählen Sie <code>480p</code> oder <code>720p</code>. Die dokumentierte Standardeinstellung ist <code>480p</code>.

Optionale Callback-Zustellung

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

Asynchrone Aufgabenantwort

Eine erfolgreiche Übermittlung gibt <code>img_uuid</code> 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. API-Schlüssel erstellen
1

1. API-Schlüssel erstellen

Erstellen Sie einen GoEnhance-API-Schlüssel und senden Sie ihn als Bearer-Token im Authorization-Header.
2. Validieren Sie beide Medien-URLs.
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. Erstellen Sie die Anfrage
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. Übermitteln Sie die Aufgabe
4

4. Übermitteln Sie die Aufgabe

Senden Sie den JSON-Body per POST an https://api.goenhance.ai/api/v1/videos/generations.
5. Speichern und nachverfolgen
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. Behandeln Sie Endzustände
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

Entwickeln Sie mit der AI Dance Replace API

API-Schlüssel erstellen
AI Dance Replace API-Preise & Integration | GoEnhance