Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Visão geral

Use DELETE /v1/tasks/{id} para cancelar uma tarefa assíncrona que ainda não começou a executar. Use o mesmo ID de tarefa da resposta create ou o ID incluído em poll_url.

​
Tarefas suportadas

O cancelamento atualmente é suportado para tarefas de vídeo Volcengine Seedance em fila com seedance-1.5-pro, seedance-2.0 ou seedance-2.0-fast. Tarefas que já estão em processing/running não podem ser canceladas. Tarefas concluídas, com falha, expiradas ou não suportadas permanecem consultáveis para status e conciliação de cobrança, em vez de excluir registros upstream.

​
Parâmetros de caminho

​
id
string
obrigatório
ID da tarefa assíncrona retornado pela solicitação create ou incluído em poll_url.

​
Resposta

​
id
string
Identificador canônico da tarefa assíncrona.
​
task_id
string
Alias do identificador da tarefa assíncrona.
​
poll_url
string
URL de polling preferida para a tarefa. Ela permanece válida após o cancelamento.
​
status
string
Status da tarefa. Uma tarefa cancelada com sucesso é retornada como failed com cancelled: true para compatibilidade com os valores de status existentes.
​
cancelled
boolean
true quando a tarefa foi cancelada antes da execução.
​
cancellation_status
string
Marcador de cancelamento. O valor é cancelled quando o cancelamento é bem-sucedido.
​
error
string
Motivo do cancelamento ou mensagem de falha da tarefa.

​
Comportamento de erro

400 unsupported_task_cancel significa que o tipo de tarefa, provedor ou modelo não suporta cancelamento. 409 task_not_cancellable significa que a tarefa já está sendo processada, está terminal ou não pode mais ser cancelada. 403 significa que a API key não pode acessar a tarefa.

​
Exemplo

curl -X DELETE "https://api.lemondata.cc/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"
}