Skip to main content
GET
cURL
Use este endpoint depois de criar uma tarefa de vídeo Vidu. Ele retorna o estado da tarefa e inclui video_url após a conclusão da tarefa.

Verifique estes campos

  • status informa se a tarefa está queued, in_progress, completed, failed ou error.
  • progress é uma porcentagem aproximada de conclusão.
  • video_url aparece nas respostas concluídas.
  • error aparece quando uma tarefa falha.

Fluxo de polling

1

Create the task first

Comece com Criar um vídeo Vidu e armazene o id retornado.
2

Poll by task ID

Envie o ID da tarefa para este endpoint até que status atinja completed, failed ou error.
3

Download the MP4 file

Quando status for completed, chame Recuperar conteúdo do vídeo Vidu.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication. Use your CometAPI API key.

Parâmetros de caminho

task_id
string
obrigatório

Task ID returned by POST /v1/videos.

Resposta

Current Vidu video task state.

id
string
obrigatório

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

Exemplo:

"task_example"

object
string
obrigatório

Object type. Vidu video tasks return video.

Exemplo:

"video"

model
string
obrigatório

Model ID used for the task.

Exemplo:

"viduq3-turbo"

status
enum<string>
obrigatório

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

Opções disponíveis:
queued,
in_progress,
completed,
failed,
error
Exemplo:

"queued"

progress
integer
obrigatório

Task progress as a coarse percentage.

Intervalo necessário: 0 <= x <= 100
Exemplo:

0

created_at
integer
obrigatório

Task creation time as a Unix timestamp in seconds.

Exemplo:

1779938152

task_id
string

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

Exemplo:

"task_example"

completed_at
integer

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

Exemplo:

1779938219

video_url
string

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

Exemplo:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.