Archivos y lotes

Recuperar archivo

Recupera los metadatos de un único archivo subido.

GET
/v1/files/{file_id}

Devuelve el nombre, tamaño, propósito y hora de creación de un archivo. Sin los encabezados de Anthropic, esto cubre archivos de procesamiento por lotes (batch) y de referencia de imágenes. Con los encabezados de Anthropic Files, cubre archivos en formato Anthropic.

Ejemplo

Solicitud

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

Archivos de referencia de imágenes

Este endpoint también puede devolver metadatos para archivos de referencia de imágenes creados por TokenLab. El campo status es opcional y puede estar ausente en familias de archivos que no proporcionan uno.

Ejemplo de respuesta

Respuesta

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

Campos importantes

idstring
ID del archivo.
filenamestring
Nombre del archivo original o generado.
purposestring
Propósito del archivo, como batch, batch_output, user_data o vision.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

file_id*string

Encabezados

anthropic-beta?string

Incluya files-api-2025-04-14 para usar el modo de API de Anthropic Files.

Respuesta

application/json

application/json