Bloga dön
Rehber·24 Mayıs 2026·5 dk okuma

Japon geliştiriciler için Claude API başlangıç rehberi — ücretler, gecikme ve JCB ödemesi dahil

Tokyo'dan Claude API kullanımı için pratik rehber. Anthropic'in resmi hizmetiyle fiyat farkı, Tokyo'dan gecikme, JCB / Apple Pay / Google Pay desteği, Japonca token tüketimi ve Belirli Ticari İşlemler Yasası uyarınca işletmeci bilgileri.

Japonya'dan Claude API'yi çağırma hakkında sık sorulan soruları yanıtlıyoruz. Doğrudan Anthropic ile fiyat farkı, JCB kartıyla ödeme, Tokyo'dan ölçülen gerçek gecikme ve Japonya'daki belirli ticari işlemler yasası kapsamındaki işletme bilgilerinin konumu — geliştiricilerin önce kontrol etmek istediği tüm noktaları kapsıyoruz.

İlk çağrınız 5 saniyede

Kunavo, OpenAI wire protokolüyle uyumludur; hâlihazırda OpenAI SDK kullanıyorsanız geçiş yalnızca base_url satırını değiştirmekten ibarettir. Python'da:

quickstart.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",  # ここを変えるだけ
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "日本語で挨拶してください"}],
)
print(resp.choices[0].message.content)

Node.js / TypeScript'te de aynıdır:

quickstart.mjs
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: "東京の今日の天気を教えて" }],
});
console.log(resp.choices[0].message.content);

Kayıt ücretsizdir. 10 $'dan itibaren bakiye yükleyebilir, yalnızca kullandığınız kadar ödediğiniz kullanım başına ücretlendirme (pay-as-you-go) modeliyle çalışabilir ve bakiyenizin süresi dolmadığından emin olabilirsiniz. Claude Opus 4.7, Sonnet 4.6 ve Haiku 4.5'i denemek için yeterlidir.

Doğrudan Anthropic ile fiyat farkı

Kunavo'daki Claude modelleri, Anthropic'in resmi fiyatlarından modele bağlı olarak 30% indirim sunar. Claude Sonnet 4.6 için Anthropic'te giriş $3,00, çıkış $15,00 (1 milyon token başına) iken Kunavo'da giriş $2,10, çıkış $10,50 (30% indirim) olur. İstem önbelleğini kullanırsanız önbellek okuma, giriş ücretinin %10'udur — başka bir deyişle yeniden okuma 1 milyon token başına fiilen $0,21 tutarındadır. Tüm modellerin birim fiyatları /pricing adresinde yer alır.

Tokyo'dan gecikme

Kunavo'nun giriş noktası anycast uç ağını kullanır ve TLS, size en yakın düğümde sonlandırılır. Ağ geçidinin kendisi tek bir US-East bölgesinde (Ashburn, Virginia) çalışır. Uç ağının kısalttığı bölüm TLS el sıkışmasının gidiş-dönüşüdür; Pasifik'i aşan bölüm değildir — Tokyo'dan çağrı yaptığınızda gidiş-dönüş süresine Tokyo ile ABD'nin doğusu arasındaki fiziksel mesafe hâkim olur ve buna modelin kendi çıkarım süresi eklenir. Anthropic'in us-east-1 bölgesini doğrudan çağırmak da aynı mesafeyi kat eder. Akış, Time-to-first-token değerinin üst akışla eşdeğer olması için SSE pas geçişi olarak uygulanır.

Ödeme yöntemleri — JCB, Apple Pay, Google Pay

Ödemeler Stripe tabanlıdır. Japonya'daki müşterilerin kullanabileceği yöntemler:

  • Kredi / banka kartı: JCB, Visa, Mastercard, American Express
  • Apple Pay, Google Pay (Chrome / Android'de ayarlanmışsa), Link (tek tıklamayla ödeme)

Fiyatlar ABD doları cinsindendir, ancak Stripe ödeme sayfasında otomatik olarak Japon yenine dönüştürür. Bu dönüşüm kuru, alıcı tarafından ödenen %2–4 dönüşüm ücretini içerir (ABD doları olarak ödeme yaparsanız uygulanmaz; Stripe Adaptive Pricing belgeleri, 2026-10-03 tarihinde kontrol edildi). Banka havalesi, market ödemesi ve PayPay desteklenmez. Minimum yükleme $10 USD'dir (yaklaşık 1.500 yen). Bu bir abonelik değil, ön ödemeli cüzdan modelidir; kullanılmayan bakiye sona ermez.

Belirli ticari işlemler yasası kapsamındaki bilgiler

Japon müşterilere yönelik işletme bilgileri, iade politikası ve çalışma saatleri /legal/tokutei-shoutorihiki adresinde toplanmıştır. İadeler için temel politika şudur: “Tüketilmiş bakiyeler iade edilmez; kullanılmayan bakiye hesap kapatıldığında iade edilir.” Başarısız istekler (4xx/5xx) hiçbir zaman ücretlendirilmez.

Yaygın kullanım için model seçimi

  • Claude Opus 4.7 — En güçlü çıkarım yeteneği. Japonca nüansların anlaşılmasını gerektiren karmaşık görevler, uzun bağlam özetleme ve kod üretimi için.
  • Claude Sonnet 4.6 — Fiyat ve yetenek dengesi. Japonya'daki girişimler arasında en çok benimsenen modeldir. Sohbet botları, içerik üretimi ve ajanlar için ana model olarak kullanılabilir.
  • Claude Haiku 4.5 — Hızlı ve ekonomik. Sınıflandırma görevleri, filtreleme, basit özetler ve ajanların ön işleme aşaması için. Sonnet'in yaklaşık onda biri maliyetindedir.

Japoncaya özgü dikkat noktaları

Claude, Japonca giriş ve çıkışta İngilizceye eşdeğer kalite sunar; ancak token tüketimi Japoncada yaklaşık 2 kat daha yüksek olma eğilimindedir (karakter başına yaklaşık 0,5–0,8 token; İngilizcede karakter başına yaklaşık 0,25 token). Fiyat hesaplamalarında bunu dikkate alın.

Resmî ve samimi hitap biçimleri arasındaki seçimi sistem isteminde açıkça belirtmek en güvenilir yöntemdir:

“Siz Japonya'da müşteri destek temsilcisisiniz. Her zaman kibar Japonca (desu/masu üslubu) ile yanıt verin ve müşterilere karşı nazik davranın.”

Başlarken

Buraya kadar başka sorunuz yoksa:

  1. /app/signup adresinden ücretsiz kayıt olun (10 $'dan itibaren bakiye yükleme, kullanım başına ücretlendirme)
  2. /app/keys adresinden API anahtarı oluşturun
  3. İlk çağrınızı /docs/quickstart adresindeki parçacıkla yapın

Sorularınız için contact@kunavo.com adresine yazın. 1 iş günü içinde Japonca yanıt veririz.

İlgili derinlemesine yazılar