Configuration d'une API personnalisée pour Immersive Translate

Ouvrez les paramètres du service OpenAI

La page officielle du service OpenAI d'Immersive Translate documente une adresse API personnalisée sous More Settings. Commencez par là pour évaluer un endpoint compatible OpenAI. Enregistrez la version de l'extension et le navigateur afin qu'une vérification ultérieure de la configuration renvoie à un environnement reproductible.

Choisissez une configuration pour le premier test et gardez les paramètres par défaut disponibles pour la récupération. Saisissez l'identifiant uniquement dans les paramètres privés de l'extension. Confirmez que l'endpoint est le destinataire prévu avant d'envoyer du contenu de page, en particulier lorsque le navigateur peut aussi accéder à des écrans d'administration marchand.

Vérifiez si l'adresse est une base ou une route complète

Ne supposez pas que tous les champs d'adresse personnalisée se comportent comme un baseURL de SDK. La page officielle inclut une URL complète de chat-completions dans son exemple Azure. Inspectez le texte d'aide de votre extension installée et le chemin sortant de la requête après masquage pour déterminer comment l'adresse est utilisée.

Pour une candidate chat-completions APIsRouter, la route complète est https://api.apisrouter.com/v1/chat/completions. Si votre version installée attend explicitement une URL de base et ajoute la route, utilisez plutôt https://api.apisrouter.com/v1. Évitez le suffixe chat/completions en double. La fiche ci-dessous décrit des paramètres candidats, et non une configuration d'extension testée.

Service: OpenAI
Settings area: More Settings > custom API address
Full request URL candidate: https://api.apisrouter.com/v1/chat/completions
Base-only candidate, if required by installed version: https://api.apisrouter.com/v1
Credential: gateway key entered privately
Model: exact current catalog ID with verified chat behavior

Gardez visible le chemin de la requête de traduction

L'extension envoie les requêtes de traduction à l'adresse de service sélectionnée. Traitez cette adresse comme une décision de partage de données, et pas seulement comme un champ de connectivité. Utilisez du contenu que vous possédez ou que vous êtes autorisé à traiter via l'endpoint choisi et vérifiez quelle quantité de page l'action de traduction sélectionnée inclut.

Le schéma ci-dessous illustre la route de passerelle proposée au moyen du mécanisme d'adresse personnalisée documenté. Le libellé du modèle sélectionné est un choix de configuration, et non une liste de modèles vérifiés. Le stockage de l'authentification, l'édition des produits et les approbations d'import sont en dehors de ce chemin de requête.

Vérifiez d'abord une page contrôlée

Utilisez une page courte avec une description produit synthétique, un terme de marque protégé, une quantité avec son unité et un lien. Traduisez uniquement cette page. Comparez le résultat visible à la source et inspectez la destination réseau masquée, le modèle sélectionné et le statut de la réponse.

Vérifiez si le contenu est omis, dupliqué ou mélangé avec la langue source. Essayez ensuite un paragraphe plus long et une mise en page avec titres ou listes. Enregistrez la source et la sortie observée afin de comparer une modification de configuration au même contenu. Vous disposez ainsi d'une base de diagnostic utile avant de traiter un document volumineux.

Utilisez la lecture bilingue pour les questions éditoriales

La traduction du navigateur peut aider un relecteur à inspecter un contenu source peu familier ou à repérer une phrase qui mérite attention. Gardez l'original visible et comparez directement les affirmations, quantités et termes. Si le relecteur ne peut pas évaluer la langue cible, transmettez la candidate à quelqu'un qui le peut au lieu de prendre une apparence fluide pour une preuve.

Gardez les décisions de glossaire dans le workflow catalogue. Ne supposez pas qu'un endpoint personnalisé fournit aussi l'application d'un glossaire ou la validation au niveau des champs dans l'extension. Les descriptions produit destinées à l'import nécessitent encore leur propre candidate liée aux sources, leur résultat de revue et leur mapping de destination.

Diagnostiquez les erreurs avant de traduire davantage de contenu

Commencez par le chemin de requête, l'identifiant et l'ID exact du modèle. Enregistrez les erreurs structurées lorsqu'elles sont disponibles et masquez les en-têtes avant de partager les preuves. Si les requêtes sont limitées, réduisez la charge et respectez les conseils de nouvelle tentative du service au lieu de répéter rapidement une traduction de page complète.

Utilisez un passage plus court pour distinguer une défaillance de connexion d'un problème de contenu ou de gestion de réponse. Ne changez qu'un paramètre à la fois. La page officielle contient des exemples historiques de prix et de débit de requêtes ; utilisez plutôt la documentation et les limites de compte de votre endpoint actuel au lieu de recopier ces nombres dans une nouvelle configuration.

Séparez la sortie du navigateur de la livraison du catalogue

Une vue traduite dans le navigateur est une surface d'inspection. Pour publier du texte produit, créez une candidate dans le paquet de revue du catalogue, préservez les identifiants et les révisions de source, puis transmettez les champs approuvés via l'import réel de la boutique ou son API de traduction.

Vérifiez la livraison en relisant les champs stockés et en ouvrant la locale de boutique prévue. Ne vous appuyez pas sur l'extension navigateur d'un éditeur pour prouver ce qu'un visiteur ordinaire verra. Enregistrez l'utilisation des requêtes de traduction séparément des opérations boutique et comptez les nouvelles tentatives dans l'évaluation de la charge. Reportez-vous aux tarifs actuels plutôt que de supposer un coût fixe par page ou par caractère.

Preuves et limites d'intégration

La documentation officielle établit un paramètre d'adresse personnalisée. Une requête d'extension installée via APIsRouter n'a pas été testée pour cet article ; le comportement précis de l'adresse, la compatibilité du modèle et le résultat rendu restent donc des contrôles de configuration. Le schéma est un flux de configuration illustratif.

Un enregistrement de compatibilité terminé devrait inclure les versions de l'extension et du navigateur, les paramètres masqués, la destination de requête, le modèle exact, une page source contrôlée et la traduction observée. Gardez la revue des champs protégés séparée de ce contrôle de transport. Un passage court réussi ne valide pas automatiquement tous les formats de document ni un workflow de publication en boutique.

Questions fréquentes