Türkiye'den Claude API kullanmak isteyen geliştiriciler için pratik rehber. Anthropic doğrudan fiyatına göre fark, Visa/Mastercard ve uluslararası kart kullanımı, İstanbul ve Ankara'dan gecikme, lira-USD kur durumu ve KVKK uyumluluk notları — ilk çağrıdan önce bilmen gereken her şey.
5 saniyede ilk çağrı
Kunavo, OpenAI wire protokolüne uyumludur. Kodunuz zaten OpenAI SDK kullanıyorsa, geçiş tek satırlık bir base_url değişikliğidir. Python'da:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # değişen tek satır bu
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Kendini Türkçe iki cümleyle tanıt."}],
)
print(resp.choices[0].message.content)Node.js / TypeScript'te birebir aynı:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY!,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-opus-4-7",
messages: [{ role: "user", content: "Bu makaleyi 3 madde halinde özetle." }],
});
console.log(resp.choices[0].message.content);Kayıt ücretsiz: $10'dan itibaren yükleme yapar, yalnızca kullandığınız kadar ödersiniz (pay-as-you-go) ve bakiyeniz hiç sona ermez — Claude Opus 4.7, Sonnet 4.6 ve Haiku 4.5'i kapsamlı test etmek için fazlasıyla yeterli.
Anthropic doğrudan ile fiyat farkı
Kunavo üzerindeki Claude modelleri, modele göre Anthropic resmi tarifesinin %30 altında. Claude Sonnet 4.6 doğrudan milyon-token başına $3,00 input / $15,00 output — Kunavo'da $2,10 / $10,50 (%30 daha ucuz). Prompt caching ile sabit prefix'in yeniden okunması input tarifesinin %10'una faturalandırılır, yani milyon token başına yaklaşık $0,21. Tüm modeller için tam fiyatlar /pricing'de.
İstanbul ve Ankara'dan gecikme
Kunavo tek bir US-East bölgesinde (Ashburn, Virginia) çalışır; önünde TLS'i size yakın bir noktada sonlandıran bir anycast edge vardır. Edge'in kısalttığı şey TLS el sıkışmasıdır, Atlantik geçişi değil: İstanbul'daki bir cloud sunucudan gidiş-dönüş süresini ABD doğu kıyısına olan fiziksel mesafe ve modelin kendi çıkarım süresi belirler. Anthropic us-east-1'e doğrudan erişim de aynı yolu kullanır. Streaming yanıtlar upstream ile aynı time-to-first-token ile gelir — buffering yok, batching yok.
Ödeme yöntemleri — Türk kartları, uluslararası kartlar, Apple Pay ve Google Pay
Stripe'ı doğrudan kullanıyoruz. Türkiye'den müşteriler için uygun yöntemler:
- Türk bankalarının yurt dışı kullanıma açık Visa ve Mastercard kartları
- American Express (uluslararası kabul eden bankalar)
- Apple Pay, Google Pay (Chrome / Android'de kuruluysa), Link (tek tıkla ödeme)
Önemli not: Kartınız yurt dışı (uluslararası) işlemlere açık olmalıdır. Bazı Türk bankaları kartları varsayılan olarak yurt dışı kullanıma kapalı tutar — bankanıza tek seferlik veya kalıcı yurt dışı kullanım izni açtırmanız gerekebilir.
Fiyatlar USD cinsindendir; Stripe checkout sırasında TL'ye çevirir. Stripe'ın kuru, alıcının ödediği %2-4 dönüşüm ücretini içerir; USD ile öderseniz bu ücret yoktur (Stripe Adaptive Pricing belgeleri, 2026-10-03'te okundu). Banka havalesi / EFT ile ödeme yoktur. Minimum yükleme $10 USD. Abonelik değil, ön ödemeli cüzdan — bakiye asla sona ermez.
Türk Lirası dalgalanmasına karşı strateji
TL son yıllarda USD karşısında yüksek dalgalanma gösterdiği için Kunavo'nun USD-tabanlı fiyatlandırması bazı dönemlerde maliyeti yukarı çekebilir. Üç pratik yaklaşım:
- Toplu yükleme yapın: $1.000+ yüklemeler ekstra bonus kredi açar (örn. $1.000 yükleme = $1.200 kredi). Detaylar /pricing'de.
- Prompt caching kullanın: Tekrarlayan system prompt'ları olan ajan yapılarında %70-90 input tasarrufu mümkün. Rehber: prompt caching deep dive.
- Model tiering: Basit görevler için Claude Haiku 4.5 (10x daha ucuz), karmaşık görevler için Opus 4.7. Ayrıntı: cost optimization guide.
KVKK ve veri yerleşimi
Routing mantığı edge'te değil, gateway'de, tek US-East bölgesinde (Ashburn) çalışır; anycast edge yalnızca TLS'i sonlandırır. Faturalandırma ve hesap verileri, volume'ü her gün şifreli olarak snapshot'lanan tek bir birincil veritabanında depolanır. İstekleri upstream API'lere (Anthropic, OpenAI, Google) yönlendiririz — bu sağlayıcılar prompt içeriğini kendi koşullarına göre işler. Anthropic ve Google, kendi kurumsal (enterprise) müşterilerine Zero Data Retention seçenekleri sunar; ancak Kunavo ZDR yönlendirmesi, veri işleme sözleşmesi (DPA) ya da Türkiye'de veya AB'de veri yerleşimi sunmaz: istekler ABD'de işlenir ve upstream sağlayıcılara iletilir. Ekibiniz KVKK kapsamında bir veri işleme sözleşmesine, ZDR'ye veya yurt içi veri yerleşimine ihtiyaç duyuyorsa doğrudan model sağlayıcısıyla (Anthropic, OpenAI veya Google kurumsal koşulları) sözleşme yapın.
Türkçe destek
Ekibimiz contact@kunavo.com adresine gelen Türkçe e-postaları bir iş günü içinde Türkçe yanıtlar.
Sık sorulan sorular
- Türk kartım reddedildi, ne yapmalıyım? Bankanıza yurt dışı işlemlere açtırın, ya da Visa kullanmayı deneyin (Mastercard bazen bazı bankalarda sorun çıkarır).
- TL faturalandırma mümkün mü? Hayır, fiyatlandırma USD üzerinden. Stripe checkout'ta TL gösterilir ama altta yatan birim USD'dir.
- KVKK uyumluluk? Kunavo veri işleme sözleşmesi sunmaz ve istekler ABD'de işlenir. Böyle bir sözleşmeye ihtiyacınız varsa doğrudan model sağlayıcısıyla (Anthropic, OpenAI veya Google) sözleşme yapın.
- Yerel TR LLM var mı? Henüz katalogda yerel bir Türk LLM yok. Mevcut katalog için /models; changelog'a abone olun.
Başlamaya hazır mısınız? Ücretsiz kayıt olun, $10'dan itibaren yükleyin ve Claude'a ilk çağrınızı beş dakikada yapın. Türkiye'den sorularınız için doğrudan contact@kunavo.com — Türkçe yanıtlıyoruz.