Utiliser votre propre clé (BYOK)

Enregistrez les clés Anthropic, OpenAI, Google et Mistral AI de votre organisation pour que les requêtes de localisation utilisent votre clé et que le fournisseur vous facture directement.

Utilisez votre propre clé API de fournisseur de modèles pour la localisation. Ajoutez la clé de votre organisation sur la page BYOK des Paramètres, puis choisissez un modèle pour la localisation. Les requêtes destinées aux modèles de ce fournisseur utilisent votre clé, et le fournisseur vous facture directement les jetons consommés. Disponible avec le forfait Enterprise.

Fournisseurs pris en charge : Anthropic, OpenAI, Google et Mistral AI.

Localisation avec votre clé #

Les autres fonctionnalités, comme les évaluateurs IA et les suggestions du moteur, ne nécessitent ni clé de fournisseur ni choix de modèle.

Facturation #

Lorsque la localisation utilise votre clé, le fournisseur vous facture les jetons consommés par le modèle, et Lingo.dev ne vous facture pas le coût du modèle. Les frais d’infrastructure de Lingo.dev pour le contenu localisé restent applicables. Lorsque la localisation n’utilise pas votre clé, le coût du modèle est déduit de vos crédits Lingo.dev.

Qui peut gérer les clés #

La page BYOK est soumise à deux conditions :

  1. Disponibilité : la fonctionnalité BYOK doit être activée pour l’organisation (forfait Enterprise). La page apparaît toujours dans les Paramètres. Si la fonctionnalité n’est pas disponible, le message « Votre forfait ne permet pas d’utiliser vos propres clés de fournisseur » s’affiche, et vous ne pouvez pas enregistrer de clé.
  2. Autorisation : pour ajouter, remplacer, activer, désactiver ou supprimer une clé, le rôle du membre doit disposer de l’autorisation Gérer les paramètres (org:manage_settings). Sans RBAC, chaque membre a le rôle Propriétaire et dispose de cette autorisation.

Chaque membre peut voir quels fournisseurs disposent d’une clé et si celle-ci est utilisée. Vous ne pouvez pas modifier les clés avec une clé API d’organisation. Connectez-vous plutôt avec un compte utilisateur.

Ajouter une clé #

  1. Ouvrez Paramètres → BYOK.
  2. Cliquez sur Ajouter une clé à côté du fournisseur.
  3. Collez la clé API et enregistrez.

Lingo.dev vérifie la clé auprès du fournisseur au moment de l’enregistrement. Si le fournisseur la refuse, elle n’est pas enregistrée. Vérifiez-la dans votre compte chez le fournisseur, puis collez-la à nouveau.

Visibilité de la clé

Une fois enregistrée, une clé n’est plus jamais affichée. La page indique uniquement ses quatre derniers caractères et la date de sa mise à jour. Pour la modifier, utilisez Remplacer et collez une nouvelle clé.

Utiliser les modèles d’un fournisseur #

Votre clé est utilisée lorsqu’une requête de localisation appelle un modèle de ce fournisseur. Pour utiliser votre clé dans les étapes de localisation d’un moteur, sélectionnez un modèle de ce fournisseur dans la configuration des modèles du moteur.

SituationCe qui se passe
Vous disposez d’une clé pour le fournisseur du modèle, elle est activée et le fournisseur autorise l’accès au modèle avec cette cléLa requête utilise votre clé
Aucune clé pour ce fournisseurLa localisation avec un modèle du catalogue utilise vos crédits Lingo.dev
La clé est désactivéeLa localisation avec un modèle du catalogue utilise vos crédits Lingo.dev
Le modèle ne figure pas dans le catalogue de modèles Lingo.dev, et votre clé pour ce fournisseur est absente ou désactivéeLa localisation avec ce modèle échoue, car la clé de Lingo.dev ne permet pas d’y accéder
Le fournisseur refuse l’accès au modèle avec votre cléPour un modèle du catalogue, une nouvelle tentative utilise vos crédits Lingo.dev ; pour un modèle hors catalogue, la requête échoue

Étiquette BYOK

Votre clé est utilisée uniquement si le fournisseur autorise l’accès au modèle sous l’identifiant exact défini dans votre moteur. Dans les sélecteurs de modèles et la configuration des modèles de votre moteur, les modèles accessibles avec votre clé portent l’étiquette BYOK. Un modèle enregistré portant l’étiquette Non BYOK n’est pas accessible avec votre clé : la localisation avec ce modèle utilise donc vos crédits Lingo.dev. Un modèle enregistré portant l’étiquette Clé Mistral AI requise ne figure pas dans le catalogue de modèles Lingo.dev : il fonctionne uniquement avec votre clé Mistral AI, qui est absente ou désactivée. Ajoutez ou activez la clé, ou choisissez un autre modèle.

Une clé absente ou désactivée n’empêche jamais la localisation avec un modèle du catalogue.

Modèles hors catalogue #

Les sélecteurs de modèles proposent aussi des modèles de conversation accessibles avec votre clé Mistral AI, mais absents du catalogue de modèles Lingo.dev, comme mistralai/zai-glm-5-3. Ils portent l’étiquette BYOK et apparaissent sous la forme provider/model, une seule fois par modèle, sous l’identifiant que Mistral AI lui attribue. Un modèle enregistré sous l’un de ses alias, comme mistralai/zai-glm-latest, fonctionne aussi avec votre clé.

Ces modèles fonctionnent uniquement avec votre clé, car celle de Lingo.dev ne permet pas d’y accéder. Pour le moment, seule la liste des modèles de Mistral AI précise quels modèles sont des modèles de conversation. Les clés des autres fournisseurs n’ajoutent donc aucun modèle hors catalogue.

Lorsque votre clé est refusée #

Ces erreurs interrompent la requête de localisation. Elle ne fait aucune nouvelle tentative avec vos crédits Lingo.dev et ne passe pas au modèle suivant dans la configuration des modèles du moteur. Le message d’erreur indique le fournisseur et le point à corriger.

SituationQue faire
Le fournisseur applique une limite de débit à votre cléRéessayez dans quelques minutes ou augmentez les limites de débit de la clé auprès du fournisseur
Votre compte chez le fournisseur n’a plus de crédits ou a épuisé son quotaAjoutez des crédits ou augmentez le quota auprès du fournisseur, puis réessayez
Le fournisseur rejette votre clé, par exemple parce qu’elle a été révoquéeRemplacez la clé dans Paramètres → BYOK, puis réessayez
Lingo.dev ne peut pas lire la clé enregistréeEnregistrez à nouveau la clé dans Paramètres → BYOK, puis réessayez

Il s’agit de vos propres limites et de votre propre compte : réessayer avec des crédits Lingo.dev vous masquerait le problème.

Désactiver une clé #

Désactivez la clé pour cesser de l’utiliser sans la supprimer. La page affiche Désactivée, et la localisation avec les modèles du catalogue de ce fournisseur utilise vos crédits Lingo.dev jusqu’à ce que vous réactiviez la clé. Les modèles hors catalogue ne fonctionnent pas tant que la clé est désactivée.

Si votre forfait ne permet plus d’utiliser vos propres clés, la clé enregistrée affiche le statut Enregistrée, non utilisée. La localisation avec les modèles du catalogue de ce fournisseur utilise vos crédits Lingo.dev, et les modèles hors catalogue ne fonctionnent pas. La clé reste enregistrée jusqu’à ce que vous la supprimiez.

Supprimer une clé #

Cliquez sur Supprimer la clé. La clé est supprimée de Lingo.dev. La localisation avec les modèles du catalogue de ce fournisseur utilise à nouveau vos crédits Lingo.dev, et les modèles hors catalogue cessent de fonctionner.

Révoquez-la auprès du fournisseur

Supprimer une clé de Lingo.dev ne la révoque pas. Elle reste valide chez le fournisseur jusqu’à ce que vous la révoquiez auprès de lui.