Skip to main content
POST
cURL
Usa questo endpoint beta per creare un task di video Omni. L’API restituisce immediatamente un ID del task, quindi memorizza l’id restituito e interroga il task finché non raggiunge uno stato terminale. Beta POST /v1/videos usa multipart/form-data; passa i controlli scalari come campi del form.

Scegli una modalità di input

Usa model=omni-fast per questa pagina.

Imposta durata, rapporto e risoluzione

Omni è contrassegnato come beta perché la stabilità della generazione può variare in base all’input e al percorso selezionato. Mantieni piccola la prima richiesta, quindi controlla il video completato prima di fare affidamento su una durata renderizzata specifica o su una determinata dimensione dei frame. Poiché questo endpoint è beta, considera aspect_ratio e resolution come preferenze di generazione e verifica l’MP4 scaricato prima di fare affidamento sui pixel finali.

Flusso del task

1

Crea il task

Invia la richiesta del form multipart e memorizza l’id restituito.
2

Interroga il task

Chiama Retrieve an Omni video finché status non è completed o failed.
3

Scarica il risultato

Quando il task è completed, chiama Retrieve Omni video content per scaricare il file MP4.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data
model
enum<string>
obbligatorio

Omni model ID for this endpoint. Use omni-fast for text-to-video.

Opzioni disponibili:
omni-fast
Esempio:

"omni-fast"

prompt
string
obbligatorio

Text prompt that describes the video to generate.

Esempio:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds
string
predefinito:4

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

Esempio:

"4"

aspect_ratio
enum<string>
predefinito:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Opzioni disponibili:
16:9,
9:16,
1:1
Esempio:

"16:9"

resolution
string

Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.

Esempio:

"720p"

Risposta

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
obbligatorio

Task ID. Use this value with retrieve and content endpoints.

Esempio:

"task_example"

object
string
obbligatorio

Object type. Video tasks return video.

Esempio:

"video"

model
string
obbligatorio

Model ID used for the task.

Esempio:

"omni-fast"

status
enum<string>
obbligatorio

Task lifecycle status. Poll until the value is completed, failed, or error.

Opzioni disponibili:
queued,
in_progress,
completed,
failed,
error
Esempio:

"queued"

progress
integer
obbligatorio

Task progress as a coarse percentage.

Intervallo richiesto: 0 <= x <= 100
Esempio:

0

created_at
integer
obbligatorio

Task creation time as a Unix timestamp in seconds.

Esempio:

1779938152

task_id
string

Compatibility alias for id when present.

Esempio:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Esempio:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Esempio:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.