TokenLab
Obter chave de API
DocumentaçãoReferência da APIIntegrações

Arquivos e lotes

Listar Arquivos

Liste arquivos de lote (batch) e de referência de imagem enviados.

GET
/v1/files

Liste arquivos de lote e de referência de imagem. Filtre com purpose=batch, purpose=batch_output, purpose=user_data ou purpose=vision.

Com os cabeçalhos Anthropic Files, a mesma API lista arquivos no formato Anthropic no Workspace atual.

Exemplo

Requisição

cURL
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

Filtros

  • Para arquivos de lote e de referência de imagem, limit é de 1 a 10000 (padrão 10000), com after para paginação. No modo Anthropic Files, limit é de 1 a 1000 (padrão 20); use after_id ou before_id, não ambos.
  • purpose pode ser batch, batch_output, user_data ou vision.
  • user_data e vision retornam arquivos de referência de imagem criados pelo TokenLab quando disponíveis.

Exemplo de resposta

Resposta

200 OK
{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

Campos importantes

objectstring
Sempre list.
dataarray
Arquivos.
has_moreboolean
Mais resultados estão disponíveis quando has_more é true.

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 consulta

limit?integer
Intervalo1 <= value <= 1000
padrão20
after?string
after_id?string

Cursor do Anthropic Files. Retorna arquivos após este ID de arquivo público. Requer o cabeçalho Anthropic Files beta e não pode ser combinado com before_id.

before_id?string

Cursor do Anthropic Files. Retorna arquivos antes deste ID de arquivo público. Requer o cabeçalho Anthropic Files beta e não pode ser combinado com after_id.

scope_id?string

Cursor de escopo reservado do Anthropic Files. O TokenLab atualmente retorna um erro explícito de não suporte em vez de ignorar silenciosamente este valor.

purpose?string

Filtro de propósito de arquivo opcional. batch e batch_output cobrem arquivos da Batch API; user_data e vision cobrem vinculações de arquivos de imagem/referência do TokenLab. O modo Anthropic Files API é selecionado pelos cabeçalhos da Anthropic em vez deste parâmetro de consulta.

Valores permitidos

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

Cabeçalhos

anthropic-beta?string

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

Resposta

application/json

application/json

Upload de Arquivo

Anterior

Recuperar Arquivo

Próxima