Bild-Gesichtstausch-API für Produktions-Workflows
Fügen Sie zustimmungsbasierten Gesichtsaustausch zu Bild-Pipelines über die GoEnhance API hinzu. Übermitteln Sie ein Zielbild und ein Quellgesicht, speichern Sie die zurückgegebene Aufgaben-ID und fragen Sie dann den Status ab oder empfangen Sie Callbacks, bis das Ergebnis einen Endzustand erreicht.
API-Zugang erhalten
Ein fokussierter Bild-Gesichtstausch-API-Vertrag
Übermitteln Sie die zwei erforderlichen Bilder
Senden Sie reference_img als Zielbild und source_img als Gesichtsbild. Beide sind erforderliche HTTPS-Bild-URLs, und die aktuelle API-Referenz dokumentiert ein Maximum von 5 MB für jede Eingabe.
Abschluss ohne Blockierung verfolgen
Eine erfolgreiche Übermittlung gibt eine img_uuid zurück. Fragen Sie GET /api/v1/jobs/detail ab oder stellen Sie eine öffentliche HTTPS-Callback-URL bereit und behandeln Sie ausstehende, verarbeitende, erfolgreiche und fehlgeschlagene Ergebnisse explizit.
Bauen Sie auf dem dokumentierten Anfrage-, Aufgaben- und Ergebnisvertrag auf.
Funktionen, die in der Produktion wichtig sind
Bearer-authentifizierte Anfragen
Bewahren Sie den GoEnhance API-Schlüssel auf Ihrem Server auf und senden Sie ihn im Authorization-Header. Geben Sie niemals Produktionsanmeldedaten im Browser-Code preis.
Explizite Ziel- und Quellrollen
Verwenden Sie <code>reference_img</code> für die Zielkomposition und <code>source_img</code> für das zu übertragende Gesicht, um häufige Fehler bei der Eingabereihenfolge zu vermeiden.
HTTPS-Asset-Validierung
Validieren Sie, dass beide Bild-URLs für die API erreichbar sind und innerhalb des dokumentierten 5-MB-Limits bleiben, bevor Sie eine Aufgabe erstellen.
Asynchrone Aufgaben-IDs
Speichern Sie die zurückgegebene <code>img_uuid</code> dauerhaft, damit Worker, Wiederholungsversuche, Callbacks und kundenorientierte Statusprüfungen alle auf denselben Auftrag verweisen.
Polling oder Callbacks
Fragen Sie den Auftragsdetail-Endpunkt mit Backoff ab oder akzeptieren Sie Statusänderungs-Callbacks an einem öffentlich erreichbaren HTTPS-Endpunkt.
Typisierte Ergebnisbehandlung
Überprüfen Sie jeden Ergebniseintrag nach <code>type</code>, anstatt anzunehmen, dass das erste Element immer eine Bild-URL ist, und kopieren Sie ablaufende Ausgaben in Ihren eigenen genehmigten Speicher.
Verwenden Sie die aktuellen Kontopreise und Guthabendaten als Quelle der Wahrheit.
Preisgestaltung für die API zum Bild-Gesichtstausch ohne Rätselraten
Aktuelle Preise der Bild-Gesichtstausch-API prüfen
Die aktuelle öffentliche Endpunkt-Referenz veröffentlicht keine feste Token-Rate pro Bild. Bestätigen Sie die Live-Gebühr auf der GoEnhance-Abrechnungsseite, bevor Sie Ausgaben prognostizieren, anstatt sich auf eine erfundene oder veraltete Zahl zu verlassen.
Token-Guthaben überwachen
Verwenden Sie <code>GET /api/v1/user/tokens</code>, um das verfügbare Guthaben aus <code>data.count</code> auszulesen und interne Warnmeldungen auszulösen, bevor Aufträge übermittelt werden.
Budgets auf Anwendungsebene festlegen
Protokollieren Sie die Aufgabenerstellung und die Endergebnisse, begrenzen Sie die Nutzung pro Mandant und gleichen Sie die abgerechneten Aktivitäten mit Ihrer GoEnhance-Kontopreisgestaltung ab.
Integrieren Sie die GoEnhance-API in drei Schritten
1
1. Zustimmung und Eingaben validieren
Bestätigen Sie, dass Sie die Erlaubnis zur Verwendung beider Gesichter haben, überprüfen Sie den HTTPS-Zugriff, setzen Sie das dokumentierte Dateigrößenlimit durch und lehnen Sie nicht unterstützte oder mehrdeutige Assets vor der Übermittlung ab.
2
2. Aufgabe erstellen und speichern
Senden Sie die beiden Bild-URLs per POST an
/api/v1/imagefaceswap/generate, überprüfen Sie sowohl den HTTP- als auch den Antwort-Erfolg und speichern Sie die zurückgegebene img_uuid. 3
3. Ergebnis auflösen und speichern
Fragen Sie mit Backoff ab oder verifizieren Sie Callback-Zustellungen, verzweigen Sie je nach Endstatus und Ergebnistyp und verschieben Sie erfolgreiche Ausgaben in einen dauerhaften Speicher, bevor temporäre Links ablaufen.
Behandeln Sie Zustimmung, Offenlegung und Zugriffskontrolle als Produktanforderungen – nicht als optionale Texte.
Nützliche, auf Berechtigungen basierende Anwendungsfälle
Personalisierung von Kampagnen mit Zustimmung
Generieren Sie genehmigte kreative Variationen für Talente, Botschafter oder Kunden, die der Bildnutzung ausdrücklich zugestimmt haben.
Film und Previsualisierung
Erstellen Sie interne Konzept-Frames oder Casting-Vorschauen, während die endgültige Überprüfung und Rechteklärung im Produktionsprozess verbleiben.
Lokalisierte kreative Workflows
Passen Sie genehmigte visuelle Assets für regionale Kampagnen an, während Sie nachvollziehbare Quellberechtigungen und menschliche Überprüfung beibehalten.
Avatar- und Profilerlebnisse
Ermöglichen Sie Opt-in-Avatar-Experimente, bei denen Benutzer wissentlich sowohl das Zielbild als auch das Quellgesicht bereitstellen.
Kreatives Prototyping
Testen Sie Layouts und visuelle Richtungen vor der Beauftragung der endgültigen Fotografie, ohne synthetische Ausgaben als authentisches Ereignis darzustellen.
Moderierte Medientools
Fügen Sie den Gesichtstausch zu kontrollierten Anwendungen mit Zustimmungsprüfungen, Missbrauchsmeldungen, Aufbewahrungsregeln und Überprüfungsschranken für die Generierung hinzu.
Praktische Antworten zu Integration, Preisgestaltung, Aufgabenabwicklung und verantwortungsvoller Nutzung.