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

# Dosyaları Listele

> Batch iş akışları ve desteklenen dosya tabanlı uyumluluk modları için yüklenen dosyaları listeler.

## Genel Bakış

Bu endpoint, TokenLab'nın OpenAI uyumlu Batch API'sine hizmet eder; yüklenen batch girişlerini ve oluşturulan output veya error dosyalarını kapsar.

İstek Anthropic Files uyumluluk moduna geçtiğinde, aynı route bağlı workspace için kullanılabilen Anthropic tarzı dosyaları da listeleyebilir.

Anthropic başlıkları yoksa liste hem batch dosyalarını hem de TokenLab görüntü/referans dosyalarını içerebilir. Listeyi daraltmak için `purpose=batch`, `purpose=batch_output`, `purpose=user_data` veya `purpose=vision` kullanın.

## Notlar

* Batch giriş dosyaları `purpose=batch` kullanmalıdır.
* Oluşturulan output dosyalarına odaklanmak için `purpose=batch_output` kullanın.
* `completion_window` şu anda `24h`'dir.
* Output sırası garanti edilmez; her zaman `custom_id` ile eşleştirin.
* Streaming, batch öğelerinin içinde desteklenmez.

## Örnek

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

## İstek / Yanıt

Kesin şema için yukarıdaki etkileşimli OpenAPI panelini kullanın.

## Operasyonel İpuçları

* Downstream mutabakatı idempotent yapmak için `custom_id` kullanın.
* `output_file_id` ve `error_file_id` yalnızca worker batch'i tamamladıktan sonra beklenmelidir.
* `isBatchRequest=true` indirim kuralları uygulandığı için batch fiyatlandırması senkron fiyatlandırmadan farklı olabilir.

## Yanıt örneği

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "object": "list",
    "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }]
  }
  ```
</ResponseExample>

## Önemli alanlar

<ResponseField name="object" type="string">Yanıtın object type değeri.</ResponseField>
<ResponseField name="data" type="array">Bu yanıtta dönen liste veya payload.</ResponseField>