Documentation
Clé API Anthropic (Claude)
Créez une clé API Claude d’Anthropic sur platform.claude.com, sous Settings → API keys : la clé commence par sk-ant- et ne s’affiche qu’une seule fois. Une clé Kunavo donne accès aux mêmes modèles Claude via le SDK OpenAI ou la Messages API native, sans compte Anthropic.
Pour obtenir une clé API Claude d’Anthropic, connectez-vous à la console Claude sur platform.claude.com, ouvrez Settings → API keys, puis cliquez sur Create Key. Une clé API Anthropic commence par sk-ant- et ne s’affiche qu’une seule fois lors de sa création. La console Anthropic a été déplacée de console.anthropic.com vers platform.claude.com, et la page des clés se trouve désormais à platform.claude.com/settings/keys. Une clé API Anthropic authentifie les requêtes vers https://api.anthropic.com avec l’en-tête x-api-key et un en-tête anthropic-version, et non avec Authorization: Bearer. La FAQ tarifaire d’Anthropic indique que les nouveaux utilisateurs reçoivent une petite quantité de crédits gratuits pour tester l’API ; aucune offre gratuite n’est disponible au-delà de ce crédit, et l’utilisation de l’API Claude est donc facturée par jeton une fois les crédits initiaux épuisés.
Kunavo est une passerelle indépendante d’API IA compatible avec OpenAI : une seule clé API et un solde à l’usage vous donnent accès à Claude, GPT ainsi qu’à des modèles d’image, de vidéo et d’audio, sans compte par fournisseur. Une clé API Kunavo commence par sk-kn-, se crée à l’adresse kunavo.com/app/keys et ne nécessite aucun compte Anthropic. Kunavo donne accès à Claude via le point de terminaison compatible avec OpenAI https://api.kunavo.com/v1/chat/completions et le point de terminaison Anthropic natif https://api.kunavo.com/v1/messages ; le SDK officiel OpenAI permet donc d’appeler Claude en ne modifiant que base_url. Kunavo est facturé à l’usage à partir d’un rechargement minimum de 10 $ et n’accorde aucun crédit gratuit aux nouveaux comptes.
Option A — une clé API directement auprès d’Anthropic
Une clé de la console Anthropic est le bon choix si le projet n’appellera que Claude. Anthropic facture cette clé par jeton et prend en charge chaque fonctionnalité de Claude dès sa sortie.
- Rendez-vous sur
platform.claude.comet connectez-vous. L’ancienne adresse console.anthropic.com redirige désormais vers la même console. - Ouvrez Settings → API keys (lien direct :
platform.claude.com/settings/keys) et cliquez sur Create Key. Les clés Anthropic commencent parsk-ant-...et ne s’affichent qu’une seule fois. - Ajoutez un moyen de paiement sous Facturation. Anthropic accorde une petite quantité de crédits gratuits aux nouveaux utilisateurs, puis facture à l’usage des jetons.
- Envoyez la clé dans l’en-tête
x-api-key, avec un en-têteanthropic-version.
# Anthropic direct — x-api-key, not Bearer
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'Conséquence à prévoir : une clé Anthropic donne accès uniquement à Claude. Un projet qui appelle aussi des modèles GPT, d’image ou de vidéo nécessite un compte, une clé, un SDK et une facture distincts pour chaque fournisseur.
Option B — une seule clé Kunavo pour Claude et tout le reste
Kunavo donne accès à Claude via une API compatible avec OpenAI et la Messages API native d’Anthropic. Une seule clé sk-kn- donne accès à Claude et à tous les autres modèles du catalogue, avec un seul solde approvisionné par Stripe, sans compte Anthropic.
| Clé de la console Anthropic | Clé Kunavo | |
|---|---|---|
| Modèles | Claude uniquement | Claude, GPT, modèles d’image, de vidéo et d’audio |
| Point de terminaison | api. | api. |
| APIs | Messages API | API compatible avec OpenAI + Messages API |
| En-tête d’authentification | x-api-key | Authorization: Bearer |
| Compte fournisseur | Compte Anthropic requis | Aucun requis |
| Facturation | Anthropic, par jeton | Un seul solde approvisionné par Stripe |
| Format de clé | sk-ant-... | sk-kn-... |
- Créez un compte Kunavo et effectuez un rechargement de 10 $. Kunavo est facturé à l’usage et le solde n’expire jamais.
- Générez une clé à l’adresse
/app/keys. Une clé Kunavo ne s’affiche qu’une seule fois ; enregistrez-la dans une variable d’environnement. - Configurez le SDK OpenAI avec
https://api.kunavo.com/v1et appelez un identifiant de modèle Claude.
Clé API Claude ou clé API Anthropic
Une « clé API Anthropic » et une « clé API Claude » désignent le même identifiant d’accès sous deux appellations. Anthropic est l’entreprise, Claude la famille de modèles, et la clé créée dans la console Claude authentifie les appels à l’API Claude. La différence entre les deux clés ci-dessous tient à leur provenance et aux modèles auxquels chacune donne accès :
- Clé de la console Anthropic (
sk-ant-...) — créée à l’adresseplatform.claude.com/settings/keys. Une clé de la console Anthropic appelle uniquement Claude et Anthropic la facture par jeton. - Clé Kunavo (
sk-kn-...) — créée à l’adressekunavo.com/app/keys. Une clé Kunavo appelle les mêmes modèles Claude via le SDK OpenAI ou la Messages API native, ainsi que les modèles GPT, d’image, de vidéo et d’audio, à partir d’un seul solde approvisionné par Stripe et sans compte Anthropic.
Appeler Claude avec Python
Conservez le SDK officiel OpenAI. La migration consiste entièrement à modifier base_url et le nom du modèle.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1", # the only line that changes
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)Appeler Claude avec Node.js
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-sonnet-5",
messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);Ou appeler Claude avec curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'/v1/messages — consultez la référence de la Messages API.La clé API Claude ne fonctionne pas
Une clé API Claude qui renvoie 401 authentication_error s’explique presque toujours par l’une de ces cinq causes : un en-tête incorrect pour le point de terminaison, une clé envoyée à un point de terminaison auquel elle n’est pas destinée, des espaces blancs ou des guillemets ajoutés par erreur à la variable d’environnement, une clé révoquée ou une URL de base incorrecte pour cette clé.
La cause la plus fréquente est une incompatibilité d’en-tête. L’API native d’Anthropic attend x-api-key et anthropic-version. Les points de terminaison compatibles avec OpenAI, notamment ceux de Kunavo, attendent Authorization: Bearer. Une clé sk-ant- fonctionne uniquement avec api.anthropic.com, et une clé sk-kn- uniquement avec api.kunavo.com.
| Symptôme | Cause probable | Correctif |
|---|---|---|
401 unauthorized | Clé incorrecte ou révoquée, ou transmise avec un en-tête inadapté au point de terminaison | Recréez la clé à l’adresse /app/keys et transmettez-la avec Authorization: Bearer sk-kn-… |
402 insufficient_ | Solde épuisé ou plafond de dépenses de la clé atteint | Rechargez le solde ou augmentez le plafond de cette clé |
model not found | Identifiant de modèle incorrect | Utilisez un identifiant exact, comme claude-sonnet-5 ; consultez /models |
429 rate limit | Trop de requêtes en peu de temps | Attendez, puis réessayez en augmentant progressivement le délai |
Chaque erreur ci-dessous fait l’objet d’une analyse détaillée présentant le JSON d’erreur exact, toutes les causes connues et des correctifs prêts à copier-coller : 401 invalid api key, 429 rate_limit_error, solde de crédits insuffisant / 402, 529 overloaded et model_not_found.
Utiliser l’API Claude sans carte de crédit
Anthropic accepte les principales cartes de crédit pour les comptes API Claude standard et réserve la facturation sur facture aux entreprises ; en pratique, une carte est donc nécessaire pour utiliser directement le service.
Un solde Kunavo peut être approvisionné sans aucune carte par l’un des moyens suivants : ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo facture les rechargements en USD et Stripe effectue la conversion sur la page de paiement ; un acheteur brésilien peut ainsi scanner un code Pix et payer un montant en réais, sans avoir à chercher une carte autorisée pour les achats internationaux. Les portefeuilles approvisionnés par carte sont également disponibles, mais sont volontairement exclus de cette liste, car un portefeuille reposant sur une carte ne répond pas à la question. La liste complète des moyens de paiement figure dans la référence de facturation.
Quel modèle Claude utiliser
- claude-haiku-4-5 — le moins cher et le plus rapide, pour la classification et l’assistance à grand volume. Kunavo facture Claude Haiku 4.5 $0.70 par 1M jetons d’entrée et $3.50 par 1M jetons de sortie.
- claude-sonnet-5 — le modèle polyvalent par défaut pour la plupart des tâches de raisonnement, de récupération d’informations et de programmation : le Sonnet le plus récent, proche d’Opus pour la programmation et les tâches agentiques. Kunavo facture Claude Sonnet 5 $1.40 / $7.00 par 1M jetons, contre $2.00 / $10.00 au tarif catalogue d’Anthropic.
- claude-sonnet-4-6 — le Sonnet précédent, pour les prompts déjà optimisés pour ce modèle. Kunavo facture Claude Sonnet 4.6 $2.10 / $10.50 par 1M jetons.
- claude-opus-5 — pour les tâches de raisonnement intensif et les contextes longs. Kunavo facture Claude Opus 5 $3.50 / $17.50 par 1M jetons, contre $5.00 / $25.00 au tarif catalogue d’Anthropic.
- claude-fable-5 — le modèle le plus performant d’Anthropic, destiné aux raisonnements de pointe et aux agents à long horizon ; publié le 1er septembre 2026. Kunavo le facture $7.00 / $35.00 par 1M jetons, contre $10.00 / $50.00 au tarif catalogue d’Anthropic. La version précédente, claude-fable-5, est toujours proposée au même tarif.
Liste de contrôle de sécurité des clés API
- N’exposez jamais une clé API côté client. Faites transiter chaque appel par un serveur que vous contrôlez.
- Utilisez une clé API par projet ou environnement afin de pouvoir révoquer une clé divulguée sans interrompre tout le reste.
- Renouvelez les clés API chaque trimestre. Kunavo permet d’avoir plusieurs clés actives à la fois, ce qui offre une période de chevauchement sans interruption lors du renouvellement.
FAQ
Comment obtenir une clé API Claude d’Anthropic ?
Pour obtenir une clé API Claude d’Anthropic, connectez-vous à la console Claude sur platform.claude.com, ouvrez Settings → API keys, puis cliquez sur Create Key. Une clé API Anthropic commence par sk-ant- et n’est affichée qu’une seule fois lors de sa création ; vous devez donc la copier et l’enregistrer à ce moment-là. La console Anthropic a été déplacée de console.anthropic.com vers platform.claude.com, et la page des clés se trouve à platform.claude.com/settings/keys. Une clé API Anthropic authentifie les requêtes vers https://api.anthropic.com à l’aide de l’en-tête x-api-key accompagné d’un en-tête anthropic-version, et non d’un en-tête Authorization: Bearer.
Une clé API Anthropic est-elle la même chose qu’une clé API Claude ?
Une clé API Anthropic et une clé API Claude désignent le même identifiant d’accès sous deux appellations. Anthropic est le nom de l’entreprise, Claude celui de la famille de modèles, et la clé créée dans la console Claude authentifie les appels à l’API Claude. Une clé API Kunavo (sk-kn-...) est un identifiant différent, fourni par une autre entreprise, qui donne accès aux mêmes modèles Claude, ainsi qu’aux modèles GPT et aux modèles multimédias, via un seul point de terminaison compatible avec OpenAI.
L’API Claude est-elle gratuite ?
L’API Claude n’est pas gratuite de façon continue. La FAQ tarifaire d’Anthropic indique que les nouveaux utilisateurs reçoivent une petite quantité de crédits gratuits pour tester l’API ; Anthropic ne précise pas le montant de ces crédits et ne propose aucune offre gratuite au-delà. L’utilisation de l’API Claude est donc facturée par jeton une fois les crédits initiaux épuisés. Kunavo n’offre pas non plus de crédits gratuits aux nouveaux comptes : un compte Kunavo nécessite un premier rechargement minimum de 10 $, le solde n’expire jamais et les appels 4xx et 5xx ayant échoué ne sont jamais facturés.
Pourquoi ma clé API Claude ne fonctionne-t-elle pas ?
Une clé API Claude qui renvoie 401 authentication_error s’explique presque toujours par l’une de ces cinq causes : un en-tête incorrect pour le point de terminaison, une clé envoyée à un point de terminaison auquel elle n’est pas destinée, des espaces blancs ou des guillemets ajoutés par erreur à la variable d’environnement, une clé révoquée ou une URL de base incorrecte. L’API native d’Anthropic à api.anthropic.com attend x-api-key avec anthropic-version ; les points de terminaison compatibles avec OpenAI attendent Authorization: Bearer. Une clé sk-ant- fonctionne uniquement avec api.anthropic.com, et une clé Kunavo sk-kn- uniquement avec api.kunavo.com.
Puis-je utiliser l’API Claude sans carte de crédit ?
Anthropic accepte les principales cartes de crédit pour les comptes API Claude standard et réserve la facturation sur facture aux entreprises ; en pratique, une carte est donc nécessaire pour utiliser directement le service. Kunavo peut être approvisionné sans carte par plusieurs moyens : ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo facture les rechargements en USD et Stripe effectue la conversion sur la page de paiement ; un acheteur brésilien peut ainsi régler un prix en dollars en réais. Aucune des deux options ne propose un accès gratuit continu : utiliser Claude implique de payer les jetons dans les deux cas.
Puis-je appeler Claude avec le SDK OpenAI ?
Il est possible d’appeler Claude avec le SDK officiel OpenAI via le point de terminaison Kunavo compatible avec OpenAI. Configurez base_url du SDK OpenAI sur https://api.kunavo.com/v1, transmettez une clé Kunavo comme jeton porteur et définissez le modèle sur un identifiant Claude tel que claude-sonnet-5. L’API d’Anthropic à api.anthropic.com n’accepte pas les requêtes de complétion de chat au format OpenAI ; pour appeler Claude directement, il faut donc utiliser le SDK Anthropic ou la Messages API native.
Quelle est la différence entre une clé API Anthropic et une clé API Kunavo ?
Une clé API Anthropic appelle uniquement les modèles Claude et est facturée par Anthropic. Une clé API Kunavo appelle Claude ainsi que les modèles GPT, image, vidéo et audio via une seule API compatible avec OpenAI ; la facturation est regroupée sur un seul solde approvisionné par Stripe. Une clé API Anthropic nécessite un compte Anthropic ; une clé API Kunavo n’en nécessite pas.
Par quel modèle Claude commencer ?
Commencez avec claude-sonnet-5, le modèle polyvalent par défaut pour la plupart des tâches de raisonnement, de récupération d’informations et de programmation. Passez à claude-haiku-4-5 pour la classification et l’assistance à grand volume à faible coût. Utilisez claude-opus-5 pour les raisonnements difficiles, et choisissez claude-fable-5, le modèle le plus performant d’Anthropic, uniquement pour les raisonnements de pointe et les agents à long horizon.
Combien coûte l’API Claude ?
Anthropic facture l’API Claude par jeton, à des tarifs qui varient selon la gamme du modèle : Claude Haiku 4.5 est le moins cher et Claude Fable 5 le plus cher. Kunavo propose les mêmes modèles Claude à un tarif inférieur au prix catalogue d’Anthropic pour chacun d’eux : Claude Opus 5 coûte $3.50 / $17.50 par 1M jetons contre $5.00 / $25.00 chez Anthropic, Claude Haiku 4.5 coûte $0.70 / $3.50 contre $1.00 / $5.00 chez Anthropic, et Claude Sonnet 5 coûte $1.40 / $7.00 contre le tarif de lancement de $2.00 / $10.00 qu’Anthropic a adopté comme tarif standard permanent le 31 août 2026.
Kunavo fait-elle partie d’Anthropic ?
Kunavo est une passerelle indépendante qui revend l’accès à ces modèles. Kunavo n’est ni Anthropic, ni Google, ni OpenAI, et Kunavo n’entraîne ni n’héberge les modèles proposés.
Ce qu’est Kunavo et ce que Kunavo n’est pas
Kunavo est une passerelle indépendante d’API IA compatible avec OpenAI : une seule clé API et un solde à l’usage vous donnent accès à Claude, GPT ainsi qu’à des modèles d’image, de vidéo et d’audio, sans compte par fournisseur.
Kunavo est une passerelle indépendante qui revend l’accès à ces modèles. Kunavo n’est ni Anthropic, ni Google, ni OpenAI, et Kunavo n’entraîne ni n’héberge les modèles proposés.
La documentation officielle d’Anthropic sur platform.claude.com fait autorité pour les produits, les tarifs et les politiques d’Anthropic. Cette page reprend la procédure publiée par Anthropic, indique la date de vérification de chaque affirmation et présente à côté l’alternative Kunavo.