Saltar para o conteúdo principal

​
Visão Geral

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

​
Modos de arquivo compatíveis

A TokenLab trata /v1/files como três modos explícitos:
  • Arquivos de lote: use purpose=batch para /v1/batches.
  • Arquivos de imagem/referência: use purpose=user_data ou purpose=vision para solicitações de imagem baseadas em arquivo.
  • Modo Anthropic Files API: adicione anthropic-beta: files-api-2025-04-14 para armazenamento de arquivos nativo da Anthropic.

​
Observações

  • Os 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 em lote.

​
Exemplo

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

​
Solicitação / Resposta

Use o painel interativo OpenAPI acima para o esquema exato.

​
Dicas Operacionais

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

​
Entradas de arquivos de imagem

A mesma rota /v1/files também pode enviar arquivos de imagem de referência para /v1/images/edits.
  • Use purpose=user_data ou purpose=vision.
  • Opcionalmente inclua model para selecionar o modelo de edição de imagem; o padrão é gpt-image-2.
  • O file_id retornado é vinculado à configuração de edição de imagem selecionada e pode ser reutilizado em images[].file_id.

​
Modo Anthropic Files API

Esta mesma rota /v1/files também oferece suporte ao caminho Anthropic Files API.
  • Adicione o cabeçalho anthropic-beta: files-api-2025-04-14 para alternar para o modo Anthropic.
  • No modo Anthropic, envie o arquivo original diretamente e não envie purpose=batch.
  • O file_id retornado fica vinculado ao mesmo canal/workspace oficial da Anthropic e deve ser reutilizado em solicitações /v1/messages.
  • Se você pretende referenciar esse arquivo no conteúdo de uma mensagem Anthropic, continue usando os cabeçalhos nativos da Anthropic (x-api-key, anthropic-version e, quando necessário, o beta header).

​
Exemplo de resposta

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

​
Campos importantes

​
id
string
Identificador de arquivo usado por APIs relacionadas.
​
purpose
string
Finalidade atribuída ao arquivo. Uploads aceitam batch, user_data ou vision.
​
bytes
integer
Tamanho do arquivo em bytes.