TokenLab
Obtener clave API
DocumentaciónReferencia APIIntegraciones

Archivos y lotes

Listar archivos

Enumera los archivos de procesamiento por lotes (batch) y de referencia de imagen cargados.

GET
/v1/files

Enumera los archivos de procesamiento por lotes y de referencia de imagen. Filtre con purpose=batch, purpose=batch_output, purpose=user_data o purpose=vision.

Con los encabezados de Anthropic Files, la misma API enumera los archivos en formato 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 procesamiento por lotes y de referencia de imagen, limit es de 1 a 10000 (el valor predeterminado es 10000), con after para la paginación. En el modo Anthropic Files, limit es de 1 a 1000 (el valor predeterminado es 20); utilice 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 imagen 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
Rango1 <= value <= 1000
predeterminado20
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

Cargar archivo

Anterior

Recuperar archivo

Siguiente