> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperar archivo

> Recupera los metadatos de un único archivo subido.

## 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

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

## 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.
* El precio del lote puede diferir del síncrono porque se aplican las reglas de descuento `isBatchRequest=true`.

## Ejemplo de respuesta

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "file_abc123",
    "object": "file",
    "bytes": 32768,
    "created_at": 1706000000,
    "filename": "batch-input.jsonl",
    "purpose": "batch"
  }
  ```
</ResponseExample>

## Campos importantes

<ResponseField name="id" type="string">Identificador de archivo usado por APIs relacionadas.</ResponseField>
<ResponseField name="filename" type="string">Nombre original o generado del archivo.</ResponseField>
<ResponseField name="purpose" type="string">Propósito del archivo usado por el flujo propietario, como `batch`, `batch_output`, `user_data` o `vision`.</ResponseField>