Skip to main content
Usa la documentazione dei modelli video di CometAPI scegliendo il flusso di lavoro del provider che corrisponde al tuo tipo di attività. La maggior parte degli endpoint video crea task asincroni, quindi salva il task ID e usa il polling per recuperare i risultati. Aggiungi callback solo quando la pagina specifica del modello documenta il supporto per i callback.

Scegli un’API video

Crea un video Seedance

Crea task video Seedance.

Crea un video HappyHorse

Crea job text-to-video HappyHorse.

Crea un video Sora 2

Crea job video Sora 2.

Recupera un video Sora 2

Interroga i job video di Sora.

Crea un video Veo 3

Crea job video Veo.

Crea un video Wan

Crea job text-to-video Wan.

Crea un video xAI

Genera job video xAI.

Crea un video Vidu

Crea job text-to-video Vidu.

Crea un video Omni (Beta)

Crea job video Omni beta.

Crea un task Kling text-to-video

Genera video Kling da prompt di testo.

Crea un task Runway image-to-video

Genera video Runway da immagini.

Creare e interrogare un task video

Usa un model ID con capacità video dalla pagina Modelli o dalla directory dei modelli. Gli esempi qui sotto creano un task video con POST /v1/videos, quindi interrogano il task ID restituito finché il task non raggiunge uno stato terminale.
Questi esempi usano il segnaposto your-video-model-id. Sostituiscilo con un model ID video disponibile dalla pagina Modelli o dalla directory dei modelli prima di eseguire la richiesta.
Apri Create a Seedance video e Retrieve a Seedance video per usare i playground API e gli schemi degli endpoint.

Esempi di risposta

Una risposta di creazione riuscita può apparire così. Salva il task ID prima di eseguire il polling:
Una risposta di polling riuscita può apparire così. Le risposte completate possono includere 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 modelli mostra l’envelope di /api/models e la forma di un record di modello video. Non è un elenco completo dei modelli.
cURL

Errori comuni

Salva l’ID dalla risposta di creazione prima di restituire il controllo dal tuo job handler.
Aggiungi un ritardo e un backoff tra i controlli dello stato.
Usa i campi di durata e risoluzione documentati per l’endpoint video selezionato.
Tratta video_url come opzionale e usa come fallback i campi di risultato specifici del modello o la route dei contenuti quando disponibile.
Usa il polling come fonte di verità e verifica che il tuo URL di callback accetti richieste POST.

Codici di errore e strategia di retry

Non eseguire il retry finché i campi prompt, file, durata o dimensione non sono stati corretti.
Non eseguire il retry finché la chiave API non è presente e valida.
Controlla l’ID attività, il base URL, il path e il model ID prima di eseguire il retry.
Riduci la dimensione dell’upload prima di eseguire il retry.
Esegui il retry con backoff esponenziale e riduci la concorrenza di creazione o di polling.
Esegui il retry della creazione dell’attività con backoff; continua a fare 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 i model ID nella documentazione.

Directory dei modelli

Esplora disponibilità e capacità dei modelli.

Prezzi

Controlla i prezzi prima di chiamare un modello.
Ultima modifica il 23 giugno 2026