Configuration LLM personnalisée OpenHands

Ajoutez un modèle personnalisé compatible OpenAI de TokenHub aux paramètres OpenHands Advanced LLM et vérifiez une nouvelle conversation.

Créer une clé API TokenHub

Qu’est-ce qu’OpenHands ?

OpenHands est un agent de développement logiciel open source qui peut fonctionner avec des référentiels, des terminaux, des navigateurs et des modèles de langage configurables.

Cette configuration OpenHands enregistre un profil LLM soutenu par TokenHub via les paramètres LLM avancés. Utilisez un nom de modèle LiteLLM préfixé par OpenAI et validez une tâche en lecture seule dans une nouvelle conversation avant d'autoriser les modifications. OpenHands achemine les modèles personnalisés via LiteLLM, c'est pourquoi la valeur du modèle personnalisé inclut un préfixe de fournisseur OpenAI ainsi que l'ID exact du modèle TokenHub. Les paramètres LLM enregistrés ne peuvent pas remplacer le profil d'une conversation existante, alors créez une nouvelle session et validez la lecture du référentiel avant d'autoriser les modifications du terminal ou du fichier.

OpenHands résout les modèles personnalisés via LiteLLM. L'étape importante ne consiste pas simplement à choisir « OpenAI », mais à saisir un Custom Model qualifié par le fournisseur dans le Advanced LLM Settings officiel. Pour TokenHub, utilisez openai/YOUR_TOKENHUB_MODEL_ID.

Ouvrir les paramètres avancés LLM

  1. Ouvrez LLM Settings dans OpenHands.
  2. Allumez Advanced. Les champs officiels Custom Model, Base URL et API Key apparaissent uniquement dans les paramètres avancés.
  3. Entrez openai/YOUR_TOKENHUB_MODEL_ID dans Custom Model.
  4. Entrez https://us-api.tokenhub.com/v1 dans Base URL.
  5. Entrez votre clé TokenHub API dans API Key.
  6. Cliquez sur Save Changes.

Le préfixe openai/ indique à LiteLLM d'utiliser sa route OpenAI-compatible. L'ID de modèle envoyé à TokenHub est toujours la valeur après la barre oblique. Un simple identifiant n’indique pas de manière fiable à OpenHands quel fournisseur LiteLLM utiliser.

Démarrer une nouvelle conversation après avoir enregistré

OpenHands indique que les paramètres LLM s'appliquent par défaut à new conversations. Redémarrez une conversation existante si elle doit utiliser le nouveau modèle. Pour un premier test de connexion, créez une nouvelle conversation afin qu'un ancien profil LLM ne puisse pas affecter le résultat.

Testez la nouvelle conversation dans cet ordre :

  1. Demandez à OpenHands de lire et d'expliquer un fichier sans le modifier.
  2. Vérifiez l'ID du modèle, le code d'état et le chemin /v1/chat/completions dans les journaux TokenHub.
  3. Demandez-lui ensuite d'exécuter une commande de modification de fichier ou de terminal explicite et réversible.

OpenHands prévient également qu'il a besoin d'un modèle performant. Si le chat simple réussit mais que l'agent s'arrête à une étape de l'outil, le modèle peut manquer d'appel d'outil fiable ; cela ne signifie pas nécessairement que la base URL a été perdue.

Dépanner champ par champ

  • Model not found ou une erreur de routage LiteLLM : confirmez que Custom Model est openai/EXACT_MODEL_ID.
  • 401 : enregistrez à nouveau API Key et n'incluez pas de préfixe Bearer .
  • 404 : Base URL doit se terminer par /v1, et non par /chat/completions.
  • Les requêtes utilisent toujours l'ancien modèle : redémarrez cette conversation ou créez-en une nouvelle.
  • Le texte fonctionne mais pas les outils : choisissez un modèle TokenHub avec des appels de fonctions natifs documentés.

Référence officielle

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ LLM personnalisée OpenHands

Comment configurer un LLM personnalisé dans OpenHands ?

Ouvrez Paramètres → LLM → Avancé, définissez le modèle personnalisé sur openai/<TokenHub Model ID>, puis saisissez l'URL de base et la clé API TokenHub /v1.

Pourquoi le modèle OpenHands a-t-il besoin d'un préfixe openai/ ?

OpenHands utilise le routage LiteLLM. Le préfixe indique à LiteLLM d'envoyer l'ID de modèle suivant exact via un transport compatible OpenAI.

Pourquoi une conversation OpenHands existante a-t-elle conservé l'ancien modèle ?

Les paramètres LLM enregistrés ne peuvent pas remplacer un profil de conversation existant. Démarrez ou redémarrez une conversation et inspectez le profil LLM actif.

Quels modèles conviennent à OpenHands ?

Utilisez un modèle de codage avec des appels d'outils natifs fiables et suffisamment de contexte pour la tâche. Un modèle qui ne discute que ne peut pas faire fonctionner de manière fiable le terminal, le navigateur et les outils de fichiers.

Comment tester OpenHands en toute sécurité ?

Utilisez un référentiel de test et commencez par une explication ou une recherche en lecture seule. Vérifiez les journaux TokenHub, puis autorisez progressivement les modifications de fichiers et les commandes.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。

Comparez les réglages et la compatibilité de modèles d’outils similaires.

Claude CodeAnthropic CompatibleCodexOpenAI CompatibleQwen CodeOpenAI CompatibleZCodeOpenAI / Anthropic