Listar arquivos

Visão geralCopy Anchor Link

Este endpoint serve principalmente à API de Batch compatível com OpenAI da TokenLab, incluindo entradas em lote enviadas e arquivos de saída ou erro gerados.

Quando a requisição entra no modo de compatibilidade com Anthropic Files, a mesma rota também pode listar arquivos no estilo Anthropic disponíveis para o workspace vinculado.

Sem cabeçalhos Anthropic, a lista pode incluir arquivos de lote e arquivos de imagem/referência da TokenLab. Use purpose=batch, purpose=batch_output, purpose=user_data ou purpose=vision para restringir a lista.

NotasCopy Anchor Link

• Arquivos de entrada do lote devem usar purpose=batch.
• Use purpose=batch_output para focar nos arquivos de saída gerados.
• completion_window é atualmente 24h.
• A ordenação da saída não é garantida; sempre combine pelo custom_id.
• Streaming não é suportado dentro de itens de lote.

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

Solicitação / RespostaCopy Anchor Link

Use o painel OpenAPI interativo acima para ver o esquema exato.

Dicas operacionaisCopy Anchor Link

• Use custom_id para reconciliação downstream idempotente.
• Espere output_file_id e error_file_id apenas depois que o worker finalizar o lote.

FiltrosCopy Anchor Link

• Para arquivos de lote e referências de imagem, limit aceita 1–10000 (padrão 10000), com after para paginação. No modo Anthropic Files, aceita 1–1000 (padrão 20); use after_id ou before_id, nunca 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.

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

Campos importantesCopy Anchor Link