Présentation de la configuration des modèles
Ce tutoriel explique comment configurer divers grands modèles de langage dans SelectTranslate extension, incluant API keys, les URL des points de terminaison, la sélection du modèle, les paramètres de performances et les paramètres d'invite. Une configuration appropriée du modèle peut améliorer la stabilité du service et améliorer la précision de la traduction, la vitesse de réponse et l'expérience utilisateur globale dans différents scénarios de traduction.
1. Configurer API Key
Un API key est l'identifiant d'accès officiel fourni par le fournisseur de services modèle, utilisé pour appeler en toute sécurité son AI modèles et services associés.
Commun API Key Problèmes de configuration
- Incorrect API Key Format : Le API key peut contenir des caractères manquants, des espaces supplémentaires ou être mal tronqué. Assurez-vous de copier la clé complète fournie par le service et évitez d'inclure des espaces, des sauts de ligne ou d'autres caractères non valides.
- API Key Inadéquation avec le fournisseur de services : API keys provenant de différents fournisseurs de modèles ne sont pas interchangeables. Par exemple, un OpenAI API key ne peut pas être utilisé avec DeepSeek modèles.
- API Key Expiré ou désactivé : votre API key peut avoir été révoqué en raison d'une expiration, d'une désactivation manuelle, de problèmes de compte, de limites d'utilisation ou de raisons de sécurité. Veuillez visiter la console de votre fournisseur pour vérifier l'état actuel de votre API key.
- Erreur d'URL de point de terminaison : même avec un API Key, les tests de connexion peuvent échouer si l'URL du point de terminaison est incorrecte, s'il manque des chemins de version ou ne correspond pas aux exigences spécifiques du fournisseur.
- Incompatibilité de nom de modèle : assurez-vous que le nom du modèle est correctement orthographié et officiellement pris en charge par votre fournisseur. Les erreurs typographiques ici sont souvent identifiées à tort comme API Key problèmes.
- Problèmes de réseau ou de proxy : la stabilité du réseau local, les configurations de proxy ou les restrictions de pare-feu peuvent bloquer les requêtes, entraînant des échecs d'authentification ou des délais d'expiration des requêtes.
2. Sélection du modèle de traduction
Lors de la configuration de l'extension, le nom du modèle doit correspondre au fournisseur de services associé au API key ; sinon, le modèle ne peut pas être appelé avec succès.
Fournisseurs pris en charge et mappage de modèles
| Fournisseur | Nom du modèle |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Personnalisé API URL
L'extension utilise le fonctionnaire API URL par défaut, aucun ajustement n’est donc généralement nécessaire. La saisie manuelle de l'URL n'est requise que dans les cas suivants :
- Appel du modèle via un proxy inverse ou un service de relais,
- À l'aide d'un service de grand modèle déployé en privé,
- Connexion à un tiers API services qui n’utilisent pas entièrement l’URL officielle par défaut.
Consignes de saisie：
- L'URL doit être un point de terminaison HTTPS complet, par exemple :
https://api.your-company.com/v1/chat/completions - Le chemin du point de terminaison doit correspondre à la documentation technique du fournisseur de services et le API doit recevoir et traiter correctement les demandes qui suivent le format spécifié.
4. Réglage des paramètres du modèle
Les paramètres suivants sont utilisés pour ajuster la qualité de la traduction, la stabilité du modèle et la vitesse de réponse. Les paramètres par défaut couvrent la plupart des cas d'utilisation ; ajustez-les si nécessaire pour répondre à des exigences spécifiques.
| Paramètres | Descriptif | Paramètres recommandés |
|---|---|---|
| Longueur maximale du texte par demande | Utilisé pour limiter le nombre maximum de caractères pouvant être soumis dans une seule demande de traduction. Définir cette valeur trop élevée peut ralentir API réponses ; le maintenir dans une plage raisonnable contribue à améliorer la stabilité et la vitesse de réponse. | - Recommandé 1000–1500 personnages- Eviter de dépasser 2000 caractères pour éviter les retards de réponse ou la perte de contenu. |
| Nombre maximum de paragraphes par demande | Le nombre de paragraphes pouvant être soumis en même temps dans une seule demande de traduction. Soumettre trop de paragraphes à la fois peut augmenter la charge de traitement, entraînant des réponses plus lentes ou une stabilité réduite. La définition appropriée de cette valeur contribue à améliorer l’efficacité et la fiabilité globales de la traduction. | - Textes techniques ou juridiques :1(traiter paragraphe par paragraphe pour garantir l’exactitude de la terminologie)- Romans, dialogues ou blogs : 3–5(améliore la maîtrise) |
| Requêtes maximales par seconde | Le nombre de demandes de traduction envoyées par seconde. Si le taux de requêtes est trop élevé, des requêtes supplémentaires seront mises en file d'attente pour éviter d'être touchées. API limites de débit et pour maintenir la stabilité globale du système. | - Utilisation générale :25- Services stricts à tarifs limités (par exemple, Gemini): 8–10 |
| Température | Contrôle le caractère aléatoire et la variabilité de la sortie du modèle. Des valeurs de température plus élevées produisent des réponses plus diversifiées et créatives, tandis que des valeurs plus faibles donnent des résultats plus stables, ce qui est préférable pour des traductions cohérentes et précises. | - Recommandation pour les tâches de traduction : Les températures recommandées officielles varient selon le modèle. Il est suggéré d'utiliser la valeur par défaut fournie et de l'ajuster si nécessaire. |
5. Invites personnalisées (invite système/invite utilisateur)
L'extension comprend des invites de traduction générales intégrées et optimisées qui couvrent les scénarios de traduction les plus courants. Lorsqu'il existe des exigences spécifiques, telles que le style de traduction, la cohérence terminologique, l'expertise du domaine ou les préférences de ton, des invites personnalisées peuvent être utilisées pour affiner le résultat du modèle.
Lors de la création d'invites de traduction personnalisées, il est recommandé de suivre ces directives :
- Instructions claires et spécifiques : Précisez clairement la langue cible, le style de traduction, le domaine et les expressions ou choix de mots à éviter.
- Instructions exploitables : utilisez des descriptions concrètes et précises, en évitant les déclarations vagues ou abstraites, pour garantir que le modèle peut comprendre et suivre avec précision les instructions.
- Gardez les invites concises : assurez-vous que l'invite fournit suffisamment d'informations tout en restant brève, en évitant les détails redondants qui pourraient interférer avec la compréhension du modèle.
6. Avis de non-responsabilité
🔔 Veuillez être conscient du niveau gratuit et des frais facturés par le fournisseur de services pour éviter des coûts inattendus.