Qu’est-ce que HammerAI ?
HammerAI est une première application locale de discussion et d'écriture de personnages d'IA avec un mode proxy LLM externe.
Ce guide HammerAI utilise les champs officiels du mode proxy : une base d'API se terminant par /v1, le nom exact du modèle de fournisseur, la clé API et une longueur de contexte facultative qui ne doit être définie que lorsqu'elle est connue. Le mode proxy achemine les requêtes du modèle de discussion avec les personnages vers une API externe tandis que HammerAI continue de fournir l'interface de conversation locale. Utilisez la racine de l'API et le nom exact du modèle, laissez la longueur du contexte vide sauf si la valeur vérifiée est connue et rechargez le chat avant de tester une réponse courte et une session plus longue.
Le Proxy Mode officiel de HammerAI envoie des demandes de génération de chat de personnages à un service OpenAI-compatible externe. Il utilise quatre champs proxy et ne nécessite pas de téléchargement de modèle local ni de compte de modèle hébergé HammerAI.
Activer le proxy à partir de l'interface officielle HammerAI
- Ouvrez n’importe quelle discussion de personnage.
- Basculez le panneau de droite sur Settings.
- Recherchez le menu LLM.
- Faites défiler vers le bas et choisissez Proxy.
- Remplissez le formulaire de procuration avec les valeurs ci-dessous.
Mappez les quatre champs sur TokenHub
- Proxy URL:
https://us-api.tokenhub.com/v1 - Proxy Model: l'ID de modèle complet du catalogue de modèles TokenHub
- Proxy API Key: votre clé TokenHub API
- Proxy Context Length: en option ; laissez-le vide lorsque la limite réelle est inconnue
Les exemples de proxy officiels utilisent des bases API telles que /v1 de LM Studio, et non un chemin de requête complet. Les versions récentes de HammerAI peuvent supprimer un suffixe /chat/completions ou /completions fourni accidentellement, mais entrer directement la racine /v1.
Tenir compte de la différence entre Web et Desktop
TokenHub est un service HTTPS distant et ne nécessite normalement aucun paramètre CORS supplémentaire. Les instructions CORS dans HammerAI s'appliquent lorsque l'application Web se connecte à un service local tel que LM Studio. Ne transférez pas ces instructions du serveur local vers le TokenHub URL distant.
Faire en sorte que la configuration du proxy prenne effet
Enregistrez, envoyez un court message et confirmez son ID de modèle dans les journaux de requêtes TokenHub. HammerAI note que certains services nécessitent un rechargement complet de l'application avant qu'une connexion ne soit établie. Si les quatre champs sont corrects mais qu'aucune réponse n'arrive, rechargez HammerAI et testez à nouveau.
En cas d'échec de longue conversation, effacez ou corrigez d'abord Proxy Context Length. Pour 401, inspectez Proxy API Key. Pour 404, confirmez que Proxy URL s'arrête à /v1. Si le modèle n'existe pas, copiez à nouveau Proxy Model. Il est plus utile de vérifier ces quatre champs que d'appliquer des paramètres de modèle local non liés.
Référence officielle
Choisir un modèle
FAQ sur le mode proxy HammerAI
Que dois-je saisir comme URL proxy ?
Entrez la base de l'API TokenHub se terminant par /v1. Les exemples officiels de mode proxy de HammerAI utilisent une URL de base plutôt qu'un chemin de requête complet.
Dois-je renseigner la longueur du contexte du proxy ?
C'est facultatif. Laissez-le vide lorsque vous ne connaissez pas le contexte maximum du modèle ; sinon, entrez la valeur exacte.
Pourquoi le proxy ne répond-il pas après avoir enregistré ?
Vérifiez l'URL de base, le nom exact du modèle et la clé API, puis rechargez le chat. Le guide officiel HammerAI note que certains services nécessitent une recharge complète.
Où HammerAI envoie-t-il des données en mode proxy ?
Les demandes de modèle pour ce chat de personnage sont envoyées à l'API externe configurée tandis que HammerAI fournit l'interface locale. Vérifiez la gestion des données de chaque service avant utilisation.
Comment tester le mode proxy HammerAI en toute sécurité ?
Rechargez le chat après l'enregistrement, envoyez un court message et confirmez le modèle exact et l'état de la demande dans les journaux TokenHub avant une longue conversation.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。
