Dosyalar ve toplu işler
Mesaj Toplu İşlemi Oluştur
Asenkron olarak çalışan bir Mesaj isteği grubu oluşturur.
Genel Bakış
Tek bir çağrıda 100.000'e kadar Mesaj isteği gönderin. Toplu işlem asenkron olarak çalışır. Yanıt, processing_status değeri in_progress olarak ayarlanmış şekilde anında döner. Toplu işlem ended durumuna gelene kadar toplu işlemi alın, ardından sonuçları alın.
Notlar
requestsiçindeki her öğenin bircustom_idveparamsdeğeri vardır.params,max_tokensdahil olmak üzere Mesaj Oluştur ile aynı alanları alır. Öğelerspeed: "fast"kullanamaz.custom_id, 1 ila 64 karakter uzunluğunda harf, rakam, alt çizgi veya tire içerebilir ve toplu işlem içinde benzersiz olmalıdır.- Toplu işlemdeki her model, toplu işlemler için kullanılabilir olmalıdır. TokenLab, bir model uygun olmadığında veya hiçbir rota toplu işlemdeki tüm modelleri destekleyemediğinde isteğin tamamını
400hatasıyla reddeder. - TokenLab, toplu işlemi kabul ettiğinde tahmini maliyeti rezerve eder ve bakiye bunu karşılayamadığında
402hatası döndürür. Toplu işlem sona erdikten sonra TokenLab, başarılı olan isteklerin kullanım ücretini tahsil eder. Toplu işlem fiyatları, senkron fiyatlardan farklı olabilir. - Bir öğe
file_idiçeriğine referans veriyorsa,anthropic-beta: files-api-2025-04-14başlığını gönderin. - Zaman aşımına uğrayan bir oluşturma isteğini güvenli bir şekilde yeniden denemek için bir
Idempotency-Keygönderin. Bkz: Idempotency key ile güvenli yeniden deneme.
İstek
curl -X POST "https://api.tokenlab.sh/v1/messages/batches" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Idempotency-Key: 6f1c2a9e-0b7d-4c1e-9a53-2d9f3a1b7c10" \
-H "Content-Type: application/json" \
-d '{
"requests": [
{
"custom_id": "request-1",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude!"}]
}
},
{
"custom_id": "request-2",
"params": {
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Name three colors."}]
}
}
]
}'Yanıt
{
"id": "msgbatch_01ABC123",
"type": "message_batch",
"processing_status": "in_progress",
"request_counts": {
"processing": 2,
"succeeded": 0,
"errored": 0,
"canceled": 0,
"expired": 0
},
"ended_at": null,
"created_at": "2026-11-01T10:00:00Z",
"expires_at": "2026-11-02T10:00:00Z",
"cancel_initiated_at": null,
"archived_at": null,
"results_url": null
}Önemli alanlar
in_progress, canceling veya ended.processing, succeeded, errored, canceled veya expired durumundaki isteklerin sayısı.expired olarak sonuçlanır.null değerindedir.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
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.
1 <= length <= 255İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json