1. Avant de commencer
- Votre compte doit avoir le déverrouillage BYOK — un achat unique, voir Tarifs. Connectez-vous dans l'application ou l'extension avec le compte qui l'a acheté.
- Procurez-vous une clé chez le fournisseur : Gemini dans Google AI Studio, ou Qwen dans Alibaba Cloud Model Studio (édition International).
- Il n'y a qu'un seul champ de clé. Voxis reconnaît le fournisseur à la clé elle-même :
AIza…est Gemini,sk-…est Qwen. Vous pouvez enregistrer les deux côte à côte — Voxis choisit alors le meilleur moteur par langue cible (Qwen parle environ 29 cibles avec une voix naturelle ; Gemini couvre les 79).
2. Ajouter une clé Gemini
Créez une clé API dans Google AI Studio, copiez la valeur AIza…, collez-la dans le champ de clé et enregistrez. Aucune ligne workspace n'apparaît pour Gemini — c'est normal ; Gemini n'en a pas besoin.
3. Ajouter une clé Qwen — collez le fichier en entier
Model Studio vous remet la clé sous forme d'un petit fichier d'identifiants téléchargeable (CSV). La seule règle qui fait tout fonctionner :
Ne collez pas le chemin du fichier, et ne collez pas seulement la clé. Ouvrez le fichier, sélectionnez tout son contenu, copiez-le et collez le tout dans le champ de clé.
Voxis y lit les deux moitiés d'un coup : la clé API et le workspace. Le workspace compte, car une clé Qwen appartient à un workspace et — surtout dans le navigateur — le workspace fait partie de l'adresse de connexion elle-même. Sans lui, la clé ne peut pas se connecter du tout.
- Vous n'avez collé que la clé
sk-…nue ? Voxis vous demandera le workspace par son nom. - Vous avez collé le chemin du fichier (du type
C:\Users\…\key.csv) ? Vous verrez l'avertissement « collez une clé API » — collez plutôt le contenu du fichier. - Créez la clé dans le Model Studio International. Une clé de la mauvaise région échoue comme si elle était invalide.
4. Lancer la traduction
Dans l'extension : ouvrez l'onglet où joue la vidéo, cliquez sur l'icône Voxis et vérifiez la ligne sous le bouton Démarrer — elle nomme l'onglet qui sera traduit (« Démarrer traduit cet onglet : … »). Si ce n'est pas le bon, passez à l'onglet de la vidéo et ouvrez le popup là. Puis appuyez sur Démarrer. Dans l'application Windows : choisissez Vidéo/Jeu ou Réunion et lancez — les premiers mots traduits peuvent prendre quelques secondes.
Si quelque chose ne marche pas
- Avertissement « collez une clé API » — vous avez collé un chemin de fichier ou du texte brut. Ouvrez le fichier et collez son contenu.
- Une erreur juste après Démarrer qui nomme le workspace — le workspace manque. Recollez le fichier d'identifiants en entier.
- Une erreur rapide et précise sur l'appariement clé/workspace — les deux ne vont pas ensemble, ou la région est mauvaise. Retéléchargez le fichier et recollez-le.
- Connecté, mais silencieux — vérifiez que vous avez appuyé sur Démarrer dans l'onglet qui joue la vidéo, et qu'elle joue vraiment.
- Une langue refuse de démarrer avec la seule clé Qwen — cette cible n'a pas de voix Qwen. Ajoutez aussi une clé Gemini ; Voxis route automatiquement.