Ana içeriğe atla

​
Genel Bakış

Bu endpoint, TokenLab’nın OpenAI uyumlu Batch API dosya nesnelerine hizmet eder. İstek Anthropic Files uyumluluk moduna geçtiğinde, aynı route bağlı workspace için Anthropic tarzı dosya metadata’sını da döndürebilir. Anthropic başlıkları yoksa bu route batch dosya objesi veya TokenLab görüntü/referans dosya objesi döndürebilir.

​
Notlar

  • Batch giriş dosyaları purpose=batch kullanmalıdır.
  • 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/file_abc123" \
  -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

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

​
Önemli alanlar

​
id
string
İlgili API’lerde kullanılan file identifier.
​
filename
string
Özgün veya oluşturulmuş dosya adı.
​
purpose
string
Sahip iş akışının kullandığı dosya purpose değeri; örneğin batch, batch_output, user_data veya vision.