Skip to main content

Parâmetros de Caminho

string
obrigatório
O ID da tarefa retornado pela solicitação de criação de vídeo. Considere id e task_id como a mesma identidade assíncrona.
Se uma resposta de criação retornar poll_url, chame exatamente essa URL. Quando ela apontar para /v1/tasks/{id}, trate isso como o endpoint canônico e fixo de status.Se a tarefa não existir mais ou não estiver mais disponível no registro público da tarefa, o TokenLab retorna async_task_not_found com a mensagem Task not found or no longer available.

Resposta

string
Identificador canônico da tarefa assíncrona.
string
Alias do identificador da tarefa assíncrona.
string
URL de polling preferencial quando a resposta de criação fornecer uma.
string
ID de transação de faturamento da TokenLab quando a liquidação já foi concluída. Este é o identificador usado no dashboard / conciliação e é separado do id / task_id assíncrono.
string
Status da tarefa: pending, processing, completed, failed.
number
Valor de progresso opcional. Retornado apenas quando houver um progresso real disponível; use status para determinar a conclusão.
string
URL do vídeo gerado (quando concluído).
object
Objeto único de vídeo com url, duration, width e height quando disponíveis.
array
Múltiplos objetos de vídeo quando a tarefa de geração retornar mais de uma saída.
string
Mensagem de erro (em caso de falha).
integer
Timestamp de criação.
integer
Timestamp da última atualização.
string
Modelo usado para a tarefa.

Melhores práticas de polling

  • Realizar polling a cada 5-10 segundos
  • Implemente backoff exponencial para tarefas longas
  • Defina um tempo máximo de espera (por exemplo, 10 minutos)
  • Trate o status failed de forma adequada