Documents Apportez votre propre clé (BYOK)

Apportez votre propre clé (BYOK)

Utilisez votre propre clé (BYOK) avec le forfait Entreprise : connectez une clé API Google Gemini pour débloquer des crédits bonus, un choix de modèles plus large et une facturation directe.

Vue d'ensemble

« Bring Your Own Key » (BYOK) est une fonctionnalité réservée aux entreprises qui permet à votre organisation d'intégrer directement une clé API Google Gemini dans i1n. Les traductions par IA sont alors effectuées via votre propre compte Google AI, au lieu d'utiliser le pool d'inférence partagé d'i1n.

Lorsque BYOK est activé, votre contrat Entreprise bénéficie d'un bonus de +50 % sur les crédits de traduction IA et les clés de traduction, en plus des limites négociées. Les coûts d'inférence facturés par Google sont débités directement sur votre compte Google ; i1n continue de gérer l'orchestration, la mise en cache, la protection des variables et l'application de la voix de marque.

BYOK est configuré par organisation depuis le tableau de bord. La clé est chiffrée au repos et n'est utilisée que pour effectuer des appels de traduction en votre nom ; elle n'est jamais enregistrée, exportée ou partagée entre les organisations.

Pourquoi utiliser BYOK

L'activation de BYOK est recommandée si l'un des cas suivants s'applique : votre organisation dispose déjà d'un contrat Google Cloud ou Google AI Studio, vous avez besoin d'une visibilité directe sur les coûts d'inférence sous-jacents, ou vous souhaitez bénéficier d'un accès prioritaire aux derniers modèles Gemini en avant-première dès leur publication par Google.

Le bonus de +50 % sur les crédits et les clés signifie qu'un locataire Enterprise utilisant BYOK ne paie effectivement que pour l'orchestration, tandis que les coûts d'inférence sont gérés via votre relation de facturation Google existante, ce qui se traduit généralement par un coût total de possession inférieur pour des volumes de traduction élevés.

BYOK vous offre également une gouvernance plus stricte. Vous pouvez faire pivoter la clé, définir des quotas dans Google AI Studio et auditer l'utilisation depuis un tableau de bord de facturation Google unique, parallèlement au reste de vos charges de travail IA.

Modèles disponibles

Une fois BYOK activé, vous pouvez choisir le modèle Gemini par défaut utilisé pour la traduction automatique. Le modèle peut être modifié à tout moment depuis le tableau de bord et s'appliquera aux tâches de traduction ultérieures.

Gemini 3.5 Flash-Lite est le modèle par défaut recommandé : rapide, rentable, offrant une sortie JSON fiable pour les traitements par lots, et respectant rigoureusement les règles terminologiques ainsi que la voix de la marque. Il s'agit du successeur officiel de Gemini 3.1 Flash-Lite, que Google retirera en mai 2027.

Gemini 3.8 Flash est l'option de qualité pour les projets comportant de nombreuses règles terminologiques ou des chaînes longues et nuancées, moyennant un coût par jeton plus élevé. Gemini 2.5 Flash-Lite reste disponible en tant que choix stable le plus économique et constitue la solution de secours automatique en cas de défaillance du modèle sélectionné. Les modèles en préversion ne sont volontairement pas proposés : Google peut les retirer avec un préavis de deux semaines, ce qui interromprait les tâches de traduction.

Les modèles en préversion (Preview) sont susceptibles d'être modifiés par Google. i1n suit les nouvelles versions de Gemini et les rend disponibles dans le tableau de bord dès leur sortie — aucun avenant au contrat n'est requis pour changer de modèle.

Configuration

Étape 1 — Générez une clé API Gemini. Connectez-vous à Google AI Studio (aistudio.google.com), ouvrez la section des clés API et créez une nouvelle clé associée au projet que vous souhaitez utiliser pour la facturation.

Étape 2 — Ajoutez la clé à i1n. Depuis le tableau de bord, ouvrez les paramètres de votre organisation, accédez à la section BYOK, collez la clé API et enregistrez. La clé est chiffrée au repos immédiatement après sa soumission.

Étape 3 — Choisissez votre modèle par défaut. Sélectionnez l'un des modèles Gemini disponibles (voir « Modèles disponibles » ci-dessus). Cette sélection prend effet pour toutes les tâches de traduction ultérieures via l'interface CLI, le serveur MCP et le tableau de bord.

Étape 4 — Vérification. Exécutez la commande i1n push --translate sur un petit ensemble de clés et confirmez que la tâche est terminée. La vue d'utilisation du tableau de bord indique si chaque traduction a été traitée via BYOK ou via le chemin d'inférence i1n par défaut.

Pour faire pivoter la clé, remplacez-la dans le tableau de bord à tout moment — les tâches en cours continuent d'utiliser l'ancienne clé jusqu'à leur achèvement. Pour désactiver complètement BYOK, supprimez la clé du tableau de bord ; les futures traductions reviendront automatiquement au chemin d'inférence i1n par défaut.

Associé