Comment obtenir une clé API Claude — parcours officiel et parcours via une passerelle

Il existe deux façons d’obtenir une clé API Claude. La voie officielle consiste à la créer directement dans la console Anthropic ; l’autre consiste à l’obtenir auprès d’une passerelle proposant un point de terminaison compatible avec Anthropic. Les deux appellent les mêmes modèles Claude ; dans le code, seuls le base URL et la chaîne de la clé diffèrent.

Nous présentons ci-dessous les deux voies et abordons également les problèmes de paiement qui surviennent particulièrement souvent en Corée du Sud.

Voie 1 — création directe dans la console Anthropic

Créez un compte Anthropic, enregistrez un moyen de paiement, puis générez une clé API dans la console. Cette voie est facturée aux tarifs officiels d’Anthropic et offre l’avantage de conserver la documentation officielle et le support.

En Corée du Sud, le blocage survient généralement à l’étape du paiement. Les cartes dont les paiements internationaux sont bloqués ne peuvent pas être enregistrées ; autorisez les paiements internationaux dans l’application de l’émetteur, puis réessayez.

Voie 2 — clé de passerelle

C’est un moyen d’appeler les modèles Claude sans compte Anthropic. Kunavo fournit à la fois l’API Anthropic Messages et une API compatible avec OpenAI ; il suffit donc de remplacer le base URL et la clé dans le code existant.

Ce parcours est également moins susceptible d’être bloqué à l’étape du paiement. Lorsque le paiement affiche des wons, le rechargement prépayé Kunavo propose KakaoPay, Naver Pay, PAYCO, Samsung Pay et les cartes nationales dont les paiements internationaux ne sont pas activés (Toss Pay n’est pas proposé). Le solde rechargé sert aux appels de l’API Claude et ne permet pas de payer un abonnement Anthropic.

# OpenAI SDK를 그대로 쓰면서 base_url만 바꾸는 방식.
# 코드에서 바뀌는 줄은 base_url 한 줄뿐입니다.
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key="sk-kn-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

Si votre code utilise le format natif Anthropic, définissez le base URL sur https://api.kunavo.com — dans ce cas, n’ajoutez pas /v1. La différence entre les deux formats est expliquée dans la documentation ANTHROPIC_BASE_URL.

Tarifs

Les tarifs sont lus dans le catalogue lors du rendu de la page ; ce document ne peut donc pas diverger du montant réellement facturé. Les informations détaillées sur les moyens de paiement et les cartes nationales figurent dans Prix et paiement de l’API Claude.

Vérification 30 secondes après la création

Après avoir obtenu la clé, effectuez immédiatement un appel. Cette vérification permet de déterminer rapidement si les erreurs ultérieures viennent ou non de la clé.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 200이 오면 키는 정상입니다.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕하세요"}]}'

Si vous recevez 200, la clé fonctionne. 401 indique généralement un type d’en-tête d’authentification incorrect ; 429 correspond à une limitation de débit et 529 à une surcharge en amont, sans rapport avec la clé. Les réponses à chaque erreur sont détaillées dans Guide des erreurs de Claude Code.

Séparer les clés

Il est plus sûr de séparer les clés par usage. La révocation de l’une n’affecte pas les autres, et vous pouvez définir une limite mensuelle d’utilisation pour chaque clé. La limite est vérifiée avant l’exécution de la requête et réinitialisée au début de chaque mois ; c’est particulièrement utile lorsque vous transmettez une clé à un agent non supervisé.

Questions fréquentes