Utiliser votre propre clé (BYOK)
Enregistrez les propres clés API de votre organisation pour les fournisseurs de modèles sur la page BYOK, dans Paramètres. Les requêtes de Localisation destinées aux modèles du fournisseur sont alors envoyées directement à celui-ci avec votre clé, et il vous les facture. Disponible avec le forfait Enterprise.
Fournisseurs pris en charge : Anthropic, OpenAI, Google et Mistral AI.
Quelles requêtes utilisent votre clé ?#
Seule la localisation utilise votre clé. Tout le reste continue d’utiliser la clé de Lingo.dev.
| Requête | Clé |
|---|---|
| Localisation : l’API localize, les tâches de localisation, le Playground et chaque étape de localisation exécutée par un moteur | Votre clé, si vous en avez une pour le fournisseur de ce modèle |
| Contrôle qualité | Clé de Lingo.dev |
| Évaluateurs IA | Clé de Lingo.dev |
| Suggestions du moteur | Clé de Lingo.dev |
Facturation#
Lorsqu’une requête utilise votre clé, le fournisseur vous facture les jetons correspondants.
Qui peut gérer les clés ?#
Deux conditions régissent l’accès à la page BYOK :
- Accès à la fonctionnalité : la fonctionnalité BYOK doit être activée pour l’organisation (forfait Enterprise). La page apparaît toujours dans Paramètres. Sans cet accès, elle affiche « Votre forfait ne permet pas d’utiliser vos propres clés de fournisseurs », et vous ne pouvez pas enregistrer de clé.
- Autorisation : l’ajout, le remplacement, l’activation, la désactivation et la suppression d’une clé nécessitent l’autorisation Gérer les paramètres (
org:manage_settings) dans le rôle du membre. 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. Les clés ne peuvent pas être modifiées avec une clé API d’organisation. Connectez-vous plutôt avec un compte personnel.
Ajouter une clé#
- Ouvrez Paramètres → BYOK.
- Cliquez sur Ajouter une clé à côté du fournisseur.
- 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’un moteur appelle un modèle de ce fournisseur. Pour exécuter un modèle du fournisseur avec votre clé, sélectionnez-le dans la configuration des modèles du moteur.
| Situation | Ce qui se passe |
|---|---|
| Vous avez une clé pour le fournisseur du modèle et elle est activée | La requête utilise votre clé |
| Aucune clé pour ce fournisseur | La requête utilise la clé de Lingo.dev et vos crédits, comme auparavant |
| La clé est désactivée | La requête utilise la clé de Lingo.dev et vos crédits |
| Le fournisseur refuse l’accès au modèle avec votre clé | Une nouvelle tentative est effectuée avec la clé de Lingo.dev et vos crédits |
L’absence de clé ou sa désactivation n’interrompt jamais votre localisation. En revanche, si le fournisseur refuse l’accès au modèle après avoir commencé à répondre, la requête peut échouer. Pour éviter cela, autorisez l’accès au modèle pour votre clé ou choisissez un autre modèle.
Lorsque votre clé est refusée#
Ces erreurs interrompent la requête. Elle ne bascule ni vers la clé de Lingo.dev ni vers le modèle suivant dans la configuration des modèles du moteur. Le message d’erreur précise le fournisseur concerné et ce qu’il faut corriger.
| Situation | Que faire |
|---|---|
| Le fournisseur limite le débit de 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 quota | Ajoutez 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ée | Remplacez la clé dans Paramètres → BYOK, puis réessayez |
| Lingo.dev ne peut pas lire la clé enregistrée | Enregistrez à nouveau la clé dans Paramètres → BYOK, puis réessayez |
Ces limites et ce compte sont les vôtres : rediriger le trafic vers la clé de 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 les modèles de ce fournisseur utilisent la clé de Lingo.dev et vos crédits jusqu’à ce que vous réactiviez votre clé.
Si votre forfait ne permet plus d’utiliser vos propres clés, la clé enregistrée porte le statut Enregistrée, non utilisée. Les modèles de ce fournisseur utilisent la clé de Lingo.dev et vos crédits. La clé enregistrée est conservée jusqu’à ce que vous la supprimiez.
Supprimer une clé#
Cliquez sur Supprimer la clé. La clé est supprimée de Lingo.dev, et les modèles de ce fournisseur utilisent à nouveau la clé de Lingo.dev et vos crédits.
Révoquez-la auprès du fournisseur
Supprimer une clé de Lingo.dev ne la révoque pas. Elle reste valide auprès du fournisseur jusqu’à ce que vous la révoquiez chez lui.