Dosyaları Listele

Genel BakışCopy Anchor Link

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.

NotlarCopy Anchor Link

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

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

İstek / YanıtCopy Anchor Link

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

Operasyonel İpuçlarıCopy Anchor Link

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

FiltrelerCopy Anchor Link

• Batch ve görüntü referans dosyalarında limit 1–10000 arasındadır (varsayılan 10000); sayfalama için after kullanılır. Anthropic Files modunda aralık 1–1000’dir (varsayılan 20); after_id veya before_id kullanın, ikisini birlikte kullanmayın.
• purpose batch, batch_output, user_data veya vision olabilir.
• user_data ve vision, varsa TokenLab tarafından oluşturulan görüntü referans dosyalarını döndürür.

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

Önemli alanlarCopy Anchor Link