Claude API'yi üretimde çalıştırmak isteyen Brezilyalı geliştiriciler için pratik rehber. Doğrudan Anthropic'e kıyasla fiyat farkı, Pix ve kartla ödeme, São Paulo'dan gecikme, LGPD ve fatura — ilk çağrıdan önce önemli olan her şey.
İlk çağrı 5 saniyede
Kunavo, OpenAI wire protokolüyle uyumludur. Kodunuz zaten OpenAI SDK'sını kullanıyorsa geçiş, base_url üzerinde tek satırlık bir değişikliktir. Python'da:
from openai import OpenAI
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # só essa linha muda
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Se apresente brevemente em português."}],
)
print(resp.choices[0].message.content)Node.js / TypeScript'te de aynıdır:
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: "Resuma este artigo em 3 tópicos." }],
});
console.log(resp.choices[0].message.content);Kayıt ücretsizdir: $10'dan başlayan tutarla bakiye yüklersiniz, yalnızca kullandığınız kadar ödersiniz (kullandıkça öde) ve bakiyeniz hiçbir zaman sona ermez — Claude Opus 4.7, Sonnet 4.6 ve Haiku 4.5'i kapsamlı biçimde test etmek için yeterlidir.
Doğrudan Anthropic'e kıyasla fiyat farkı
Kunavo'daki Claude modelleri, modele bağlı olarak Anthropic'in resmî fiyatından 30 % daha ucuzdur. Claude Sonnet 4.6, doğrudan kullanımda 1 M token başına $3,00 giriş / $15,00 çıkış maliyetindedir — Kunavo'da: $2,10 / $10,50 (30 % daha düşük). Prompt caching ile sabit önekin yeniden okunması, giriş fiyatının %10'u üzerinden ücretlendirilir; yani 1 M token başına $0,21 olur. Her modelin tam fiyatları /pricing adresindedir.
São Paulo / Rio'dan gecikme
Kunavo, TLS'yi size yakın bir noktada sonlandıran anycast edge'in arkasında, tek bir US-East bölgesinde (Ashburn, Virginia) çalışır. Edge'in kısalttığı şey TLS el sıkışmasıdır; Amerika Birleşik Devletleri'ne geçiş mesafesi değildir: São Paulo, Rio veya Brasília'dan gidiş-dönüş süresini, modelin kendi çıkarım süresine ek olarak ABD'nin doğu kıyısına olan fiziksel mesafe belirler. Anthropic'e Brezilya'dan doğrudan çağrı da tam olarak aynı rotayı izler.
Streaming yanıtları upstream ile aynı time-to-first-token süresiyle gelir — buffering veya batching yoktur. Gerçek zamanlı müşteri hizmetleri ve konuşma ajanları gibi gecikmeye duyarlı görevlerde bu büyük fark yaratır.
Ödeme — Pix ve uluslararası kart
Stripe'ı doğrudan kullanıyoruz. Brezilya'daki müşteriler için:
- Pix (anında ödeme, tutar real cinsinden gösterilir) — uluslararası kredi kartı gerektirmez
- Uluslararası kartlar: Visa, Mastercard, American Express
- Apple Pay, Google Pay ve Link
Boleto kullanılamaz; aynı durum ödeme sayfamızda görünmeyen yerel kart ağları Elo ve Hipercard için de geçerlidir. Brezilya'da düzenlenen kartların uluslararası alışverişlere açık olması gerekir — kartınız reddedilirse bunu banka uygulamasından kontrol edin veya buna bağlı olmayan Pix ile ödeme yapın.
Fiyatlar USD cinsinden belirlenir; Stripe ödeme sayfasında BRL'ye dönüştürür. Dönüşümde Stripe'ın o andaki döviz kuru kullanılır; bu kur, alıcı tarafından ödenen %2–4 dönüşüm ücretini zaten içerir (Stripe Adaptive Pricing belgeleri, 2026-10-03 tarihinde incelenmiştir). Minimum yükleme $10 USD'dir. Abonelik yoktur; bu, bakiyesi asla sona ermeyen ön ödemeli bir cüzdandır.
IOF, Vergiler ve Fatura
Uluslararası kredi kartıyla yapılan işlemlerde IOF vergisi uygulanır (şu anda %3,5 — güncel oranı kontrol edin); Pix işlemlerinde de aynı vergi geçerlidir. Stripe'a göre Brezilya'daki bir müşteri yurt dışındaki bir şirkete ödeme yaptığında IOF uygulanır ve tutar banka uygulamasında ödemeye eklenmiş olarak görünür. Pix ile bakiye yükleme adımlarının tamamı Pix ile API ödeme kılavuzu'nda açıklanmıştır. Kunavo, Brezilya'da geçerli vergi faturası veya fatura düzenlemez; ödeme sayfası mali belge oluşturmaz. Tarih, tutar ve durum bilgilerini içeren yükleme geçmişi faturalandırma panonuzda bulunur. Muhasebe için bir ödeme belgesine ihtiyacınız varsa contact@kunavo.com adresine yazın.
LGPD ve Veri Yerleşimi
Yönlendirme mantığı edge anycast'te değil, TLS'yi yalnızca sonlandıran edge anycast yerine tek bölge olan US-East'teki (Ashburn) gateway'de çalışır. Faturalandırma ve hesap verileri, hacmin günlük şifreli anlık görüntüleriyle birlikte tek bir birincil veritabanında saklanır. İstekleri upstream sağlayıcılara iletiriz — failover sağlayıcıyı değiştirir, modeli asla değiştirmez — ve bu sağlayıcılar istem içeriğini kendi koşullarına göre işler. Kunavo veri işleme sözleşmesi (DPA), Zero Data Retention veya ABD dışı veri yerleşimi sunmaz: istekler Amerika Birleşik Devletleri'nde işlenir ve upstream sağlayıcılara iletilir. Ekibinizin DPA, ZDR veya Brezilya ya da AB'de veri yerleşimine ihtiyacı varsa model sağlayıcısıyla doğrudan sözleşme yapın (Anthropic, OpenAI veya Google'ın kurumsal koşulları).
Portekizce destek
Ekibimiz contact@kunavo.com adresine Portekizce gönderilen e-postaları bir iş günü içinde yanıtlar.
Sık sorulan sorular
- Pix çalışıyor mu? Evet, Stripe ödeme sayfası üzerinden. Ödeme yöntemi olarak "Pix"i seçin.
- IOF ödemem gerekiyor mu? Yalnızca uluslararası kredi kartında. Pix'te hayır.
- BRL cinsinden vergi faturası mı? Hayır — Kunavo NF-e veya fatura düzenlemez. Yüklemeler için bir makbuz almak üzere contact@kunavo.com adresine yazın.
- LGPD uyumluluğu ve DPA mı? Kunavo DPA sunmaz ve istekler ABD'de işlenir. Bir DPA'ya ihtiyacınız varsa model sağlayıcısıyla (Anthropic, OpenAI veya Google) doğrudan sözleşme yapın.
- Brezilya modeli / Sabiá var mı? Henüz katalogda yok — /models sayfasına bakın ve değişiklik günlüğüne abone olun.
Başlamaya hazır mısınız? Ücretsiz kaydolun, $10'dan başlayarak bakiye yükleyin ve ilk Claude çağrınızı beş dakika içinde yapın. Brezilya'dan sorularınız mı var? Doğrudan contact@kunavo.com adresine yazın — Portekizce yanıtlarız.