Démarrer avec l’API Claude en Corée — passage au SDK OpenAI, latence à Séoul et tokens coréens

Réponses en une fois aux questions les plus fréquentes des développeurs coréens utilisant l’API Claude : tarifs par rapport au siège d’Anthropic, latence mesurée depuis Séoul, possibilité de payer avec une carte coréenne et migration depuis l’OpenAI SDK en ne modifiant qu’une ligne.

Premier appel en 5 secondes

Kunavo est compatible à 100 % avec le protocole de communication d’OpenAI. Si vous utilisez déjà le SDK OpenAI, la migration ne nécessite que de modifier une seule ligne, celle de base_url. Exemple 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)

Node.js / TypeScript fonctionne de la même manière :

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);

L’inscription est gratuite, puis vous payez uniquement ce que vous utilisez selon un modèle à l’usage (pay-as-you-go) à partir de $10 ; le solde n’expire pas. Vous pouvez tester suffisamment Claude Opus 4.7, Sonnet 4.6 et Haiku 4.5. Avec une seule clé compatible OpenAI, vous pouvez appeler non seulement Claude, mais aussi Gemini, GPT et les modèles d’image et de vidéo.

Différence de tarifs par rapport au siège — coût de l’API Claude

Kunavo propose les modèles Claude à des tarifs 30 % moins chers que les tarifs officiels d’Anthropic. Claude Sonnet 4.6 coûte au siège $3.00 en entrée et $15.00 en sortie (par million de tokens), contre $2.10 en entrée et $10.50 en sortie chez Kunavo (environ 30 % de réduction). Avec la mise en cache des prompts, les lectures du cache coûtent 10 % du tarif d’entrée — soit une relecture effective à $0.21/million de tokens. Consultez Tarifs et paiements de l’API Claude et la page des tarifs pour les prix complets par modèle et les moyens de paiement.

Latence depuis Séoul

L’entrée de Kunavo est un réseau edge anycast et TLS est terminé sur le nœud le plus proche. La passerelle elle-même s’exécute dans une seule région US-East (Ashburn, Virginie). L’edge réduit les allers-retours de la négociation TLS, pas le trajet transpacifique — depuis Séoul, le temps aller-retour est dominé par la distance physique entre Séoul et l’est des États-Unis, auquel s’ajoute le temps d’inférence du modèle. Un appel direct vers us-east-1 d’Anthropic traverse le même trajet. Le streaming utilise un relais SSE ; le Time-to-first-token est donc identique à celui de l’amont.

Paiement — cartes coréennes, KakaoPay ?

Les paiements sont traités par Stripe. Méthodes disponibles pour les clients coréens :

• Cartes de crédit / débit : Visa, Mastercard, American Express, JCB
• Apple Pay, Google Pay (lorsqu’ils sont configurés dans Chrome·Android), Link (paiement en un clic)
• Lorsque le paiement affiche des wons sud-coréens : KakaoPay, Naver Pay, PAYCO, Samsung Pay, cartes nationales

Les prix sont fixés en dollars américains ($USD), que Stripe convertit automatiquement en wons lors du paiement. Ce taux de conversion inclut des frais de change de 2–4 % à la charge de l’acheteur, qui ne s’appliquent pas si vous payez en dollars (documentation de Stripe Adaptive Pricing, consultée le 2026-10-03). Le montant minimum du rechargement est de $10 USD (environ 14 000 wons). Comme il s’agit d’un portefeuille prépayé et non d’un abonnement, le solde inutilisé n’expire pas.

KakaoPay apparaît comme moyen de paiement pour recharger Kunavo, mais Toss n’est pas pris en charge. KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales apparaissent uniquement lorsque le paiement affiche des wons ; dans ce parcours, les cartes nationales n’ont pas besoin d’autoriser les paiements internationaux. Pour payer en dollars, vous avez besoin d’une carte autorisant les paiements internationaux (si ceux-ci sont bloqués, vous devez les débloquer dans l’application de l’émetteur). Ces moyens servent à recharger le solde Kunavo ; il ne s’agit pas de paiements directs à Anthropic.

Coût des tokens en coréen

Claude offre une qualité équivalente en entrée et sortie coréennes et anglaises. Toutefois, le coréen consomme environ 1,5 à 2 fois plus de tokens que l’anglais (environ 0,5 à 0,7 token par caractère). Tenez-en compte dans le calcul des coûts.

Le plus fiable est de préciser la distinction entre langage honorifique et informel dans le prompt système :

« Vous êtes chargé du support client en Corée. Rédigez obligatoirement toutes vos réponses en langage honorifique (-습니다/-입니다) et répondez aux clients avec politesse et amabilité. »

Guide de sélection des modèles

• Claude Opus 4.7 — Les meilleures capacités de raisonnement. Adapté aux tâches complexes nécessitant de comprendre les nuances du coréen, au résumé de longs contextes et à la génération de code.
• Claude Sonnet 4.6 — Équilibre entre prix et capacités. Le modèle le plus adopté par les startups coréennes. Adapté aux chatbots, à la génération de contenu et comme modèle principal d’un agent.
• Claude Haiku 4.5 — Rapide et économique. Pour la classification, le filtrage, les résumés simples et le prétraitement des agents. Environ 1/10 du coût de Sonnet.

Étapes suivantes

1. S’inscrire gratuitement — Recharge à partir de $10, paiement à l’usage, solde sans expiration
2. Créer une clé API compatible OpenAI — Modifiez uniquement base_url et conservez votre OpenAI SDK
3. Effectuer votre premier appel avec Chat completions — Claude, Gemini et GPT partagent le même endpoint
4. Voir les tarifs de l’API Claude · Récapitulatif des moyens de paiement · Comparaison des alternatives à OpenRouter

Envoyez vos questions à contact@kunavo.com. Nous répondons sous 1 jour ouvré.