Scegli un’API video
Crea un video Seedance
Crea attività video Seedance.
Crea un video HappyHorse
Crea processi text-to-video HappyHorse.
Crea un video MiniMax H3
Crea attività video MiniMax H3 text-to-video o con immagini di riferimento.
Crea un video Flux 3
Crea attività Flux 3 text-to-video o image-to-video.
Crea un video Sora 2
Crea processi video Sora 2.
Recupera un video Sora 2
Interroga i processi video Sora.
Crea un video Veo 3
Crea processi video Veo.
Crea un video Wan
Crea processi Wan text-to-video o image-to-video.
Crea un video xAI
Genera processi video xAI.
Crea un video Vidu
Crea processi Vidu text-to-video o image-to-video.
Crea un video Omni (Beta)
Crea processi video Omni beta.
Crea un'attività Kling text-to-video
Genera video Kling da prompt testuali.
Usa i modelli Runway
Scegli un modello Runway per attività relative a immagini, video o audio.
Crea ed esegui il polling di un’attività video
Usa un ID modello compatibile con i video dalla pagina Models o dalla directory dei modelli. Gli esempi seguenti creano un’attività video conPOST /v1/videos, quindi interrogano l’ID dell’attività restituito finché l’attività non raggiunge uno stato finale.
Questi esempi usano il segnaposto
your-video-model-id. Sostituiscilo con un ID modello video disponibile dalla pagina Models o dalla directory dei modelli prima di eseguire la richiesta.Esempi di risposta
Una risposta di creazione riuscita può essere simile alla seguente. Salva l’ID dell’attività prima di eseguire il polling:video_url; alcuni formati dei provider usano campi risultato specifici del modello o la route del contenuto video quando tale route è documentata:
Esempi di record dei modelli
Questa risposta di esempio del catalogo dei modelli mostra l’involucro
/api/models e la struttura di un record di modello video. Non è un elenco completo di modelli.cURL
Errori comuni
ID attività mancante
ID attività mancante
Memorizza l’ID della risposta di creazione prima di restituire il controllo dal gestore del job.
Polling troppo frequente
Polling troppo frequente
Aggiungi un ritardo e un backoff tra i controlli dello stato.
Durata o dimensione non supportata
Durata o dimensione non supportata
Usa i campi duration e resolution documentati per l’endpoint video selezionato.
video_url mancante
video_url mancante
Considera
video_url come facoltativo e, quando disponibile, usa come alternativa i campi dei risultati specifici del modello o la route dei contenuti.Callback non ricevuto
Callback non ricevuto
Usa il polling come fonte di riferimento e verifica che l’URL del callback accetti richieste POST.
Codici di errore e strategia di ripetizione
400
400
Non riprovare finché i campi prompt, file, durata o dimensione non sono stati corretti.
401
401
Non riprovare finché la chiave API non è presente e valida.
404
404
Controlla l’ID dell’attività, l’URL di base, il percorso e l’ID del modello prima di riprovare.
413
413
Riduci la dimensione del caricamento prima di riprovare.
429
429
Riprova con backoff esponenziale e riduci la concorrenza per la creazione o il polling.
500 o 503
500 o 503
Riprova la creazione dell’attività con backoff; continua a eseguire il polling delle attività esistenti, a meno che l’attività non raggiunga un errore terminale.
Prezzi e directory dei modelli
Pagina dei modelli
Scopri come CometAPI espone gli ID dei modelli nella documentazione.
Directory dei modelli
Esplora la disponibilità e le funzionalità dei modelli.
Prezzi
Controlla i prezzi prima di chiamare un modello.