Arquivos e lotes
Upload File
Faça upload de um arquivo em lote, referência de imagem ou arquivo no formato Anthropic.
Finalidades do Arquivo
- Arquivos em lote: use
purpose=batchpara/v1/batches. - Arquivos de imagem/referência: use
purpose=user_dataoupurpose=visionpara solicitações de imagem baseadas em arquivo. - Arquivos Anthropic: adicione o cabeçalho
anthropic-beta: files-api-2025-04-14.
Limites
| Finalidade | Tamanho máximo |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Arquivos Anthropic | 500 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.
Requisição
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_dataoupurpose=vision. - Opcionalmente, inclua
modelpara selecionar o modelo de edição de imagem; o padrão égpt-image-2. - O
file_idretornado é vinculado à configuração de edição de imagem selecionada e pode ser reutilizado emimages[].file_id.
Modo de API de Arquivos Anthropic
- Adicione
anthropic-beta: files-api-2025-04-14para usar Arquivos Anthropic. - No modo Anthropic, faça o upload do arquivo original diretamente e não envie
purpose=batch. - O
file_idretornado 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-versione o cabeçalho beta quando necessário).
Resposta
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Campos importantes
batch, user_data ou vision.Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Cabeçalhos
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