TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Trabajos asíncronos

Cancelar tarea

Cancela una tarea asíncrona en cola cuando el proveedor y el modelo lo admiten

DELETE
/v1/tasks/{id}

Resumen

Usa DELETE /v1/tasks/{id} para cancelar una tarea asíncrona que aún no ha empezado a ejecutarse. Usa el mismo ID de tarea de la respuesta create o el incluido en poll_url.

Tareas compatibles

Las tareas Seedance en cola con seedance-1.5-pro, seedance-2.0, seedance-2.0-fast o seedance-2.5 pueden cancelarse si la tarea lo admite. Las tareas en ejecución o en estado final no se pueden cancelar. El estado puede consultarse mientras se conserve el registro público.

Parámetros de ruta

idstringpathobligatorio

ID de tarea asíncrona devuelto por la solicitud create o incluido en poll_url.

Respuesta

idstring

Identificador canónico de tarea asíncrona.

task_idstring

Alias del identificador de tarea asíncrona.

poll_urlstring

URL de polling preferida para la tarea. Sigue siendo válida después de la cancelación.

statusstring

Estado de la tarea. Una tarea cancelada correctamente se devuelve como failed con cancelled: true para mantener compatibilidad con los valores de estado existentes.

cancelledboolean

true cuando la tarea se canceló antes de la ejecución.

cancellation_statusstring

Marcador de cancelación. El valor es cancelled cuando la cancelación se realiza correctamente.

errorstring

Motivo de cancelación o mensaje de fallo de la tarea.

Comportamiento de errores

400 unsupported_task_cancel significa que el tipo de tarea, proveedor o modelo no admite cancelación. 409 task_not_cancellable significa que la tarea ya se está procesando, está en estado terminal o ya no se puede cancelar. 403 significa que la API key no puede acceder a la tarea.

Ejemplo

Solicitud

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "cancelled": true,
  "cancellation_status": "cancelled",
  "error": "Task cancelled before execution"
}
{  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "status": "failed",  "cancelled": true,  "cancellation_status": "cancelled",  "error": "Task cancelled before execution"}

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

id*string

El ID de tarea asíncrona devuelto por id / task_id, o incrustado en poll_url

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Obtener estado de la tarea

Anterior

Listar modelos

Siguiente