Video Face Swap API für Produktions-Workflows
Ergänzen Sie Ihre Video-Pipelines über die GoEnhance API um genehmigungsbasierten Gesichtsaustausch. Senden Sie ein Zielvideo, ein Quell-Gesichtsbild, die Ausgabeeinstellungen und einen Zeitabschnitt; speichern Sie anschließend die zurückgegebene Task-ID und holen Sie das asynchrone Ergebnis ab.
API-Zugang erhalten
Ein klar abgegrenzter Video-Face-Swap-API-Vertrag
Zeitgesteuerte Video-Anfrage vorbereiten
Senden Sie den Zielclip als reference_video und das Gesichtsbild als reference_img. Die aktuelle Referenz nennt Maximalgrößen von 200 MB und 5 MB sowie die Pflichtfelder start_time, end_time und upscaler.
Fertigstellung asynchron abholen
Eine erfolgreiche Übermittlung liefert data.img_uuid zurück. Pollen Sie GET /api/v1/jobs/detail oder hinterlegen Sie einen öffentlichen HTTPS-Callback, behandeln Sie die Zustände pending, processing, success und failed und prüfen Sie die typisierten Ergebniseinträge, bevor Sie das fertige Video speichern.
Bauen Sie Ihre Integration auf dem dokumentierten Vertrag aus Anfrage, Task und Ergebnis auf.
Funktionen, auf die es im Produktivbetrieb ankommt
Anfragen mit Bearer-Authentifizierung
Halten Sie den GoEnhance-API-Key auf Ihrem Server und senden Sie ihn im Authorization-Header. Geben Sie Produktions-Zugangsdaten niemals in Browser-Code preis.
Eindeutige Rollen der Medien
Verwenden Sie <code>reference_video</code> für den Zielclip und <code>reference_img</code> für das zu übertragende Gesicht. Das verhindert die häufige Verwechslung der beiden Eingaben.
Begrenzte Quelldateien
Prüfen Sie vor dem Absenden, ob die Medien erreichbar sind. Die aktuelle Endpunkt-Referenz nennt maximal 200 MB für das Video und maximal 5 MB für das Bild.
Zeitlich begrenzte Konvertierungsabschnitte
Geben Sie <code>start_time</code> und <code>end_time</code> zwischen 0 und 120 Sekunden an und prüfen Sie, ob das gewählte Intervall für den Quellclip sinnvoll ist.
Steuerung von Ausgabe und Verbesserung
Wählen Sie <code>upscaler</code> 1 für 720p oder 2 für das VIP-exklusive 1080p und aktivieren Sie <code>enhance_face</code> nur dann, wenn Ihr Workflow es erfordert.
Typisierte asynchrone Ergebnisse
Speichern Sie <code>img_uuid</code>, behandeln Sie alle Endzustände, werten Sie die Ergebniseinträge nach <code>type</code> aus und kopieren Sie erfolgreiche Ausgaben, bevor die temporären Links ablaufen.
Nutzen Sie die aktuelle Abrechnungsseite und Ihr Kontoguthaben als verbindliche Quelle.
Preise der Video-Face-Swap-API ohne Rätselraten
Aktuelle Preise der Video-Face-Swap-API prüfen
Die Endpunkt-Referenz dokumentiert Kostenmultiplikatoren, aber keinen festen Grundpreis. Bestätigen Sie die aktuelle Grundgebühr auf der GoEnhance-Abrechnungsseite, bevor Sie Ausgaben planen.
Optionale Multiplikatoren einkalkulieren
Die aktuelle Referenz kennzeichnet 1080p-Ausgabe und Gesichtsverbesserung als Optionen zum 1.5x-Preis. Wie kombinierte Optionen berechnet werden, wird nicht erläutert – prüfen Sie deshalb die tatsächliche Abrechnung, statt Annahmen zu treffen.
Guthaben und Budgets überwachen
Lesen Sie mit <code>GET /api/v1/user/tokens</code> den Wert <code>data.count</code> aus und ergänzen Sie rund um Ihre aktuellen GoEnhance-API-Preise mandantenbezogene Limits, Task-Journale und Benachrichtigungen.
Die GoEnhance API in drei Schritten integrieren
1
1. Berechtigung und Medien prüfen
Bestätigen Sie Einwilligung und Nutzungsrechte, prüfen Sie die Erreichbarkeit beider URLs, setzen Sie die dokumentierten Größen- und Zeitgrenzen durch und weisen Sie nicht unterstützte oder unklare Eingaben schon vor dem Absenden zurück.
2
2. Task anlegen und speichern
Senden Sie die erforderlichen Medien, den Zeitbereich und die Ausgabeeinstellung per POST an
/api/v1/videofaceswap/generate, prüfen Sie den Erfolg auf HTTP- und auf Response-Ebene und speichern Sie dann data.img_uuid. 3
3. Ausgabe verfolgen, prüfen und sichern
Pollen Sie mit Backoff oder verifizieren Sie die Callback-Zustellung, verzweigen Sie nach Endstatus und Ergebnistyp, kontrollieren Sie den Face Swap auf Identitäts- und Frame-Konsistenz und übertragen Sie freigegebene Ergebnisse anschließend in dauerhaften Speicher.
Behandeln Sie Einwilligung, Kennzeichnung und Zugriffskontrolle als Produktanforderungen, nicht als optionalen Hinweistext.
Sinnvolle Anwendungsfälle auf Basis von Einwilligung
Kampagnenvarianten mit Einwilligung
Erstellen Sie freigegebene Videovarianten für Talente, Markenbotschafter oder Kundinnen und Kunden, die der Nutzung ihres Bildnisses ausdrücklich zugestimmt haben.
Previsualisierung für Filmprojekte
Testen Sie Besetzung oder Szenenanschluss vor der finalen Produktion und behalten Sie dabei menschliche Prüfung und Rechteklärung im Workflow.
Lokalisierte Kreativproduktion
Passen Sie freigegebenes Material für regionale Kampagnen an und bewahren Sie dabei nachvollziehbare Quellgenehmigungen, Kennzeichnungen und Prüfprotokolle auf.
Opt-in-Unterhaltungsanwendungen
Ermöglichen Sie Erlebnisse, bei denen Nutzerinnen und Nutzer Zielclip und Quellporträt bewusst selbst bereitstellen und wissen, dass das Ergebnis synthetisch ist.
Kontrollierte interne Prototypen
Bewerten Sie Bildaufbau und konzeptionelle Richtung, ohne generiertes Material als echtes Ereignis oder tatsächliche Empfehlung auszugeben.
Medienanwendungen mit Moderation
Kombinieren Sie den Gesichtsaustausch mit Zugriffskontrollen, Missbrauchsmeldungen, Aufbewahrungsfristen, Herkunftsnachweisen und Freigabestufen.
Praxisnahe Antworten zu Integration, Preisen, Task-Handling und verantwortungsvoller Nutzung.