Resumen
UsaDELETE /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
La cancelación se admite para tareas de video Seedance en cola cuando el proveedor seleccionado para esa tarea admite cancelación. Los modelos compatibles sonseedance-1.5-pro, seedance-2.0 y seedance-2.0-fast. Las tareas que ya están en processing/running no se pueden cancelar. Las tareas completadas, fallidas, expiradas o no compatibles siguen disponibles para consultar estado y conciliación de facturación.
Parámetros de ruta
string
requerido
ID de tarea asíncrona devuelto por la solicitud create o incluido en
poll_url.Respuesta
string
Identificador canónico de tarea asíncrona.
string
Alias del identificador de tarea asíncrona.
string
URL de polling preferida para la tarea. Sigue siendo válida después de la cancelación.
string
Estado de la tarea. Una tarea cancelada correctamente se devuelve como
failed con cancelled: true para mantener compatibilidad con los valores de estado existentes.boolean
true cuando la tarea se canceló antes de la ejecución.string
Marcador de cancelación. El valor es
cancelled cuando la cancelación se realiza correctamente.string
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
Response