API di Scambio Volto su Immagine per flussi di lavoro di produzione
Aggiungi la sostituzione del volto basata sul consenso alle pipeline di immagini tramite l'API GoEnhance. Invia un'immagine di destinazione e un volto sorgente, memorizza l'ID attività restituito, quindi esegui il polling o ricevi callback finché il risultato non raggiunge uno stato terminale.
Ottieni accesso all'API
Un contratto API per lo scambio volto su immagine focalizzato
Invia le due immagini richieste
Invia reference_img come immagine di destinazione e source_img come immagine del volto. Entrambi sono URL immagine HTTPS richiesti e il riferimento API corrente documenta un massimo di 5 MB per ciascun input.
Traccia il completamento senza blocchi
Un invio riuscito restituisce un img_uuid. Interroga GET /api/v1/jobs/detail o fornisci un URL di callback HTTPS pubblico e gestisci esplicitamente gli esiti in sospeso, in elaborazione, riusciti e falliti.
Costruisci attorno al contratto documentato di richiesta, attività e risultato.
Funzionalità che contano in produzione
Richieste autenticate tramite Bearer
Mantieni la chiave API GoEnhance sul tuo server e inviala nell'intestazione Authorization. Non esporre mai le credenziali di produzione nel codice del browser.
Ruoli espliciti di destinazione e sorgente
Usa <code>reference_img</code> per la composizione di destinazione e <code>source_img</code> per il volto da trasferire, evitando comuni errori di ordine di input.
Validazione asset HTTPS
Valida che entrambi gli URL immagine siano raggiungibili dall'API e rimangano entro il limite documentato di 5 MB prima di creare un'attività.
ID attività asincroni
Conserva l'<code>img_uuid</code> restituito in modo che i worker, i tentativi, i callback e i controlli di stato rivolti al cliente facciano tutti riferimento allo stesso lavoro.
Polling o callback
Esegui il polling dell'endpoint dei dettagli del lavoro con backoff, o accetta callback di cambio stato su un endpoint HTTPS pubblicamente raggiungibile.
Gestione dei risultati tipizzati
Ispeziona ogni voce di risultato per <code>type</code> invece di presumere che il primo elemento sia sempre un URL immagine, e copia gli output in scadenza nel tuo archivio approvato.
Usa i prezzi dell'account corrente e i dati sul saldo come fonte di verità.
Prezzi dell'API di face swap senza congetture
Controlla i prezzi dell'API di scambio volto su immagine in tempo reale
Il riferimento all'endpoint pubblico corrente non pubblica una tariffa fissa per token per immagine. Conferma l'addebito in tempo reale sulla pagina di fatturazione di GoEnhance prima di prevedere la spesa, invece di fare affidamento su un numero inventato o non aggiornato.
Monitora il saldo dei token
Usa <code>GET /api/v1/user/tokens</code> per leggere il saldo disponibile da <code>data.count</code> e attivare avvisi interni prima dell'invio dei job.
Imposta budget a livello di applicazione
Registra la creazione delle attività e gli esiti finali, limita l'utilizzo per tenant e riconcilia l'attività fatturata rispetto ai prezzi del tuo account GoEnhance.
Integra l'API GoEnhance in tre passaggi
1
1. Convalida il consenso e gli input
Conferma di avere il permesso di utilizzare entrambi i volti, verifica l'accesso HTTPS, applica il limite di dimensione del file documentato e rifiuta le risorse non supportate o ambigue prima dell'invio.
2
2. Crea e conserva l'attività
Invia tramite POST i due URL delle immagini a
/api/v1/imagefaceswap/generate, verifica sia il successo HTTP che quello a livello di risposta e archivia l'img_uuid restituito. 3
3. Risolvi e archivia il risultato
Esegui il polling con backoff o verifica le consegne dei callback, dirama in base allo stato finale e al tipo di risultato, quindi sposta l'output riuscito in uno storage durevole prima che i link temporanei scadano.
Tratta il consenso, la divulgazione e il controllo degli accessi come requisiti di prodotto, non come testo opzionale.
Casi d'uso utili basati sui permessi
Personalizzazione della campagna con consenso
Genera varianti creative approvate per talenti, ambasciatori o clienti che hanno esplicitamente autorizzato l'uso dell'immagine.
Film e previsualizzazione
Crea frame concettuali interni o anteprime di casting mantenendo la revisione finale e l'autorizzazione dei diritti nel processo di produzione.
Flussi di lavoro creativi localizzati
Adatta le risorse visive approvate per campagne regionali mantenendo i permessi di origine tracciabili e la revisione umana.
Esperienze con avatar e profilo
Alimenta esperimenti con avatar opt-in in cui gli utenti forniscono consapevolmente sia l'immagine target che il volto sorgente.
Prototipazione creativa
Testa layout e direzioni visive prima di commissionare la fotografia finale, senza presentare l'output sintetico come un evento autentico.
Strumenti multimediali moderati
Aggiungi il face swap ad applicazioni controllate con controlli del consenso, segnalazione di abusi, regole di conservazione e gate di revisione attorno alla generazione.
Risposte pratiche per l'integrazione, i prezzi, la gestione delle attività e l'uso responsabile.