TokenLab añade la cancelación de tareas para trabajos de video Seedance en cola

TokenLab ahora permite cancelar tareas de generación de video de Seedance que se encuentran en cola antes de que comiencen a procesarse. Si envías un trabajo con el prompt incorrecto, la imagen de origen equivocada o una solicitud duplicada, puedes llamar a DELETE /v1/tasks/{id} para detenerlo antes de que consuma un espacio de procesamiento. Esto cierra una brecha con la que se han topado todos los que ejecutan pipelines de video asíncronos: enviar y luego arrepentirse.

Puntos clave

• La cancelación funciona en tareas en cola para modelos compatibles; una vez que una tarea pasa a procesamiento o alcanza un estado terminal, normalmente ya no se puede cancelar.
• El endpoint es DELETE /v1/tasks/{id}, que coincide con el mismo ID de tarea que obtienes al crear la tarea.
• Las tareas canceladas siguen siendo consultables a través del endpoint estándar de estado de tareas, por lo que tu lógica de polling no necesita un manejo especial.
• Esto es especialmente valioso para colas de video asíncronas de alto volumen, donde los envíos con entradas erróneas y los reintentos duplicados son comunes y costosos si se dejan ejecutando.

Por qué esto es importante para los pipelines de generación de video

La generación de video no es como una finalización de texto que simplemente puedes ignorar si no te gusta el resultado. Los trabajos de Seedance se ejecutan de forma asíncrona, requieren tiempo real para procesarse y ocupan un espacio en la cola desde el momento en que son aceptados. Si tu aplicación envía una tarea con un mal prompt, una imagen de origen corrupta o una resolución que no coincide con tu caso de uso real, tu única opción anterior era dejar que se completara y descartar el resultado.

Eso es un desperdicio de dos maneras. Primero, estás esperando en un espacio de cola que podría estar procesando un trabajo que realmente necesitas. Segundo, si tu sistema despliega múltiples trabajos de video por cada acción del usuario (común en herramientas de edición, pipelines de contenido por lotes o cualquier cosa con lógica de reintento), un error o un doble clic del usuario puede acumular silenciosamente varios trabajos en cola para la misma intención. Sin la cancelación, todos ellos se ejecutan hasta completarse, independientemente de si todavía deseas el resultado o no.

La cancelación de tareas te permite limpiar esto desde el origen. En el momento en que detectas una entrada incorrecta, un envío duplicado o una cancelación iniciada por el usuario (alguien cierra una pestaña, cancela una carga o cambia de opinión sobre una solicitud de generación), puedes cancelar la tarea en cola directamente en lugar de esperar a que termine y descartar la salida posteriormente.

Cómo funciona la cancelación de tareas de Seedance

El mecanismo es una solicitud DELETE estándar contra el recurso de tarea:

DELETE /v1/tasks/{id}

Pasas el mismo ID de tarea que se devolvió cuando creaste el trabajo de generación de video. Si la tarea todavía está en cola y el modelo admite la cancelación, TokenLab la marcará como cancelada y no procederá al procesamiento.

Algunos comportamientos a tener en cuenta:

• Las tareas en cola son cancelables. Esta es la ventana principal. Si una tarea aún no ha comenzado a procesarse, la cancelación debería tener éxito.
• Las tareas en procesamiento o en estado terminal pueden no ser cancelables. Una vez que una tarea ha pasado a procesamiento activo o ya ha alcanzado un estado terminal (completada, fallida o cancelada previamente), la llamada de cancelación puede ser rechazada. Tu integración debe tratar esto como un resultado esperado, no como una condición de error para reintentar agresivamente.
• Las tareas canceladas siguen siendo consultables. Después de la cancelación, aún puedes llamar al endpoint estándar de estado de tareas y obtener un objeto de tarea que muestra el estado cancelado. Esto es importante para el registro, la auditoría y cualquier panel que muestre el historial de trabajos a los usuarios finales: no pierdes visibilidad sobre lo que le sucedió a una tarea solo porque fue cancelada.
• No todas las combinaciones de tarea/modelo admiten la cancelación. Consulta la documentación actual para saber qué tipos de tareas de Seedance permiten esto antes de integrar la cancelación en una ruta crítica. El soporte puede variar según el modelo y el tipo de tarea dentro de la API de generación de video.

Para conocer el esquema completo de solicitud y respuesta, consulta la referencia de cancelación de tareas.

Cuándo usar realmente la cancelación

La cancelación es una herramienta para modos de falla específicos, no un control de propósito general para gestionar cada trabajo en cola. Aquí es donde se gana su lugar en tu pipeline:

Escenario	Por qué ayuda la cancelación
Prompt enviado incorrectamente	Detén el trabajo antes de que consuma un espacio de procesamiento en una salida que no usarás
Imagen/video de origen incorrecto adjunto	Igual que el anterior: detecta fallos de validación de entrada después del envío
Envío duplicado (doble clic, tormenta de reintentos)	Cancela las copias redundantes, mantén ejecutándose la primera tarea válida
El usuario abandona la solicitud a mitad del proceso	Pestaña cerrada, carga cancelada o el usuario cambió de opinión antes de que comenzara la generación
El retraso en la cola hace que un trabajo quede obsoleto	Si un trabajo ya no es relevante para la sesión del usuario que lo solicitó, cancélalo en lugar de dejar que se complete sin uso

Para lo que no es buena la cancelación: intentar detener un trabajo que ya se está procesando porque estás impaciente, o usar cancelar-y-reenviar como sustituto de la validación de entradas antes de enviarlas en primer lugar. Valida primero. La cancelación es la red de seguridad, no el control principal.

Lista de verificación de integración para colas de video asíncronas

Si estás integrando la cancelación en una implementación existente de Seedance, sigue esta lista:

• Almacena el ID de tarea devuelto en el momento de la creación en un lugar donde tu aplicación pueda consultarlo más tarde (estado de sesión, tabla de trabajos, lo que sea que use tu cola).
• Agrega una ruta de cancelación activada por tu propia lógica de detección de duplicados, no solo por la acción del usuario; esto detecta las tormentas de reintentos automáticamente.
• Maneja la respuesta de "no cancelable" con elegancia. Si una tarea ya ha pasado a procesamiento, no trates la cancelación rechazada como un error fatal; vuelve a esperar el resultado y descártalo si es necesario.
• Sigue consultando el endpoint de estado de tareas después de una llamada de cancelación para confirmar que el estado realmente cambió a cancelado, en lugar de asumir el éxito solo por la respuesta del DELETE.
• Agrega la cancelación como un paso explícito en cualquier lógica de "usuario cerró la aplicación" o cierre de sesión, para que los trabajos abandonados no se ejecuten hasta completarse para nadie.
• Registra las tareas canceladas de la misma manera que registras las completadas y fallidas; estos datos son útiles para detectar patrones en envíos duplicados o mala validación de entradas.

Si aún no has creado una lógica de polling sólida para los trabajos de Seedance, revisa la guía de trabajos asíncronos y polling junto con esta función: la cancelación y el polling son dos mitades del mismo problema de gestión del ciclo de vida de las tareas.

Preguntas frecuentes

¿Puedo cancelar una tarea de Seedance que ya se está procesando? Generalmente no. La cancelación está diseñada para tareas en cola. Una vez que una tarea ha pasado a procesamiento activo, es posible que ya no sea cancelable, y debes verificar la respuesta de la llamada de cancelación en lugar de asumir que funcionó.

¿Las tareas canceladas siguen apareciendo cuando consulto el estado de la tarea? Sí. Las tareas canceladas siguen siendo consultables a través del endpoint estándar de estado de tareas. Verás el estado cancelado reflejado allí, lo que mantiene tus registros e historial consistentes incluso para los trabajos que detuviste antes de tiempo.

¿Todos los tipos de tareas de Seedance admiten la cancelación? No necesariamente. El soporte depende de la combinación específica de tarea y modelo. Consulta la referencia de la API actual antes de confiar en la cancelación como una garantía absoluta en tu integración.

Fuentes y actualidad

Este artículo refleja la documentación de la API de TokenLab y el comportamiento observado al 2026-07-07. Para obtener los detalles más actuales de los endpoints, consulta la referencia de la API de cancelación de tareas y la guía de la API de Seedance directamente, ya que el soporte de tareas para la cancelación puede cambiar a medida que se actualizan los modelos.

---

Si estás integrando generación de video en tu producto y necesitas un control de cola confiable en Seedance, Veo 3, PixVerse V6 o Kling 3.0, TokenLab te ofrece una superficie de API con un comportamiento de ciclo de vida de tareas consistente, incluida la cancelación, en todos los modelos de video compatibles. Consulta la documentación y limpia tu integración antes de tu próxima ejecución de alto volumen.

Lecturas relacionadas y próximos pasos

La cancelación de tareas para trabajos de video en cola de Seedance brinda a los desarrolladores más control sobre el gasto de cómputo y las colas de trabajo, pero funciona mejor junto con una comprensión clara del panorama más amplio de la generación de video. Para obtener información sobre cómo encaja Seedance en los flujos de trabajo de video comunes, consulta la Guía de la API de Seedance: Cuándo usarla para la generación de video por IA. Si estás comparando varios proveedores antes de decidirte por un modelo, la Guía de la mejor API de modelos de video por IA: Cómo deben elegir los desarrolladores los modelos de generación de video cubre los criterios de selección clave, mientras que la Precios de la API de video por IA en 2026: Cómo deben comparar los costos los desarrolladores desglosa las estructuras de costos entre los servicios.

La disponibilidad y los precios de los modelos cambian con frecuencia, así que verifica los detalles actuales del modelo y los precios antes de usarlos en producción de alto volumen. ¿Listo para probar la cancelación y otros controles de cola tú mismo? Crea una clave API y comienza hoy mismo.