Passer au contenu principal

Connecter votre clé API Anthropic (Claude)

Créez une clé API Claude, connectez-la sur la page Clé API, puis remplacez-la ou supprimez-la quand vous le souhaitez.

Connecter votre clé API Anthropic (Claude)

Olvio répond à vos acheteurs avec les modèles Claude d'Anthropic, en utilisant votre propre clé API Anthropic. Anthropic facture directement votre compte Anthropic pour les requêtes qu'Olvio effectue avec cette clé, indépendamment de votre forfait Olvio.

La page Clé API apparaît dans le menu de l'application une fois que vous avez choisi un forfait. Si le guide de configuration est encore affiché sur le Tableau de bord (cliquez sur Olvio dans le menu de l'application), son étape Ajoutez votre clé API Anthropic renvoie vers la page avec Ajouter la clé. Une fois une clé enregistrée, l'étape est cochée et son bouton devient Gérer la clé.

Créer une clé dans la Claude Console

  1. Rendez-vous sur la Claude Console et connectez-vous, ou créez un compte Anthropic. L'adresse console.anthropic.com indiquée dans Olvio ouvre la même console.

  2. Ouvrez Settings → API keys et cliquez sur Create key. Si Create key est désactivé, demandez à un administrateur de l'organisation de modifier votre rôle ou de créer une clé de compte de service pour Olvio.

  3. Donnez à la clé un nom facile à reconnaître, par exemple Olvio, et choisissez sa durée de validité. Celle-ci ne peut plus être modifiée une fois la clé créée, et Olvio ne peut plus répondre aux acheteurs dès que la clé expire : choisissez donc une durée longue, ou Never si votre organisation l'autorise.

  4. Renseignez Linked account. Une clé personnelle, liée à vous, cesse de fonctionner si vous perdez l'accès à votre organisation Anthropic ou au workspace de la clé, par exemple lorsque vous quittez l'entreprise. Anthropic recommande un compte de service pour les services en production comme Olvio, et une clé de compte de service continue de fonctionner quand une personne s'en va. C'est un administrateur de l'organisation qui crée les comptes de service dans la Claude Console. Une clé de compte de service cesse de fonctionner si le compte de service est archivé ou retiré du workspace de la clé.

  5. Limitez la clé à un seul workspace lors de sa création, même si votre organisation n'en compte qu'un. Les requêtes d'Olvio ne précisent aucun workspace : Anthropic refuse donc toute requête faite avec une clé qui n'est pas limitée à un workspace.

  6. Copiez la clé et conservez-la en lieu sûr. Elle commence par sk-ant-. La Claude Console ne l'affiche qu'une seule fois, au moment de sa création. Si vous la perdez, créez une nouvelle clé.

Si vous donnez une date d'expiration à la clé, remplacez-la dans Olvio avant cette date. Anthropic rejette une clé expirée, et Olvio ne peut plus répondre aux acheteurs tant que vous n'en avez pas connecté une nouvelle. Anthropic envoie un e-mail au créateur de la clé avant son expiration, sauf si la clé a été créée avec une durée de validité inférieure à 7 jours.

Sauf si Anthropic facture votre organisation mensuellement, l'utilisation de l'API Claude se paie avec des crédits prépayés. Avant d'enregistrer la clé dans Olvio, vérifiez que votre organisation dispose de crédits. Si ce n'est pas le cas, connectez-vous à la Claude Console avec un rôle Admin ou Billing, ouvrez Settings → Billing et cliquez sur Buy credits. Sans crédits, Anthropic refuse la requête de test d'Olvio et la clé ne peut pas être enregistrée. Pour éviter que votre solde ne tombe à zéro, cliquez sur Edit dans la section Auto-reload et activez l'option.

Connecter la clé dans Olvio

  1. Dans l'administration Olvio, ouvrez Clé API.

  2. Dans la section Configuration Anthropic, collez la clé dans le champ Clé API.

  3. Vérifiez le Modèle Claude. Les nouvelles boutiques démarrent avec Claude Haiku 4.5 — le plus rapide, coût le plus bas (recommandé).

  4. Cliquez sur Enregistrer dans la barre d'enregistrement.

Avant l'enregistrement, Olvio supprime les espaces, les sauts de ligne, les caractères invisibles et les guillemets typographiques, et remplace les tirets longs par des traits d'union. Ces caractères peuvent se glisser quand une clé est copiée depuis un document mis en forme. Olvio vérifie ensuite la clé en envoyant à Anthropic une toute petite requête de test avec le modèle sélectionné, qu'Anthropic facture comme n'importe quelle autre requête.

Si la vérification réussit, Olvio chiffre et enregistre la clé. Le message Paramètres enregistrés s'affiche, le champ se vide et le badge Statut passe de Non configurée à Connectée. Connectée signifie seulement qu'une clé est enregistrée. La page ne revérifie pas la clé auprès d'Anthropic : le badge affiche donc toujours Connectée si la clé expire par la suite, si votre solde de crédits est épuisé ou si votre limite de dépenses Anthropic est atteinte. Abandonner efface ce que vous avez saisi et rétablit le modèle enregistré.

Si l'enregistrement échoue

Quand une vérification échoue, rien n'est enregistré et Olvio affiche brièvement un message d'erreur en bas de la page. S'il disparaît avant que vous ayez pu le lire, cliquez de nouveau sur Enregistrer dans la barre d'enregistrement. Parmi les messages possibles :

  • Invalid Anthropic key… Anthropic n'a pas accepté la clé, par exemple parce qu'elle est mal saisie, incomplète, désactivée ou expirée. Collez-la de nouveau depuis l'endroit où vous l'avez conservée, ou créez une nouvelle clé dans la Claude Console.

  • The key doesn't look like an Anthropic API key… Ce que vous avez collé ne commence pas par sk-ant-, est beaucoup trop court ou contient des caractères inattendus. Collez la clé de nouveau en texte brut, sans la faire passer par Word, Notion ou un e-mail mis en forme.

  • Anthropic rejected this model… Le modèle n'est pas toujours en cause. Quand le message donne une raison après les deux-points, lisez-la : s'il s'agit d'une limite de dépenses, de votre solde de crédits ou d'une clé qui n'est pas limitée à un seul workspace, corrigez-le dans la Claude Console. Changer de modèle n'aidera pas dans ce cas.

Pour les autres messages et les solutions pas à pas, consultez Erreur « Invalid Anthropic key » à l'enregistrement.

Choisir votre modèle Claude

Le menu Modèle Claude propose trois modèles : Claude Haiku 4.5 — le plus rapide, coût le plus bas (recommandé), Claude Sonnet 5 — équilibre qualité + coût et Claude Opus 5 — meilleure qualité, coût le plus élevé. Comme l'indique la page, le modèle sélectionné est utilisé pour chaque conversation, suggestion et tour de l'advisor. Anthropic facture chaque requête au tarif du modèle utilisé ; consultez les tarifs d'Anthropic.

Pour changer de modèle, sélectionnez-en un autre et cliquez sur Enregistrer. Olvio vérifie d'abord votre clé enregistrée avec le nouveau modèle : vous n'avez donc pas besoin de recoller la clé. Si aucune clé n'est encore enregistrée, collez-en une avant d'enregistrer. Pour choisir un modèle et voir à quoi il sert, consultez Choisir votre modèle Claude.

Définir une limite de dépenses

Anthropic vous permet de plafonner vos dépenses API mensuelles, ce qui vous protège si une période chargée amène plus de conversations que prévu.

  1. Dans la Claude Console, allez dans Settings → Billing.

  2. Dans la section Spend limits, cliquez sur Set limit, ou sur Adjust limit si vous en avez déjà une.

  3. Saisissez le montant maximal que vous souhaitez dépenser.

Lorsque votre utilisation atteint la limite, Anthropic refuse les nouvelles requêtes jusqu'à la date qu'il indique, ou jusqu'à ce que vous augmentiez ou supprimiez la limite. Pendant ce temps, Olvio ne peut pas répondre aux acheteurs : gardez donc une marge. Olvio cesse aussi de répondre si votre solde de crédits est épuisé avant que la limite soit atteinte. Vous pouvez suivre votre utilisation sur la page Usage de la Claude Console, et Ce qui utilise votre clé API Anthropic, et ce qui ne l'utilise pas détaille ce pour quoi Olvio utilise la clé.

Remplacer votre clé

Remplacez la clé lorsque vous en créez une nouvelle, par exemple après une rotation ou un passage à un autre compte Anthropic.

  1. Ouvrez Clé API. Le champ Clé API affiche des points à la place de votre clé enregistrée, avec l'indication Laissez vide pour conserver la clé actuelle. Saisissez une nouvelle clé pour la remplacer.

  2. Collez la nouvelle clé dans le champ.

  3. Cliquez sur Enregistrer.

Olvio vérifie la nouvelle clé auprès d'Anthropic avant de l'enregistrer. Si la vérification réussit, la nouvelle clé remplace l'ancienne, et votre boutique en ligne l'utilise en une minute environ. Si elle échoue, votre clé actuelle reste en place. Une fois la nouvelle clé opérationnelle, vous pouvez désactiver ou supprimer l'ancienne dans la Claude Console.

Supprimer votre clé

Cliquez sur Supprimer la clé sur la page Clé API. Le bouton n'apparaît que lorsqu'une clé est enregistrée, et il n'y a pas d'étape de confirmation : la clé est supprimée immédiatement, le message Clé supprimée s'affiche et le statut repasse à Non configurée. Votre choix de modèle est conservé pour le jour où vous connecterez de nouveau une clé.

Sans clé, Olvio ne peut pas répondre aux acheteurs. Le changement prend effet sur votre boutique en ligne en une minute environ. Le widget reste affiché sur vos pages produit, mais sans questions suggérées, et chaque message reçoit la réponse Désolé, une erreur est survenue. Veuillez réessayer. (ou sa traduction sur une boutique en ligne dans une autre langue). Sur les forfaits Growth et Scale, Olvio Advisor ne peut pas répondre non plus.

Supprimer la clé dans Olvio ne la révoque pas chez Anthropic. Si vous n'en avez plus besoin, désactivez-la ou supprimez-la dans la Claude Console.

Comment votre clé est stockée

Olvio chiffre votre clé en AES-GCM (256 bits) avant de la stocker, en la liant au domaine de votre boutique pour que la clé chiffrée ne puisse pas servir à une autre boutique. La clé n'est plus jamais affichée : le champ Clé API affiche des points à sa place. Lorsque vous désinstallez Olvio, la clé est supprimée avec le reste des données de votre boutique environ 48 heures plus tard. Pour en savoir plus, consultez Comment votre clé API Anthropic est chiffrée.

Avez-vous trouvé la réponse à votre question ?