Archivos y lotes

Recuperar archivo

Recupera los metadatos de un único archivo subido.

GET
/v1/files/{file_id}

Resumen

Este endpoint sirve principalmente a los objetos de archivo de la API Batch compatible con OpenAI de TokenLab.

Cuando la solicitud entra en el modo de compatibilidad con Anthropic Files, la misma ruta también puede devolver metadatos de archivos estilo Anthropic para el workspace enlazado.

Sin encabezados Anthropic, esta ruta puede devolver un objeto de archivo de lote o un objeto de archivo de imagen/referencia de TokenLab.

Notas

  • Los archivos de entrada del lote deben usar purpose=batch.
  • completion_window es actualmente 24h.
  • El orden de salida no está garantizado; siempre empareja por custom_id.
  • No se admite streaming dentro de elementos del lote.

Ejemplo

Solicitud

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

Solicitud / Respuesta

Usa el panel OpenAPI interactivo de arriba para ver el esquema exacto.

Consejos operativos

  • Usa custom_id para reconciliación descendente idempotente.
  • Espera output_file_id y error_file_id solo después de que el worker finalice el lote.

Archivos de referencia de imagen

Este endpoint también puede devolver metadatos de archivos de referencia de imagen creados por TokenLab. El campo status es opcional y puede no estar presente en familias de archivos que no lo proporcionen.

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
Identificador de archivo usado por APIs relacionadas.
filenamestring
Nombre original o generado del archivo.
purposestring
Propósito del archivo usado por el flujo propietario, 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