Claude API: API anahtarı, fiyatlar ve ilk istek

Güncelleme (9 Kasım 2026): Claude Fable 5.2 ve Mythos 5.2 çıktı - fiyatlar, erişim ve benchmark sonuçları Claude Fable 5.2 rehberimde.

👁 115 okunma

Claude API, Anthropic modellerini kendi kodunuzdan kullanmanızı sağlar: abonelik yerine kullandığınız tokenlar için ödeme yapar, hangi modelin hangi görevi yerine getireceğine kendiniz karar verirsiniz. Console üzerinden birkaç dakika içinde anahtar alabilir, Python’da beş satır kodla ilk isteğinizi gönderebilirsiniz. Fiyatlandırma tarafında ise beş model, istem önbelleği, toplu işlem modu ve kullanım seviyeleri var. Aşağıda resmi USD fiyatlarını, üç maliyet örneğini ve OpenAI ile Gemini karşılaştırmasını bulabilirsiniz.

Claude API ve Console nedir?

Console (platform.claude.com), geliştirici panelidir: burada organizasyon oluşturabilir, API anahtarı üretebilir, hesabınıza kredi yükleyebilir ve kullanımınızı görebilirsiniz. API ise programınızın mesaj gönderip yanıt aldığı api.anthropic.com uç noktasıdır. Bu hesap claude.ai hesabından ayrıdır: Pro veya Max aboneliği API kredisi sağlamaz; API kredileri de aboneliğe dahil değildir. API ticari koşullarda sunulur; varsayılan olarak API verileri model eğitiminde kullanılmaz.

Claude Code her iki şekilde de çalışır: Pro/Max aboneliğiyle veya API anahtarıyla. Abonelik mi API mi daha uygun, abonelik ve API maliyet karşılaştırması yazısında hesapladım.

Claude API hesabı, anahtarı ve bakiye yükleme

1. platform.claude.com üzerinden e-posta adresinizle veya Google hesabınızla kaydolun ve organizasyon adı girin.
2. API Keys bölümünde “Create Key” düğmesine tıklayın, anahtara bir ad verin ve hemen kopyalayın: Console anahtarı yalnızca bir kez gösterir. Anahtarı ortam değişkeninde saklayın; depoya yüklediğiniz koda asla eklemeyin.
3. Billing bölümüne kart ekleyin ve kredi satın alın. Ödeme USD cinsinden peşin yapılır.
4. Hangi seviyede olduğunuzu Rate limits bölümünden kontrol edin.

Kullanım seviyeleri (tiers) şu anda Start, Build, Scale ve Custom olarak adlandırılıyor. Yeni organizasyonlar, standart seviyelerden daha düşük limitleri olan Evaluation seviyesinden başlayabilir. Limitler kullanım geçmişi oluştukça otomatik olarak artar. Aylık harcama sınırı Start için 500 USD, Build için 1.000 USD, Scale için 200.000 USD. Start seviyesinde Sonnet 5’in dakikada 1.000 istek ve 2 milyon giriş tokenı sınırı var; küçük bir uygulama için bu kapasite fazlasıyla yeterli.

Claude API fiyatları

Aşağıdaki rakamlar resmi dokümantasyondaki milyon token başına, vergi hariç USD fiyatlarıdır:

Faturayı düşürmenin üç yolu var. İstem önbelleği: önbelleğe yazma, 5 dakikalık süre için giriş ücretinin 1,25 katı; bir saatlik süre için 2 katıdır. Önbellekten okuma standart giriş ücretinin yüzde 10’u kadar tutar; Opus 5.5 ve Fable 5.1 modellerinde daha da ucuzdur. İlk önbellek isabetinden itibaren tasarruf sağlayabilir. Batch API: acil olmayan ve saatler içinde işlenen isteklerde giriş ve çıkış ücretleri yüzde 50 daha düşüktür. 1 milyon tokenlık bağlam penceresi, 4.6 ve üzeri modellerde standart fiyata dahildir. Tokenizer’a dikkat: 4.7 ve üzeri modeller aynı metinden Sonnet 4.6 ve daha eski modellere kıyasla yaklaşık yüzde 30 daha fazla token sayabilir. Web araması ayrıca 1.000 arama başına 10 USD tutar.

Fiyat tablosuna göre üç maliyet örneği:

• Web sitesi sohbet botu: Sonnet 5 ile ayda 1.000 görüşme; her görüşmede 3.000 giriş ve 500 çıkış tokenı. 3 milyon giriş tokenı 6 USD, 0,5 milyon çıkış tokenı 5 USD tutar; toplam 11 USD.
• 500 belgeyi işleme: Haiku 4.5 ile her biri 20.000 token ve 1.000 tokenlık yanıt. Giriş 10 USD, çıkış 2,50 USD; toplam 12,50 USD. Batch modunda yaklaşık 6,2 USD.
• Opus 5.5 kullanan kodlama ajanı: 200 görev, her biri 100.000 bağlam tokenı (yüzde 80’i önbellekten) ve 5.000 çıkış tokenı. Yeni giriş 16 USD, önbellekten okuma 3,20 USD, çıkış 20 USD; toplam yaklaşık 39 USD.

Claude API ile ilk istek: Python ve curl

API anahtarınızı ANTHROPIC_API_KEY ortam değişkenine ekleyin, pip install anthropic komutuyla kütüphaneyi yükleyin ve şu kodu çalıştırın. İstemdeki Türkçe metin, özgün Lehçe test isteminin çevirisidir; Türkçe olarak yeniden test edilmemiştir:

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=500,
    messages=[{"role": "user", "content": "GDPR'nin ne olduğunu üç cümlede özetle."}],
)
print(message.content[0].text)
print(message.usage)

Aynı isteği curl ile göndermek için. İstemdeki Türkçe metin, özgün Lehçe test isteminin çevirisidir; Türkçe olarak yeniden test edilmemiştir:

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":500,
       "messages":[{"role":"user","content":"GDPR''nin ne olduğunu üç cümlede özetle."}]}'

Yanıttaki usage alanı giriş ve çıkış tokenlarının sayısını verir; böylece maliyeti hemen hesaplayabilirsiniz. Sık karşılaşılan hatalar: 401 hatası yanlış anahtarı, 429 dakikalık sınırın aşılmasını (ne kadar beklemeniz gerektiğini retry-after başlığı bildirir) veya aylık harcama sınırını gösterir. 400 hatası “specified API usage limits” mesajıyla geliyorsa Billing bölümündeki kendi limitiniz aşılmıştır. Modellere ve anahtarlara göre kullanımınızı Usage bölümünde görebilirsiniz. Modele araç eklemek istiyorsanız Claude API ve MCP ile ajan geliştirme yazısına göz atın.

Claude API, OpenAI ve Gemini API karşılaştırması

Üç sağlayıcı da toplu işlem modunda yüzde 50 indirim ve istem önbelleği sunuyor. Ücretsiz kullanım seçenekleri farklı: Gemini’nin, verileri ürünlerini geliştirmek için kullandığı, sürekli bir ücretsiz seviyesi var; Anthropic ve OpenAI’da yok. Editörün görüşü: fiyatlar yakınsa seçimde belirleyici olan fiyat tablosu değil, modelin sizin görevinizdeki performansıdır.

Benim hizmetim Jantaris üzerinden Claude API’sini de kullanabilirsin: Claude Opus 5.5, 1 milyon giriş / çıkış token’ı başına $3,78 / $18,90, Claude Sonnet 5.5 ise $1,89 / $9,45; ödeme USD cinsinden ön ödemeli bakiyeden yapılır ve Anthropic ile OpenAI SDK’larıyla uyumludur. Modeller, fiyatlar ve kurulum: Jantaris rehberi.

Sık sorulan sorular

Claude API ücretsiz kullanılabilir mi?

Yeni kullanıcılar testler için az miktarda ücretsiz kredi alır. Gemini API’deki gibi sürekli bir ücretsiz kullanım seviyesi yoktur.

API’ye gönderdiğim veriler modeli eğitmek için kullanılır mı?

Hayır. API ticari koşullarda çalışır ve varsayılan olarak müşteri verileriyle eğitim yapılmaz. Standart saklama süresi 30 gündür; şirketler sıfır günlük saklama koşulunu görüşebilir.

Ödeme ve fatura işlemleri nasıl yapılır?

Ödeme kartla, USD cinsinden ve peşin yapılır. Faturalar Console’daki Billing bölümünde bulunur.

Başlangıçta hangi Claude modelini seçmeliyim?

Sonnet 5 ile başlayabilirsiniz. Fable 5.1’den beş kat ucuzdur ve çoğu metin görevi için yeterlidir. Sınıflandırma ve büyük ölçekli işleme için Haiku 4.5’i, karmaşık akıl yürütme ve uzun ajan görevleri için Opus 5.5’i seçebilirsiniz. Daha fazla bilgi için Claude fiyatları yazısına bakın.

// okumaya devamClaude Code’dan Codex’e geçiş: AGENTS.md, skill ve MCPGenelPentagon’da Claude Code ajanı: WIRED’ın iddialarıHaberlerClaude Opus 5.5 effort ayarı: low, medium ve high farkıKarşılaştırmalar