Skip to main content

Descripción general

Usa este endpoint para un sondeo async unificado entre tipos de tareas como generación de video, imagen, música y 3D. Si una respuesta de creación incluye poll_url, llama a esa ruta exacta. Para flujos de trabajo async más recientes, poll_url puede apuntar a /v1/tasks/{id}.

Parámetros de ruta

string
requerido
El ID de la tarea devuelto por la solicitud de creación.

Respuesta

string
Identificador de la tarea.
string
Alias del identificador de tarea asíncrona.
string
URL de sondeo preferida cuando la respuesta de creación la proporciona.
string
Estado de la tarea, como pending, processing, completed o failed. Las tareas canceladas se representan como failed con cancelled: true.
boolean
true cuando una tarea asíncrona en cola se canceló antes de la ejecución.
string
Marcador de cancelación. Presente como cancelled cuando la cancelación se realiza correctamente.
array
Para tareas de imagen completadas, los resultados generados se devuelven aquí. Las tareas de imagen devuelven URL en data[].url.
number
Valor de progreso opcional. Solo se devuelve cuando hay un progreso real disponible; usa status para determinar la finalización.
string
URL del recurso resultante cuando la tarea se completa y produce un video.
string
Mensaje de error cuando la tarea falla.

Comportamiento de error

Si la tarea ya no existe, ha expirado o ya no está disponible en el registro público de tareas, TokenLab devuelve:

Ejemplos

Python
JavaScript