Recuperar arquivo

Visão geralCopy Anchor Link

Este endpoint serve principalmente aos objetos de arquivo da API de Batch compatível com OpenAI da TokenLab.

Quando a requisição entra no modo de compatibilidade com Anthropic Files, a mesma rota também pode retornar metadados de arquivo no estilo Anthropic para o workspace vinculado.

Sem cabeçalhos Anthropic, esta rota pode retornar um objeto de arquivo de lote ou um objeto de arquivo de imagem/referência da TokenLab.

NotasCopy Anchor Link

• Arquivos de entrada do lote devem usar purpose=batch.
• 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/file_abc123" \
  -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.

Arquivos de referência de imagemCopy Anchor Link

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

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

Campos importantesCopy Anchor Link