Vídeo e materiais

Cancelar Tarefa (Compatível com Volc)

Cancela uma tarefa de compatibilidade Seedance que esteja na fila ou que possa ser cancelada.

DELETE
/api/v3/contents/generations/tasks/{id}

Visão Geral

O cancelamento só é bem-sucedido enquanto a tarefa ainda estiver queued. Um DELETE bem-sucedido retorna HTTP 200 com um corpo vazio. Consulte a tarefa posteriormente para confirmar o estado final.

Veja também Modelos de Vídeo Seedance 2.0 e Geração de Vídeo.

Semântica de Cancelamento

  • A solicitação só pode ser bem-sucedida enquanto a tarefa estiver queued.
  • Se a tarefa já estiver running, ou tiver sido concluída, falhado ou expirado, o endpoint retorna 409 com o código task_not_cancellable; consulte a tarefa para confirmar seu estado atual.
  • Uma tarefa cancelada tem o status cancelled e não retorna um resultado de vídeo.
  • Um ID de tarefa que não existe retorna 404.

Exemplo

curl -X DELETE https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl -X DELETE "https://example.com/api/v3/contents/generations/tasks/string"
Vazio

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Parâmetros de caminho

id*string

ID da tarefa de compatibilidade retornado pelo endpoint de criação. Os IDs começam com cgt-.

Resposta

application/json

application/json

application/json

application/json

application/json

application/json