Dosyalar ve toplu işler
Dosya Yükleme
Bir toplu işlem (batch) dosyası, görsel referansı veya Anthropic formatında dosya yükleyin.
Dosya Amaçları (File Purposes)
- Toplu işlem dosyaları:
/v1/batchesiçinpurpose=batchkullanın. - Görsel/referans dosyaları: Dosya destekli görsel istekleri için
purpose=user_dataveyapurpose=visionkullanın. - Anthropic Dosyaları:
anthropic-beta: files-api-2025-04-14başlığını ekleyin.
İstek
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_dataveyapurpose=visionkullanın.- İsteğe bağlı olarak görsel düzenleme modelini seçmek için
modelparametresini ekleyin; varsayılan değergpt-image-2'dir. - Döndürülen
file_id, seçilen görsel düzenleme yapılandırmasına bağlıdır veimages[].file_idiçinde yeniden kullanılabilir.
Anthropic Files API Modu
- Anthropic Dosyalarını kullanmak için
anthropic-beta: files-api-2025-04-14başlığını ekleyin. - Anthropic modunda, orijinal dosyayı doğrudan yükleyin ve
purpose=batchgöndermeyin. - Döndürülen
file_idyalnızca mevcut Çalışma Alanında (Workspace) kullanılabilir ve/v1/messagesisteklerinde 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-versionve gerektiğinde beta başlığı) kullanmaya devam edin.
Yanıt
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Önemli alanlar
batch, user_data veya vision değerlerini kabul eder.Yetkilendirme
BearerAuth 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 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