Dosyalar ve toplu işler

Dosyayı Al

Tek bir yüklenmiş dosyanın metadata'sını alır.

GET
/v1/files/{file_id}

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

İstek

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

Görüntü Referans Dosyaları

Bu uç nokta, TokenLab tarafından oluşturulan görüntü referans dosyalarının meta verilerini de döndürebilir. status alanı isteğe bağlıdır ve bu alanı sağlamayan dosya ailelerinde bulunmayabilir.

Yanıt örneği

Yanıt

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

Önemli alanlar

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

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

file_id*string

Başlıklar

anthropic-beta?string

Anthropic Dosyaları API modunu kullanmak için files-api-2025-04-14 ekleyin.

Yanıt

application/json

application/json