# Batch API: Bulk Async Workloads

> Source: https://sukruyusufkaya.com/en/learn/claude-ustaligi/batch-api
> Updated: 2026-05-11T13:48:35.358Z
> Category: Claude Ustalığı
> Module: 8. Programmatic Claude with the API
**TLDR:** Run async workloads at 50% cost with the Batch API. Ideal for labeling, content generation, and evals.

# Batch API

Anlık cevap gerekmiyorsa görevleri tek dosyada Batch API'ye yolla. 24 saat içinde işlenir, **%50 indirim**.

```python
# Batch API iskeleti
batch = client.messages.batches.create(requests=[
    {
        "custom_id":"label-001",
        "params":{
            "model":"claude-sonnet-4-6",
            "max_tokens":256,
            "messages":[{"role":"user","content":"Şu mesajı kategorile: ..."}],
        },
    },
    # ... 999 daha
])
print(batch.id, batch.status)

# Daha sonra sonuçları kontrol et
batch = client.messages.batches.retrieve(batch.id)
if batch.status == "ended":
    for line in client.messages.batches.results(batch.id):
        print(line["custom_id"], line["result"]["message"]["content"])
```

### Ne zaman ideal?

- Veri etiketleme (10K+ kayıt)
- İçerik üretimi (binlerce SEO meta description)
- Eval üretimi
- Geriye dönük loglardan analiz

### Ne zaman uygun değil?

- Real-time chat
- Latency hassas UI
- Etkileşimli agent

### Maliyet matematiği

1M etiketleme ihtiyacı, çağrı başına ortalama 200 input + 100 output token. Sonnet ile:

- Realtime: ~$1500
- Batch %50: ~$750

**Boşluk doldurma egzersizi (text):**
```text
Batch API anlık olmayan iş yükleri için _____ indirim sağlar. SLA tipik olarak _____ saatlik penceredir. Etiketleme ve _____ üretimi en yaygın kullanım.
```

> ✋ Kontrol noktası: `q-806-mc1`