Skip to main content
Usa il polling come base per la generazione video perché ogni job asincrono restituisce un ID attività che puoi interrogare. Aggiungi i webhook solo quando l’endpoint video selezionato supporta gli URL di callback, e mantieni il polling come fonte di verità per le callback perse o consegnate in modo specifico dal provider.

Crea un’attività video

La seguente richiesta crea un’attività video minima e memorizza l’ID restituito. Aggiungi i campi di durata, risoluzione o callback solo quando la pagina del modello selezionato documenta tali campi.
La risposta include un ID attività e uno stato:

Esegui il polling dello stato

La seguente richiesta controlla lo stato dell’attività video:
La risposta cambia man mano che l’attività avanza. Le risposte completate possono includere video_url quando l’adapter del modello ha un URL del risultato; altrimenti usa i campi di risultato specifici del modello oppure la route dei contenuti /v1/videos/{id}/content quando quel modello supporta i download tramite proxy.

Ricevi un webhook

CometAPI non definisce un payload di callback universale per ogni modello video. Tratta i callback come eventi pass-through specifici del provider, memorizza il body grezzo e riconcilia lo stato finale con il polling. Il seguente handler Express accetta un callback video e memorizza l’evento:
Un payload di callback include comunemente i campi di identità dell’attività e dello stato, ma la struttura esatta dipende dal modello o provider selezionato:

Errori comuni

Ultima modifica il 23 giugno 2026