Dosyalar ve toplu işler

Toplu Oluştur

Yüklenen bir girdi dosyasından OpenAI uyumlu bir toplu iş oluşturur.

POST
/v1/batches

Genel Bakış

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

Notlar

  • Toplu girdi dosyaları purpose=batch kullanmalıdır.
  • completion_window şu anda 24h.
  • Çıktı sıralaması garanti edilmez; her zaman custom_id ile eşleştirin.
  • Toplu öğeler içinde akış desteği yoktur.
  • Desteklenen batch öğesi uç noktaları /v1/chat/completions ve /v1/embeddingstir. /v1/responses desteklenmez.

Örnek

İstek

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

İstek / Yanıt

Tam şema 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.
  • output_file_id ve error_file_id'yi yalnızca işçi toplu işi tamamladıktan sonra bekleyin.

Yanıt örneği

Yanıt

200 OK
{
  "id": "batch_abc123",
  "object": "batch",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Önemli alanlar

idstring
Sonraki çağrılar ve support için kullanılan identifier.
statusstring
Bu kaynağın güncel lifecycle durumu.
output_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

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json