Ana içeriğe atla

​
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

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

​
İ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

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }]
}

​
Önemli alanlar

​
object
string
Yanıtın object type değeri.
​
data
array
Bu yanıtta dönen liste veya payload.