Fiyat ve bütçe · 2026-09-23
Claude Opus 5'te 5 dakikalık ve 1 saatlik cache yazma fiyatı: hangisi ne zaman kazandırır
anthropic/claude-opus-5'in iki cache yazma fiyatının (5 dakika ve 1 saat TTL) farkını, LLMTR üzerinden `cache_control` işaretinin nasıl gönderildiğini ve hangi TTL'in hangi istek aralığında maliyeti düşürdüğünü anlatır.
İki ayrı yazma fiyatı, tek bir okuma fiyatı
Claude Opus 5'in fiyat kartında cache yazma iki ayrı kalem taşır: 5 dakikalık TTL için 1M token başına 6,25 dolar, 1 saatlik TTL için 10 dolar. Cache okuma ise TTL'den bağımsız olarak tek bir fiyattan (0,50 dolar) hesaplanır. Normal girdi fiyatı 5 dolar olduğuna göre 5 dakikalık yazma girdinin 1,25 katı, 1 saatlik yazma 2 katı, okuma ise onda biridir.
Model 1M token'a kadar bağlam ve 128K maksimum çıktı sunar; varsayılan olarak açık olan adaptive thinking ile birlikte, uzun bir sistem talimatını veya büyük bir kod tabanını tekrar tekrar gönderen bir ajan akışında bu üç fiyat toplam maliyetin büyük kısmını belirler.
İşareti LLMTR üzerinden gönderme
LLMTR, `cache_control` işaretini hem `/v1/messages` hem `/v1/chat/completions` ucunda Anthropic'e iletir. İşaret `{"type": "ephemeral"}` biçimindedir; `ttl` olarak `"5m"` ya da `"1h"` verilebilir, `ttl` verilmezse 5 dakika geçerlidir. Messages ucunda işaret system, metin ve görsel bloklarına, araç tanımlarına ve tool_result bloklarına konabilir; Chat Completions ucunda mesaj içeriğindeki metin veya görsel parçasına eklenir.
İşaretten önceki her şey (araç tanımları, system talimatı ve o noktaya kadarki mesajlar) tek bir önek olarak cache'lenir. Cache önek eşleşmesiyle çalışır: önekte tek bir karakter değişirse, örneğin system talimatına saat damgası eklenirse, sonraki istek cache'i okuyamaz ve öneki yeniden yazar. Değişmeyen içeriği başa, her istekte değişen soruyu işaretten sonraya koyun. Opus 5'te cache'lenebilen en kısa önek 512 token'dır; daha kısa bir önek hata vermez, yalnızca cache'lenmez.
Messages ucunda 1 saatlik cache işareti
curl "$LLMTR_BASE_URL/v1/messages" \
-H "Authorization: Bearer $LLMTR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "anthropic/claude-opus-5",
"max_tokens": 4096,
"system": [
{"type": "text", "text": "<uzun ve sabit system talimatı>", "cache_control": {"type": "ephemeral", "ttl": "1h"}}
],
"messages": [{"role": "user", "content": "<her istekte değişen soru>"}]
}'
Hangi TTL ne zaman kâra geçer
Her okuma cache'in süresini baştan başlatır. Aynı öneki kullanan istekler 5 dakikadan kısa aralıklarla geliyorsa 5 dakikalık cache hiç soğumaz; bu durumda 1 saatlik TTL yalnızca iki kat yazma fiyatı demektir. 1 saatlik TTL, istekler arasında 5 ile 60 dakika boşluk olduğunda kazandırır: 20 dakika sonra dönen bir kullanıcı ya da çeyrek saatte bir çalışan bir iş gibi. Bu aralıkta 5 dakikalık cache her istekte süresi dolmuş olarak bulunur ve her seferinde yeniden yazılır; yazma normal girdiden pahalı olduğu için bu, hiç işaret koymamaktan daha pahalıdır.
Aşağıdaki tablo yalnızca 100K token'lık sabit önekin maliyetini gösterir; önekten sonra gelen içerik ve çıktı her durumda aynı fiyatla faturalanır.
- İstekler 5 dakikadan kısa aralıklarla geliyorsa: 5 dakikalık TTL; ilk tekrar kullanımda kâra geçer.
- İstekler 5 ile 60 dakika arayla geliyorsa: 1 saatlik TTL; ikinci tekrar kullanımda kâra geçer.
- Önek yalnızca bir kez kullanılıyorsa işaret koymayın; yazma, normal girdiden pahalıdır.
| Senaryo | İşaretsiz | 5 dk TTL | 1 saat TTL |
|---|---|---|---|
| Tek istek | 0,50$ | 0,625$ | 1,00$ |
| 5 dakika içinde 2 istek | 1,00$ | 0,675$ | 1,05$ |
| Her biri öncekinden 5 dakika içinde 10 istek | 5,00$ | 1,075$ | 1,45$ |
| 20 dakika arayla 4 istek | 2,00$ | 2,50$ | 1,15$ |
Cache'in tuttuğunu doğrulama
Messages yanıtındaki `usage` alanında `cache_creation_input_tokens` cache'e yazılan, `cache_read_input_tokens` cache'ten okunan token sayısını verir; `input_tokens` ise son işaretten sonra kalan, normal fiyatlı kısımdır. Chat Completions yanıtında cache'ten okunan token sayısı `usage.prompt_tokens_details.cached_tokens` alanında görünür.
Aynı önekle gönderdiğiniz ikinci istekte okuma değeri sıfır geliyorsa ya önek değişmiştir ya da TTL dolmuştur. İlk adım olarak system talimatında ve araç tanımlarında her istekte değişen bir değer (tarih, istek kimliği, sırası değişen bir liste) olup olmadığına bakın.
Sık sorulan sorular
LLMTR üzerinden Claude Opus 5 ile 1 saatlik cache kullanabilir miyim?
Evet. İşarete `"ttl": "1h"` ekleyin. Cache'e yazılan kısım 1M token başına 10 dolar, sonraki okumalar 0,50 dolar üzerinden faturalanır.
Claude Opus 5.5'te de aynı işaret çalışır mı?
Evet, işaret ve TTL seçimi aynıdır. Opus serisinin güncel modeli olan Opus 5.5'te fiyatlar daha düşüktür: girdi 1M token başına 4 dolar, 5 dakikalık yazma 5 dolar, 1 saatlik yazma 8 dolar, okuma 0,20 dolar.
Adaptive thinking maliyeti etkiler mi?
Adaptive thinking varsayılan olarak açıktır ve reasoning tokenları çıktı olarak faturalanır; bu, girdi maliyetinden ayrı bir kalemdir, ikisini birlikte hesaba katın.