Carregar Arquivo

​

Visão Geral

​

Modos de arquivo compatíveis

• 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

​

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

• 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

• 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