Dosyalar ve toplu işler

Mesaj Toplu İşlemi Oluştur

Asenkron olarak çalışan bir Mesaj isteği grubu oluşturur.

POST
/v1/messages/batches

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

  • requests içindeki her öğenin bir custom_id ve params değeri vardır. params, max_tokens dahil olmak üzere Mesaj Oluştur ile aynı alanları alır. Öğeler speed: "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ı 400 hatasıyla reddeder.
  • TokenLab, toplu işlemi kabul ettiğinde tahmini maliyeti rezerve eder ve bakiye bunu karşılayamadığında 402 hatası 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_id içeriğine referans veriyorsa, anthropic-beta: files-api-2025-04-14 baş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-Key gönderin. Bkz: Idempotency key ile güvenli yeniden deneme.

Örnek

İstek

cURL
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 örneği

Yanıt

200 OK
{
  "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

idstring
Mesaj toplu işlem kimliği. Toplu işlemi almak, iptal etmek, silmek ve sonuçlarını elde etmek için kullanılır.
processing_statusstring
in_progress, canceling veya ended.
request_countsobject
processing, succeeded, errored, canceled veya expired durumundaki isteklerin sayısı.
expires_atstring
Toplu işlemin sona erme zamanı. O zamana kadar tamamlanmayan istekler expired olarak sonuçlanır.
results_urlstring|null
Sonuçların URL'si. Toplu işlem sona erene kadar null değerindedir.

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

X-TokenLab-Delivery-Policy?string

İ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"
Idempotency-Key?string

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.

Uzunluk1 <= 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