Criar Lote

Visão GeralCopy Anchor Link

Este endpoint faz parte da API de Lote compatível com OpenAI da TokenLab. Trabalhos em lote utilizam arquivos JSONL carregados, são executados de forma assíncrona e podem retornar arquivos de saída/erro posteriormente.

ObservaçõesCopy Anchor Link

• Arquivos de entrada em 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.
• Os endpoints aceitos para itens de lote são /v1/chat/completions e /v1/embeddings. /v1/responses não é aceito.

curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

Solicitação / RespostaCopy Anchor Link

Use o painel interativo do OpenAPI acima para o esquema exato.

Dicas OperacionaisCopy Anchor Link

• 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.

{
  "id": "batch_abc123",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Campos importantesCopy Anchor Link