Dosyalar ve toplu işler

Batch Al

Bir batch'in mevcut durumunu, sayımlarını ve sonuç dosyalarını alır.

GET
/v1/batches/{batch_id}

Genel Bakış

Bu uç nokta, TokenLab'nın OpenAI uyumlu Batch API'sinin bir parçasıdır. Batch işleri, yüklenen JSONL dosyalarını kullanır, asenkron olarak çalışır ve daha sonra çıktı/hata dosyalarını döndürebilir.

Notlar

  • Batch giriş dosyaları purpose=batch kullanmalıdır.
  • completion_window şu anda 24h'dir.
  • Çıktı sıralaması garanti edilmez; her zaman custom_id ile eşleştirin.
  • Batch öğeleri içinde akış desteği yoktur.

Örnek

İstek

cURL
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

İstek / Yanıt

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

Operasyonel İpuçları

  • İdempotent aşağı akış uzlaştırması için custom_id kullanın.
  • Çalışan batch'i tamamladıktan sonra yalnızca output_file_id ve error_file_id bekleyin.

Yanıt örneği

Yanıt

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "status": "completed",
  "input_file_id": "file_abc123",
  "output_file_id": "file_out123",
  "error_file_id": "file_err123",
  "request_counts": { "total": 100, "completed": 98, "failed": 2 }
}

Önemli alanlar

request_countsobject
Toplam, tamamlanan, başarısız ve iptal edilen istek sayıları.
output_file_idstring|null
İlgili API’lerde kullanılan file identifier.
error_file_idstring|null
İlgili API’lerde kullanılan file identifier.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

batch_id*string

Yanıt

application/json

application/json