Skip to main content
GET
cURL
Usa questo endpoint dopo aver creato un task beta di video Omni. Restituisce lo stato del task e include video_url dopo il completamento del task. Beta

Controlla questi campi

  • status ti indica se il task è queued, in_progress, completed o failed.
  • progress è una percentuale approssimativa di completamento.
  • video_url compare nelle risposte completate.
  • error compare quando un task non va a buon fine.

Flusso di polling

1

Crea prima il task

Inizia da Create an Omni video e memorizza l’id restituito.
2

Esegui il polling tramite task ID

Invia il task ID a questo endpoint finché status non raggiunge completed o failed.
3

Scarica il file MP4

Quando status è completed, chiama Retrieve Omni video content.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer authentication. Use your CometAPI API key.

Parametri del percorso

task_id
string
obbligatorio

Task ID returned by POST /v1/videos.

Risposta

Omni video task state.

id
string
obbligatorio

Task ID returned by POST /v1/videos.

Esempio:

"task_example"

object
string
obbligatorio

Object type. Omni 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 or failed.

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

"completed"

progress
integer
obbligatorio

Task progress as a coarse percentage.

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

100

created_at
integer
obbligatorio

Task creation time as a Unix timestamp in seconds.

Esempio:

1779938152

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.