Skip to main content
GET
cURL
Usa questo endpoint dopo aver creato un’attività video Vidu. Restituisce lo stato dell’attività e include video_url dopo il completamento dell’attività.

Controlla questi campi

  • status indica se l’attività è queued, in_progress, completed, failed oppure error.
  • progress è una percentuale di completamento approssimativa.
  • video_url compare nelle risposte completate.
  • error compare quando un’attività non riesce.

Flusso di polling

1

Crea prima l'attività

Inizia con Create a Vidu video e salva l’id restituito.
2

Esegui il polling tramite task ID

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

Scarica il file MP4

Quando status è completed, chiama Retrieve Vidu 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

Current Vidu video task state.

id
string
obbligatorio

Task ID. Use this value as task_id in retrieve and content requests.

Esempio:

"task_example"

object
string
obbligatorio

Object type. Vidu video tasks return video.

Esempio:

"video"

model
string
obbligatorio

Model ID used for the task.

Esempio:

"viduq3-turbo"

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. The value matches 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.