Dosya Yükle

Genel BakışCopy Anchor Link

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.

Desteklenen Dosya ModlarıCopy Anchor Link

TokenLab /v1/files yolunu üç açık mod olarak ele alır:

• Batch dosyaları: /v1/batches için purpose=batch kullanın.
• Görüntü/referans dosyaları: dosya tabanlı görüntü istekleri için purpose=user_data veya purpose=vision kullanın.
• Anthropic Files API modu: Anthropic native dosya depolaması için anthropic-beta: files-api-2025-04-14 ekleyin.

NotlarCopy Anchor Link

• Toplu 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.
• Toplu öğeler içinde akış desteği yoktur.

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

İstek / YanıtCopy Anchor Link

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

Operasyonel İpuçlarıCopy Anchor Link

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

Görüntü dosyası girişleriCopy Anchor Link

Aynı /v1/files rotası /v1/images/edits için görüntü referans dosyaları da yükleyebilir.

• purpose=user_data veya purpose=vision kullanın.
• Görüntü düzenleme modelini seçmek için isteğe bağlı olarak model ekleyin; varsayılan gpt-image-2 değeridir.
• Dönen file_id, seçilen görüntü düzenleme yapılandırmasına bağlanır ve images[].file_id içinde yeniden kullanılabilir.

Anthropic Files API ModuCopy Anchor Link

Bu aynı /v1/files rotası, Anthropic Files API yolunu da destekler.

• Anthropic moduna geçmek için anthropic-beta: files-api-2025-04-14 başlığını ekleyin.
• Anthropic modunda orijinal dosyayı doğrudan yükleyin ve purpose=batch göndermeyin.
• Dönen file_id, aynı Anthropic uyumlu çalışma alanına bağlanır ve sonraki /v1/messages isteklerinde yeniden kullanılmalıdır.
• Bu dosyaya Anthropic mesaj içeriğinde referans verecekseniz Anthropic yerel başlıklarını (x-api-key, anthropic-version ve gerektiğinde beta header) kullanmaya devam edin.

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

Önemli alanlarCopy Anchor Link