Parámetros de ruta
string
requerido
El ID de la tarea devuelto por la solicitud de creación de video. Trate
id y task_id como la misma identidad asíncrona.Si una respuesta de creación devuelve
poll_url, llame exactamente a esa URL. Cuando apunta a /v1/tasks/{id}, trátela como el endpoint canónico y fijo de estado.Si la tarea ya no existe o ya no está disponible en el registro público de tareas, TokenLab devuelve async_task_not_found con el mensaje Task not found or no longer available.Respuesta
string
Identificador canónico de la tarea asíncrona.
string
Alias del identificador de la tarea asíncrona.
string
URL preferida para sondeo cuando la respuesta de creación la proporciona.
string
ID de transacción de facturación de TokenLab cuando la liquidación ya terminó. Es el identificador de dashboard/contabilidad y es distinto del
id / task_id asíncrono.string
Estado de la tarea:
pending, processing, completed, failed.number
Valor de progreso opcional. Solo se devuelve cuando hay un progreso real disponible; usa
status para determinar la finalización.string
URL del video generado (cuando está completado).
object
Objeto de video único con
url, duration, width y height cuando estén disponibles.array
Múltiples cargas útiles de video cuando la tarea de generación devuelve más de una salida.
string
Mensaje de error (si falla).
integer
Marca de tiempo de creación.
integer
Marca de tiempo de la última actualización.
string
Modelo usado para la tarea.
Mejores prácticas de sondeo
- Consultar cada 5-10 segundos
- Implementar retroceso exponencial para tareas largas
- Establecer un tiempo máximo de espera (p. ej., 10 minutos)
- Manejar el estado
failedde forma adecuada