Arquivos e lotes

Recuperar Arquivo

Recupera metadados de um único arquivo enviado.

GET
/v1/files/{file_id}

Retorna o nome, tamanho, propósito e horário de criação de um arquivo. Sem os cabeçalhos da Anthropic, isso abrange arquivos de lote (batch) e de referência de imagem. Com os cabeçalhos de arquivos da Anthropic, abrange arquivos no formato da Anthropic.

Exemplo

Requisição

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Arquivos de referência de imagem

Este endpoint também pode retornar metadados para arquivos de referência de imagem criados pelo TokenLab. O campo status é opcional e pode estar ausente para famílias de arquivos que não fornecem um.

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.
filenamestring
Nome original ou gerado do arquivo.
purposestring
Propósito do arquivo, como batch, batch_output, user_data ou vision.

Autorização

BearerAuth
AuthorizationBearer <token>

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

Local: header

Parâmetros de caminho

file_id*string

Cabeçalhos

anthropic-beta?string

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

Resposta

application/json

application/json