Skip to main content

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 failed de forma adecuada