Archivos y lotes

Listar archivos

Lista los archivos de batch y de referencia de imágenes subidos.

GET
/v1/files

Lista archivos de batch y de referencia de imágenes. Filtra con purpose=batch, purpose=batch_output, purpose=user_data o purpose=vision.

Con los encabezados de Anthropic Files, la misma API lista los archivos con formato de Anthropic en el Workspace actual.

Ejemplo

Solicitud

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

Filtros

  • Para archivos de batch y de referencia de imágenes, limit es de 1–10000 (predeterminado: 10000), con after para paginación. En el modo Anthropic Files, limit es de 1–1000 (predeterminado: 20); utiliza after_id o before_id, pero no ambos.
  • purpose puede ser batch, batch_output, user_data o vision.
  • user_data y vision devuelven archivos de referencia de imágenes creados por TokenLab cuando están disponibles.

Ejemplo de respuesta

Respuesta

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
Siempre list.
dataarray
Archivos.
has_moreboolean
Hay más resultados disponibles cuando has_more es true.

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 consulta

limit?integer

Número de archivos a devolver. De 1 a 10,000 (predeterminado 10,000) para archivos batch e imagen; de 1 a 1,000 (predeterminado 20) en modo Anthropic Files.

Rango1 <= value <= 10000
after?string
after_id?string

Cursor de Anthropic Files. Devuelve archivos después de este ID de archivo público. Requiere el encabezado beta de Anthropic Files y no se puede combinar con before_id.

before_id?string

Cursor de Anthropic Files. Devuelve archivos antes de este ID de archivo público. Requiere el encabezado beta de Anthropic Files y no se puede combinar con after_id.

scope_id?string

Cursor de ámbito reservado de Anthropic Files. TokenLab actualmente devuelve un error explícito de no compatibilidad en lugar de ignorar silenciosamente este valor.

purpose?string

Filtro de propósito de archivo opcional. batch y batch_output cubren archivos de Batch API; user_data y vision cubren vinculaciones de archivos de referencia/imagen de TokenLab. El modo de API de Anthropic Files se selecciona mediante encabezados de Anthropic en lugar de este parámetro de consulta.

Valores permitidos

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

Encabezados

anthropic-beta?string

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

Respuesta

application/json

application/json