Arquivos e lotes
Recuperar Lote
Recupera o status atual, contagens e arquivos de resultado para um lote.
Visão Geral
Este endpoint é 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.
Notas
- Os arquivos de entrada do lote devem usar
purpose=batch. completion_windowé atualmente24h.- A ordenação da saída não é garantida; sempre combine pelo
custom_id. - Streaming não é suportado dentro dos itens do lote.
Requisição
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-H "Authorization: Bearer sk-your-api-key"Solicitação / Resposta
Use o painel interativo do OpenAPI acima para o esquema exato.
Dicas Operacionais
- Use
custom_idpara reconciliação idempotente a montante. - Espere
output_file_ideerror_file_idapenas após o trabalhador finalizar o lote.
Resposta
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}Campos importantes
request_countsobject
Contagens de solicitações totais, concluídas, com falha e canceladas.
output_file_idstring|null
Identificador de arquivo usado por APIs relacionadas.
error_file_idstring|null
Identificador de arquivo usado por APIs relacionadas.
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
batch_id*string
Resposta
application/json
application/json