Configurer Gemini dans SillyTavern : connexion et dépannage
Votre clé API fonctionne dans un seul outil, mais SillyTavern ne trouve pas le modèle ou renvoie une erreur 400. Avant de modifier un préréglage, déterminez la route API, la forme de l'URL et l'ID de modèle que le client envoie réellement.
Choisissez le chemin de connexion avant de saisir une clé
| Paramètre | Valeur pour ce chemin | Erreur courante |
|---|---|---|
| Type d'API | Chat Completion | Choisir la complétion du texte |
| Source | Custom (OpenAI-compatible) | Coller cette URL dans la connexion native d'un autre fournisseur |
| URL de base | https://direct.evolink.ai/v1 | Ajout à nouveau de /chat/completions dans le champ de base |
| Clé API | Votre clé EvoLink | Une clé émise par un autre fournisseur |
| ID du modèle | gemini-4-argon | Utilisation du slug de page gemini-4 comme ID de modèle d'API |
https://direct.evolink.ai/v1/chat/completions. Le champ de base de SillyTavern prend la valeur la plus courte car le client ajoute le point de terminaison. Tutoriel de demande d'EvoLink documente l'URL Chat Completions ; utilisez la page modèle Gemini pour son ID de modèle actuel et les protocoles étayé.Vérifiez une courte requête avant d'ajouter le préréglage
Si vous souhaitez distinguer la configuration client de l'échec de la route, essayez cette requête minimale à l'aide d'une variable d'environnement locale :
curl https://direct.evolink.ai/v1/chat/completions -H "Authorization: Bearer $EVOLINK_API_KEY" -H "Content-Type: application/json" -d '{"model":"gemini-4-argon","messages":[{"role":"user","content":"Reply with OK."}],"max_tokens":2048,"stream":false}'Une réponse brute réussie établirait que ces informations d'identification, ce point de terminaison et ce modèle ont fonctionné pour cette demande. Cela n’établirait pas la compatibilité avec chaque appel d’outil ou préréglage de personnage ultérieur. Enregistrez le statut et le corps ; ne collez pas les informations d'identification dans les captures d'écran ou les journaux d'assistance.
Dans SillyTavern, enregistrez le profil personnalisé et envoyez un court message de test. Si la liste déroulante des modèles est vide, la documentation officielle autorise un identifiant de modèle saisi manuellement lorsqu'un fournisseur n'expose pas de liste de modèles utilisables. Une liste vide est un problème de découverte, et non une preuve que la génération n'est pas disponible.
Restaurer les fonctionnalités une par une
Commencez par un message utilisateur simple et une sortie de texte ordinaire. Restaurez ensuite l'invite système/caractère, l'historique multi-tours, le streaming et tous les outils ou extensions un par un. Lorsqu'un échec apparaît, comparez la demande avant et après ce changement.
| Observations | Inspectez d’abord |
|---|---|
| 401 ou échec d'authentification | Identifiants, destination et accès au compte |
| 404 ou réponse erronée | URL de base, suffixe dupliqué et disponibilité du modèle |
| 400 arguments invalides | Champs sérialisés réels, rôles et fonctionnalités facultatives |
| Réponse vide ou tronquée | Corps de la réponse, limite de sortie, finish_reason et analyse du client |
| La requête réussit mais le client avertit toujours | Découverte de modèle/vérification de l'état et comportement du client installé |
N'activez pas « Contourner la vérification de l'état de l'API » simplement pour masquer une demande ayant échoué. Établissez d’abord une génération réussie, puis déterminez si l’avertissement concerne une vérification de découverte distincte.
Diagnostiquer le message 400 concernant un dernier tour du modèle
Requests ending with a model turn are not supported, inspectez la conversation sérialisée finale. Une zone de saisie visible ne prouve pas que le message final envoyé est le tour de l'utilisateur ; le pré-remplissage, la continuation, la conversion de l'historique ou les extensions peuvent le modifier.Pour un test en texte brut, utilisez une nouvelle discussion se terminant par un vrai message utilisateur et supprimez les paramètres de pré-remplissage ou de continuation de l'assistant. Réintroduisez-les séparément. Si des outils sont impliqués, inspectez la séquence complète d'appel d'outil/résultat par rapport aux exigences du fournisseur plutôt que de supprimer les enregistrements d'outils ou de modifier aveuglément les noms de rôle.
Les documents SillyTavern proposent des variantes de post-traitement, y compris des options qui suppriment des outils. Un convertisseur peut changer de comportement ainsi que satisfaire aux contraintes de rôle. Vérifiez quelle variante est active et testez la fonctionnalité prévue après une modification. Un rapport communautaire sur un autre fournisseur ou modèle est un indice de diagnostic et non une solution vérifiée pour votre point de terminaison.
Inspecter l'utilisation des discussions longues et la mise en cache
Un historique plus long peut augmenter l’utilisation des entrées même si le dernier message est court. Enregistrez les entrées, les sorties, l'utilisation du cache signalée le cas échéant et le montant total facturé pour des demandes comparables. Ne déduisez pas les accès au cache simplement parce que la même prompt de personnage apparaît dans l’interface utilisateur.
gemini.enableSystemPromptCache comme spécifique à OpenRouter. Ce commutateur ne prouve pas que le même comportement s'applique à ce chemin EvoLink personnalisé.Conserver un enregistrement d'assistance reproductible
Conservez la version installée de SillyTavern, le type de connexion, l'URL de base sans informations d'identification, l'ID de modèle, les fonctionnalités activées, le statut HTTP, le corps expurgé et une reproduction minimale. Enregistrez le profil de travail avant de modifier plusieurs paramètres.
Pour une enquête assistée par un agent, demandez-lui de comparer la demande minimale sérialisée et la demande ayant échoué et d'identifier le premier champ ou séquence non étayé. Utilisez les instructions de la page modèle d'EvoLink pour l'appel réel ; n’envoyez pas de transcription de dépannage contenant une clé active.
FAQ
L'URL de base est-elle le point de terminaison complet des Chat Completions ?
/v1 ; le client fournit /chat/completions.Que faire si la liste des modèles ne contient pas Gemini 4 ?
Vérifiez l'ID du modèle d'API actuel et utilisez l'option de saisie manuelle documentée. Testez ensuite la génération indépendamment de la découverte.
Tous les 400 nécessitent-ils la suppression d'un message final de l'assistant ?
Non. Inspectez l’erreur complète. Le diagnostic concernant un dernier tour du modèle s'applique à cette signature spécifique et nécessite toujours une inspection de la requête.
Puis-je réutiliser une clé émise par Google sur EvoLink ?
Utilisez les informations d'identification de la destination que vous appelez. Ce chemin utilise une clé EvoLink.
Le paramètre de cache garantit-il des économies ici ?
Non. Confirmez la prise en charge par le fournisseur et l’utilisation réelle signalée sur le point de terminaison sélectionné.
Que dois-je envoyer avec un rapport de bug ?
Version, itinéraire et modèle, fonctionnalités activées, erreur expurgée et reproduction minimale. Gardez les informations d’identification à l’écart.
Sources
- Point de terminaison personnalisé SillyTavern et conversion des prompts.
- Configuration de SillyTavern.
- URL Chat Completions d’EvoLink.
- EvoLink Gemini 4 : référence du modèle et du protocole, vérifié le 16 octobre 2026.
