Rispondo alle domande frequenti su come chiamare l’API Claude dal Giappone. Copro tutti i punti che gli sviluppatori vogliono verificare per primi: differenza di prezzo rispetto ad Anthropic ufficiale, pagamenti con carta JCB, latenza misurata da Tokyo e posizione delle informazioni sull’operatore ai sensi della legge giapponese sulle transazioni commerciali specificate.
La prima chiamata in 5 secondi
Kunavo è compatibile con il wire protocol di OpenAI, quindi se usi già l’SDK OpenAI la migrazione richiede solo di modificare una riga, quella di base_url. In Python:
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)Lo stesso vale per Node.js / TypeScript:
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);La registrazione è gratuita. Puoi ricaricare a partire da $10 e paghi a consumo (pay-as-you-go), senza scadenza del saldo. È sufficiente per provare Claude Opus 4.7, Sonnet 4.6 e Haiku 4.5.
Differenza di prezzo rispetto ad Anthropic ufficiale
I modelli Claude su Kunavo hanno uno sconto del 30% sui prezzi ufficiali Anthropic (a seconda del modello). Claude Sonnet 4.6 costa presso Anthropic $3,00 per l’input e $15,00 per l’output (per milione di token), mentre su Kunavo costa $2,10 per l’input e $10,50 per l’output (30% di sconto). Con il prompt caching, la lettura dalla cache costa il 10% della tariffa d’input: in pratica, puoi rileggere a $0,21/milione di token. I prezzi unitari di tutti i modelli sono pubblicati su /pricing.
Latenza da Tokyo
L’ingresso di Kunavo usa una rete edge anycast e termina TLS sul nodo più vicino. Il gateway principale opera in un’unica regione US-East (Ashburn, Virginia). L’edge riduce il round trip dell’handshake TLS, non il tratto attraverso il Pacifico: da Tokyo, il tempo di andata e ritorno è determinato dalla distanza fisica tra Tokyo e gli Stati Uniti orientali, a cui si aggiunge il tempo di inferenza del modello. Anche chiamando direttamente Anthropic us-east-1 si percorre lo stesso tratto. Lo streaming usa un passthrough SSE affinché il time-to-first-token sia equivalente a quello upstream.
Metodi di pagamento — JCB, Apple Pay, Google Pay
I pagamenti sono gestiti nativamente da Stripe. Metodi disponibili per i clienti in Giappone:
- Carta di credito / debito: JCB, Visa, Mastercard, American Express
- Apple Pay, Google Pay (se configurato in Chrome / Android), Link (pagamento con un clic)
I prezzi sono in dollari statunitensi, ma Stripe li converte automaticamente in yen giapponesi al checkout. Il tasso di conversione include una commissione del 2–4% a carico dell'acquirente (non si applica pagando in dollari statunitensi; documentazione di Stripe Adaptive Pricing, verificata il 2026-10-03). Non sono supportati bonifici bancari, pagamenti nei minimarket o PayPay. La ricarica minima è di $10 USD (circa 1.500 yen). Poiché non si tratta di un abbonamento ma di un portafoglio prepagato, il saldo inutilizzato non scade.
Informazioni ai sensi della legge giapponese sulle transazioni commerciali specificate
Le informazioni sull’operatore per i clienti giapponesi, le regole sui rimborsi, gli orari di servizio e altro sono raccolti in /legal/tokutei-shoutorihiki. La politica di base sui rimborsi è: “le ricariche consumate non sono rimborsabili, mentre il saldo inutilizzato viene rimborsato alla chiusura dell’account”. Le richieste fallite (4xx/5xx) non vengono mai addebitate.
Scelta dei modelli più utilizzati
- Claude Opus 4.7 — Massima capacità di ragionamento. Per attività complesse che richiedono la comprensione delle sfumature del giapponese, sintesi di contesti lunghi e generazione di codice.
- Claude Sonnet 4.6 — Equilibrio tra prezzo e capacità. È il modello più adottato dalle startup giapponesi. Può essere usato come modello principale per chatbot, generazione di contenuti e agenti.
- Claude Haiku 4.5 — Veloce ed economico. Per attività di classificazione, filtraggio, semplici sintesi e il pre-pass degli agenti. Costa circa un decimo di Sonnet.
Note specifiche sul giapponese
Claude offre una qualità degli input e degli output in giapponese equivalente a quella in inglese, ma tende a consumare circa il doppio dei token in giapponese (circa 0,5–0,8 token per carattere, contro circa 0,25 token per carattere in inglese). Tenetene conto nel calcolo dei costi.
Per specificare in modo affidabile quando usare il linguaggio onorifico o informale, indicatelo esplicitamente nel prompt di sistema:
«Sei un operatore del servizio clienti giapponese. Rispondi sempre con un linguaggio cortese e rispettoso e tratta i clienti con educazione.»
Come iniziare
Se fin qui non avete domande:
- Registratevi gratuitamente su /app/signup (ricarica a partire da $10, pagamento a consumo)
- Generate una chiave API su /app/keys
- Effettuate la prima chiamata usando lo snippet su /docs/quickstart
Per domande, scrivete a contact@kunavo.com. Risponderemo in giapponese entro 1 giorno lavorativo.