Connexion de Luna Translator

Difficulté 🧩 Moyenne　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

LunaTranslator est un traducteur open source de GalGame / romans visuels, capable d'extraire le texte par HOOK, de le reconnaître par OCR et de se connecter à un grand modèle pour une traduction par IA. En le connectant à Byesu API, vous pouvez traduire en temps réel le texte des jeux à l'aide de modèles comme gpt-5.5, claude-opus-4-8, etc.

Avant de commencer

Rendez-vous d'abord dans Console → Jetons pour créer un jeton d'API (de la forme sk-xxxx). Lors de la création, veillez à choisir le bon groupe : le groupe détermine les modèles que vous pouvez appeler ainsi que le mode de facturation. Pour en savoir plus, voir Choisir un groupe.

Étape 1 : télécharger et installer Luna Translator

Rendez-vous sur la documentation officielle de LunaTranslator pour télécharger la dernière version, puis décompressez-la et lancez le programme principal (version portable sans installation pour Windows).

Étape 2 : configurer l'interface du grand modèle

LunaTranslator propose deux méthodes : « import en un clic » et « configuration manuelle ». Nous vous recommandons d'essayer d'abord la première méthode.

Méthode 1 (la plus rapide) : import en un clic depuis la console

1. Dans la console Byesu, ouvrez Paramètres système → Paramètres de chat et ajoutez le lien de redirection de chat suivant :

Lien des paramètres de chat

{ "LunaTranslator": "lunatranslator://llmapi/base64?data={cheryConfig}" }

2. Accédez à Console → Gestion des jetons (Token), repérez votre jeton, cliquez sur la flèche déroulante à droite de « Chat » et sélectionnez LunaTranslator : le navigateur lancera automatiquement le client et y inscrira la configuration.
3. Dans LunaTranslator, ouvrez Paramètres → Paramètres de traduction → Grand modèle et repérez la configuration d'interface qui vient d'être ajoutée automatiquement.
4. Cliquez sur le bouton « Actualiser » à côté de la liste déroulante des modèles pour récupérer la liste des modèles disponibles depuis Byesu, choisissez-en un (par exemple gpt-5.5) et enregistrez.
5. Activez l'interrupteur d'activation à gauche de cette configuration d'interface.

Méthode 2 : configuration manuelle

1. Dans Console → Gestion des jetons, copiez votre clé d'API (sk-xxxx).
2. Dans LunaTranslator, ouvrez Paramètres → Paramètres de traduction → Grand modèle et cliquez sur « Ajouter ».
3. Copiez un modèle de « Interface générique de grand modèle ».
4. Renseignez les champs de la nouvelle interface avec les valeurs suivantes :

Champ	Valeur à saisir
Adresse de l'interface API / base_url	https://byesu.com/v1
API Key	sk-xxxx (votre jeton)
Modèle model	gpt-5.5 (ou à choisir après l'actualisation de l'étape suivante)

5. Cliquez sur « Actualiser » à côté du champ du modèle et choisissez le modèle à utiliser dans la liste déroulante.

N'oubliez pas le /v1 dans l'adresse

LunaTranslator utilise une interface compatible OpenAI ; la base_url doit impérativement être https://byesu.com/v1 (se terminant par /v1). Si vous saisissez https://byesu.com, l'interface ne pourra pas être reconnue.

Étape 3 : activer et vérifier

1. Activez l'interrupteur d'activation à gauche de cette configuration d'interface.
2. Revenez à l'écran principal et, dans le moteur de traduction, cochez cette interface de grand modèle comme source des traductions.
3. Capturez un extrait de texte du jeu par HOOK ou OCR et vérifiez que la traduction française est correctement renvoyée : la connexion est alors réussie.

Modèles couramment utilisés, à titre de référence :

• Priorité à la vitesse, excellent rapport qualité-prix : gpt-5.5
• Qualité de traduction plus fine : claude-opus-4-8
• Textes longs / multilingue : gemini-3.1-pro-high

Bloqué ?

• Erreur 401 / échec d'authentification : la clé d'API est erronée ou contient des espaces superflus. Recopiez sk-xxxx depuis la gestion des jetons. Voir Erreurs courantes #auth.
• Message « aucun canal disponible » / « le modèle n'existe pas » : ce modèle n'est pas disponible dans le groupe du jeton actuel. Changez de modèle ou ajustez le groupe. Voir Choisir un groupe et Erreurs courantes #no-channel.
• Quota insuffisant / solde à 0 : le quota du jeton est épuisé. Veuillez recharger ou vérifier la limite de quota du jeton. Voir Erreurs courantes #balance.
• La liste des modèles est vide après actualisation : vérifiez que la base_url se termine par /v1 et que le jeton est valide.

Pour plus de dépannage, voir Erreurs courantes.