TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Dosyalar ve toplu işler

Dosyaları Listele

Yüklenen toplu işlem (batch) ve görüntü referans dosyalarını listeleyin.

GET
/v1/files

Toplu işlem ve görüntü referans dosyalarını listeleyin. purpose=batch, purpose=batch_output, purpose=user_data veya purpose=vision ile filtreleme yapın.

Anthropic Files başlıkları ile aynı API, mevcut Çalışma Alanındaki (Workspace) Anthropic formatındaki dosyaları listeler.

Örnek

İstek

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

Filtreler

  • Toplu işlem ve görüntü referans dosyaları için limit 1–10000 arasındadır (varsayılan 10000), sayfalama için after kullanılır. Anthropic Files modunda limit 1–1000 arasındadır (varsayılan 20); after_id veya before_id parametrelerinden birini kullanın, ikisini birden kullanmayın.
  • purpose değeri batch, batch_output, user_data veya vision olabilir.
  • user_data ve vision, mevcut olduğunda TokenLab tarafından oluşturulan görüntü referans dosyalarını döndürür.

Yanıt örneği

Yanıt

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

Önemli alanlar

objectstring
Her zaman list değerini alır.
dataarray
Dosyalar.
has_moreboolean
has_more true olduğunda daha fazla sonuç mevcut demektir.

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

Sorgu parametreleri

limit?integer
Aralık1 <= value <= 1000
varsayılan20
after?string
after_id?string

Anthropic Dosyaları imleci. Bu genel dosya kimliğinden sonraki dosyaları döndürür. Anthropic Dosyaları beta başlığını gerektirir ve before_id ile birleştirilemez.

before_id?string

Anthropic Dosyaları imleci. Bu genel dosya kimliğinden önceki dosyaları döndürür. Anthropic Dosyaları beta başlığını gerektirir ve after_id ile birleştirilemez.

scope_id?string

Ayrılmış Anthropic Dosyaları kapsam imleci. TokenLab şu anda bu değeri sessizce yoksaymak yerine açık bir desteklenmeyen hatası döndürür.

purpose?string

İsteğe bağlı dosya amacı filtresi. batch ve batch_output, Toplu İş API dosyalarını kapsar; user_data ve vision, TokenLab görsel/referans dosyası bağlamalarını kapsar. Anthropic Dosyaları API modu, bu sorgu parametresi yerine Anthropic başlıkları ile seçilir.

Geçerli değerler

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

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

Dosya Yükleme

Önceki

Dosyayı Getir

Sonraki