Skip to main content
GET
cURL
Usa este endpoint después de crear una tarea de video de Vidu. Devuelve el estado de la tarea e incluye video_url después de que la tarea se completa.

Revisa estos campos

  • status te indica si la tarea está queued, in_progress, completed, failed o error.
  • progress es un porcentaje aproximado de finalización.
  • video_url aparece en las respuestas completadas.
  • error aparece cuando una tarea falla.

Flujo de sondeo

1

Primero crea la tarea

Comienza con Create a Vidu video y guarda el id devuelto.
2

Sondea por ID de tarea

Envía el ID de tarea a este endpoint hasta que status llegue a completed, failed o error.
3

Descarga el archivo MP4

Cuando status sea completed, llama a Retrieve Vidu video content.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication. Use your CometAPI API key.

Parámetros de ruta

task_id
string
requerido

Task ID returned by POST /v1/videos.

Respuesta

Current Vidu video task state.

id
string
requerido

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

Ejemplo:

"task_example"

object
string
requerido

Object type. Vidu video tasks return video.

Ejemplo:

"video"

model
string
requerido

Model ID used for the task.

Ejemplo:

"viduq3-turbo"

status
enum<string>
requerido

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

Opciones disponibles:
queued,
in_progress,
completed,
failed,
error
Ejemplo:

"queued"

progress
integer
requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100
Ejemplo:

0

created_at
integer
requerido

Task creation time as a Unix timestamp in seconds.

Ejemplo:

1779938152

task_id
string

Compatibility alias for id. The value matches id when present.

Ejemplo:

"task_example"

completed_at
integer

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

Ejemplo:

1779938219

video_url
string

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

Ejemplo:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.