Cancelar Lote

​

Visão Geral

​

Notas

• Os arquivos de entrada do lote devem usar purpose=batch.
• completion_window é atualmente 24h.
• A ordenação da saída não é garantida; sempre combine pelo custom_id.
• Streaming não é suportado dentro dos itens de lote.

​

Exemplo

curl -X POST "https://api.tokenlab.sh/v1/batches/batch_abc123/cancel" \
  -H "Authorization: Bearer sk-your-api-key"

​

Solicitação / Resposta

​

Dicas Operacionais

• Use custom_id para reconciliação idempotente a montante.
• Espere output_file_id e error_file_id apenas após o trabalhador finalizar o lote.
• A precificação de lote pode diferir da precificação síncrona porque as regras de desconto isBatchRequest=true se aplicam.

​

Exemplo de resposta

{
  "id": "batch_abc123",
  "object": "batch",
  "status": "cancelling",
  "input_file_id": "file_abc123"
}

​

Campos importantes