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
failedde forma adequada