Arquivos e lotes

Upload File

Faça upload de um arquivo em lote, referência de imagem ou arquivo no formato Anthropic.

POST
/v1/files

Finalidades do Arquivo

  • Arquivos em 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.
  • Arquivos Anthropic: adicione o cabeçalho anthropic-beta: files-api-2025-04-14.

Limites

FinalidadeTamanho máximo
batch200 MiB
user_data, vision50 MiB
Arquivos Anthropic500 MB

Um arquivo maior retornará 413 request_too_large. Um purpose diferente de batch, user_data ou vision retornará 400 unsupported_purpose. Uma solicitação sem file retornará 400.

Um arquivo batch expira 24 horas após o upload. Para alterar isso, envie os campos de formulário expires_after[anchor]=created_at e expires_after[seconds] de 3600 a 2592000 (30 dias). O campo expires_at da resposta mostra o horário.

Exemplo

Requisição

cURL
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"

Entradas de Arquivo de Imagem

Esta mesma rota /v1/files pode fazer upload de arquivos de referência de imagem 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 de API de Arquivos Anthropic

  • Adicione anthropic-beta: files-api-2025-04-14 para usar Arquivos Anthropic.
  • No modo Anthropic, faça o upload do arquivo original diretamente e não envie purpose=batch.
  • O file_id retornado está disponível apenas no Workspace atual e pode ser reutilizado em solicitações /v1/messages.
  • Se você planeja referenciar o arquivo enviado a partir do conteúdo da mensagem Anthropic, continue usando os cabeçalhos nativos da Anthropic (x-api-key, anthropic-version e o cabeçalho beta quando necessário).

Exemplo de resposta

Resposta

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

Campos importantes

idstring
ID do arquivo.
purposestring
Finalidade atribuída ao arquivo. Os uploads aceitam batch, user_data ou vision.
bytesinteger
Tamanho do arquivo em bytes.

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

anthropic-beta?string

Inclua files-api-2025-04-14 para usar o modo Anthropic Files API.

Corpo da requisição

multipart/form-data

Resposta

application/json

application/json

application/json

application/json