img_uuid restituito e risolvi il risultato tramite polling o callback HTTPS.API di effetti video AI per flussi di lavoro creativi automatizzati
Accedi agli effetti video AI tramite l'API indipendente di GoEnhance. Elenca i modelli disponibili, invia un'immagine di riferimento autorizzata con un ID effetto, salva l'
Crea una chiave API
Funzionalità dell'API di effetti video AI
Scopri gli effetti disponibili
Chiama GET /api/v1/videoeffect/list con autenticazione bearer per recuperare gli ID effetto, le etichette e gli URL di anteprima correnti invece di codificare un catalogo obsoleto.
Genera e traccia un'attività
Invia tramite POST un reference_img pubblico e un effect_id valido a /api/v1/videoeffect/generate, quindi archivia l'img_uuid restituito per i controlli di stato.
Convalida le credenziali, l'accesso ai media, l'identità del modello e la configurazione del callback prima di creare un'attività.
Elementi essenziali della richiesta API di effetti video AI
Autenticazione Bearer
Invia la tua chiave API GoEnhance nell'intestazione <code>Authorization</code> e conservala sul server, mai nel codice lato client.
Scoperta dei modelli
Usa <code>GET /api/v1/videoeffect/list</code> per recuperare il catalogo corrente prima di mostrare le scelte di effetti nel tuo prodotto.
Immagine di riferimento
Fornisci un URL di immagine HTTPS accessibile pubblicamente in <code>reference_img</code> e utilizza solo contenuti multimediali di tua proprietà o che sei autorizzato a elaborare.
Identificatore dell'effetto
Passa l'<code>effect_id</code> esatto del modello selezionato; convalidalo rispetto alla risposta dell'elenco corrente invece di indovinare gli identificatori.
Callback opzionale
Fornisci <code>custom_callback_url</code> quando desideri che le notifiche di stato vengano inviate a un endpoint HTTPS pubblico.
ID attività asincrona
Conserva <code>data.img_uuid</code> da una risposta di invio riuscita e associalo al tuo record di richiesta interno.
Usa i dati dei template in tempo reale e la documentazione invece di un prezzo universale inventato o non aggiornato.
Prezzi dell'API per effetti video AI
I prezzi variano in base all'effetto
I prezzi dell'API di effetti video AI dipendono dal modello selezionato e dal catalogo GoEnhance corrente. Non dare per scontata una tariffa fissa per ogni effetto.
Controlla il catalogo live
Usa l'API template-list e la documentazione GoEnhance corrente come fonte di verità per l'effetto che intendi eseguire.
Budget prima dell'invio
Risolvi l'<code>effect_id</code> scelto e i relativi dettagli di fatturazione correnti prima di mettere in coda i batch di produzione, poiché i termini del catalogo possono cambiare.
Integra gli effetti video AI in tre passaggi
1
1. Scopri e convalida
Recupera l'elenco degli effetti, scegli un
effect_id esatto e convalida che la tua immagine di riferimento HTTPS sia raggiungibile e autorizzata per l'elaborazione. 2
2. Invia e mantieni
Esegui POST su
reference_img, effect_id e un URL di callback opzionale, quindi salva data.img_uuid dalla risposta. 3
3. Risolvi il risultato finale
Esegui il polling di
GET /api/v1/jobs/detail?img_uuid=... o elabora i corpi di callback in modo idempotente finché l'attività non raggiunge lo stato di successo o fallimento.Crea flussi di lavoro di effetti ripetibili attorno a contenuti di tua proprietà o che hai il permesso di trasformare.
Casi d'uso dell'API per effetti video AI
Strumenti per creatori
Consenti agli utenti di selezionare effetti approvati e trasformare immagini fisse autorizzate in brevi risorse dinamiche dalla tua applicazione.
Varianti di campagna
Metti in coda varianti di effetti per concetti di marketing mantenendo la proprietà della fonte, la moderazione e l'approvazione nel tuo flusso di lavoro.
Pipeline UGC
Collega caricamenti, selezione degli effetti, elaborazione asincrona e consegna dei risultati in una pipeline di backend tracciabile.
Esperienze di intrattenimento
Crea funzionalità di animazione a tema e novità opt-in con chiari controlli sul consenso e sulle politiche dei contenuti.
Operazioni creative in batch
Mantieni gli ID attività ed elabora i risultati finali in modo indipendente, in modo che i batch possano recuperare dai timeout senza invii duplicati.
Automazione multimediale
Instrada i video completati verso sistemi di archiviazione, revisione, moderazione e pubblicazione solo dopo aver convalidato la risposta finale.
Risposte su endpoint, prezzi, input, consegna asincrona e misure di sicurezza per la produzione.