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 ölçülen 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-kunavo-...",
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);Ücretsiz kayıt size $2 başlangıç kredisi verir — 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 her Claude modeli Anthropic resmi tarifesinin %30 altında. Claude Sonnet 4.6 doğrudan milyon-token başına $3 input / $15 output — Kunavo'da $2,10 / $10,50. 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 edge gateway node'ları Kuzey Amerika, AB ve APAC'ta dağıtılı. İstanbul'daki bir cloud sunucudan (örn. AWS Frankfurt veya Türkiye yerel sağlayıcılar) Kunavo EU edge'e P50 gecikme yaklaşık 60 ms — Anthropic us-east-1'e doğrudan İstanbul'dan (P50 ~170 ms) erişimden çok daha hızlı ve stabil. Streaming yanıtlar upstream ile aynı time-to-first-token ile gelir — buffering yok, batching yok.
Ödeme yöntemleri — Türk kartları, uluslararası kartlar, banka transferi
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, Link (tek tıkla ödeme)
- Enterprise müşteriler Net 30 koşullarıyla fatura üzerinden ödeyebilir
Ö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. Kart sağlayıcınızın kur ve döviz işlem komisyonu uygulanır (genellikle %1-3 arası). Minimum yükleme $5 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.250 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 playbook.
KVKK ve veri yerleşimi
Routing mantığı edge'te stateless çalışır. Faturalandırma ve hesap verileri çoklu bölge replikasyonlu birincil bir bölgede 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, Enterprise sözleşmeler için talep üzerine etkinleştirdiğimiz Zero Data Retention seçenekleri sunar. KVKK uyumluluk değerlendirmesi ve veri işleme sözleşmesi için sales@kunavo.com'a yazı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. Slack/Discord üzerinden ayrılmış destek Scale planından itibaren mevcuttur.
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? Veri işleme sözleşmesi sales@kunavo.com üzerinden talep edilebilir.
- 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, $2 başlangıç kredisini alın 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.