API per lo scambio di volti nei video per flussi di lavoro di produzione
Aggiungi la sostituzione del volto basata su autorizzazione alle pipeline video tramite l'API di GoEnhance. Invia un video di destinazione, un'immagine del volto sorgente, le impostazioni di output e un segmento temporizzato; quindi conserva l'ID attività restituito e risolvi il risultato asincrono.
Ottieni accesso all'API
Un contratto API mirato per lo scambio di volti nei video
Prepara la richiesta video temporizzata
Invia reference_video come clip di destinazione e reference_img come immagine del volto. La documentazione di riferimento attuale indica dimensioni massime di 200 MB e 5 MB, oltre ai campi obbligatori start_time, end_time e upscaler.
Risolvi il completamento in modo asincrono
Un invio riuscito restituisce data.img_uuid. Esegui il polling di GET /api/v1/jobs/detail o fornisci una callback HTTPS pubblica, gestisci gli stati in sospeso, in elaborazione, completato e fallito, ed esamina le voci dei risultati tipizzati prima di archiviare il video finale.
Costruisci attorno al contratto documentato di richiesta, attività e risultato.
Funzionalità essenziali in produzione
Richieste autenticate tramite Bearer
Mantieni la chiave API di GoEnhance sul tuo server e inviala nell'intestazione Authorization. Non esporre mai le credenziali di produzione nel codice del browser.
Ruoli multimediali espliciti
Usa <code>reference_video</code> per la clip di destinazione e <code>reference_img</code> per il volto da trasferire, evitando comuni errori di ordine di input.
Risorse sorgente limitate
Convalida i file multimediali accessibili prima dell'invio. La documentazione dell'endpoint attuale indica un massimo di 200 MB per il video e 5 MB per l'immagine.
Segmenti di conversione temporizzati
Fornisci <code>start_time</code> e <code>end_time</code> da 0 a 120 secondi e convalida che l'intervallo selezionato sia significativo per la clip sorgente.
Controlli di output e miglioramento
Scegli <code>upscaler</code> 1 per 720p o 2 per 1080p (solo VIP) e abilita <code>enhance_face</code> solo quando il flusso di lavoro lo richiede.
Risultati asincroni tipizzati
Conserva <code>img_uuid</code>, gestisci tutti gli stati terminali, esamina le voci dei risultati per <code>type</code> e copia l'output riuscito prima della scadenza dei link temporanei.
Usa la pagina di fatturazione in tempo reale e il saldo del conto come fonte di verità.
Prezzi dell'API di scambio volto video senza congetture
Controlla i prezzi dell'API per lo scambio di volti nei video in tempo reale
La documentazione dell'endpoint indica i moltiplicatori di costo ma non una tariffa base fissa. Conferma l'addebito base attuale sulla pagina di fatturazione di GoEnhance prima di prevedere la spesa.
Tieni conto dei moltiplicatori opzionali
Il riferimento attuale indica l'output a 1080p e il miglioramento del volto come opzioni con prezzo 1,5 volte superiore. Non spiega come vengano calcolate le opzioni combinate, quindi verifica l'addebito in tempo reale invece di fare supposizioni.
Monitora crediti e budget
Usa <code>GET /api/v1/user/tokens</code> per leggere <code>data.count</code>, quindi aggiungi limiti per tenant, registri delle attività e avvisi relativi al tuo attuale tariffario dell'API GoEnhance.
Integra l'API GoEnhance in tre passaggi
1
1. Convalida permessi e file multimediali
Conferma il consenso e i diritti di utilizzo, verifica che entrambi gli URL siano raggiungibili, applica i limiti di dimensione e tempo documentati e rifiuta input non supportati o ambigui prima dell'invio.
2
2. Crea e conserva l'attività
Invia tramite POST i file multimediali richiesti, l'intervallo di tempo e l'impostazione di output a
/api/v1/videofaceswap/generate; controlla il successo a livello HTTP e di risposta, quindi archivia data.img_uuid. 3
3. Traccia, verifica e archivia l'output
Esegui il polling con backoff o verifica le consegne dei callback, ramifica in base allo stato terminale e al tipo di risultato, esamina lo scambio per verificare l'identità e la coerenza dei fotogrammi, quindi sposta l'output approvato in un archivio durevole.
Tratta il consenso, la divulgazione e il controllo degli accessi come requisiti di prodotto, non come testi opzionali.
Casi d'uso utili basati sui permessi
Varianti di campagna con consenso
Crea varianti video approvate per talenti, ambasciatori o clienti che hanno esplicitamente autorizzato l'uso della propria immagine.
Previsualizzazione film
Crea prototipi di casting o continuità di scena prima della produzione finale, mantenendo la revisione umana e l'autorizzazione dei diritti nel flusso di lavoro.
Produzione creativa localizzata
Adatta i filmati approvati per campagne regionali mantenendo permessi di origine tracciabili, divulgazione e registri di revisione.
Strumenti di intrattenimento con consenso
Alimenta esperienze in cui gli utenti forniscono consapevolmente la clip di destinazione e il ritratto sorgente, comprendendo che il risultato è sintetico.
Prototipi interni controllati
Valuta l'inquadratura e la direzione concettuale senza presentare filmati generati come eventi autentici o approvazioni reali.
Applicazioni multimediali moderate
Combina lo scambio di volti con controlli di accesso, segnalazione di abusi, limiti di conservazione, registri di provenienza e porte di approvazione.
Risposte pratiche per l'integrazione, i prezzi, la gestione delle attività e l'uso responsabile.