Dosyalar ve toplu işler

Dosya Yükleme

Bir toplu işlem (batch) dosyası, görsel referansı veya Anthropic formatında dosya yükleyin.

POST
/v1/files

Dosya Amaçları (File Purposes)

  • Toplu işlem dosyaları: /v1/batches için purpose=batch kullanın.
  • Görsel/referans dosyaları: Dosya destekli görsel istekleri için purpose=user_data veya purpose=vision kullanın.
  • Anthropic Dosyaları: anthropic-beta: files-api-2025-04-14 başlığını ekleyin.

Örnek

İstek

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

Görsel Dosya Girdileri

Aynı /v1/files rotası, /v1/images/edits için görsel referans dosyaları yükleyebilir.

  • purpose=user_data veya purpose=vision kullanın.
  • İsteğe bağlı olarak görsel düzenleme modelini seçmek için model parametresini ekleyin; varsayılan değer gpt-image-2'dir.
  • Döndürülen file_id, seçilen görsel düzenleme yapılandırmasına bağlıdır ve images[].file_id içinde yeniden kullanılabilir.

Anthropic Files API Modu

  • Anthropic Dosyalarını kullanmak 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öndürülen file_id yalnızca mevcut Çalışma Alanında (Workspace) kullanılabilir ve /v1/messages isteklerinde yeniden kullanılabilir.
  • Yüklenen dosyaya Anthropic mesaj içeriğinden referans vermeyi planlıyorsanız, Anthropic'e özgü başlıkları (x-api-key, anthropic-version ve gerektiğinde beta başlığı) kullanmaya devam edin.

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
Dosya Kimliği (File ID).
purposestring
Dosyaya atanan amaç. Yüklemeler batch, user_data veya vision değerlerini kabul eder.
bytesinteger
Bayt cinsinden dosya boyutu.

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

anthropic-beta?string

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

İstek gövdesi

multipart/form-data

Yanıt

application/json

application/json

application/json

application/json