Skip to main content

​
Visão geral

Este endpoint serve principalmente aos objetos de arquivo da API de Batch compatível com OpenAI da TokenLab. Quando a requisição entra no modo de compatibilidade com Anthropic Files, a mesma rota também pode retornar metadados de arquivo no estilo Anthropic para o workspace vinculado. Sem cabeçalhos Anthropic, esta rota pode retornar um objeto de arquivo de lote ou um objeto de arquivo de imagem/referência da TokenLab.

​
Notas

  • 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 de itens de lote.

​
Exemplo

​
Solicitação / Resposta

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

​
Dicas operacionais

  • Use custom_id para reconciliação downstream idempotente.
  • Espere output_file_id e error_file_id apenas depois que o worker finalizar o lote.
  • A precificação do lote pode ser diferente da precificação síncrona porque as regras de desconto isBatchRequest=true se aplicam.

​
Exemplo de resposta

​
Campos importantes

​
string
Identificador de arquivo usado por APIs relacionadas.
​
string
Nome original ou gerado do arquivo.
​
string
Finalidade do arquivo usada pelo fluxo proprietário, como batch, batch_output, user_data ou vision.