Guide de configuration OpenCode

Aperçu

OpenCode lit les fournisseurs depuis une configuration JSON. Ajoutez UnoRouter avec l'adaptateur compatible OpenAI pour utiliser tous les modèles UnoRouter.

Configuration rapide

Collez ces valeurs dans le client. Votre clé se remplit automatiquement une fois connecté.

URL de base: https://api.unorouter.com/v1
Clé API: YOUR_API_KEY

Compatibilité

Configuration étape par étape

1. 1
   Ouvrir le fichier de configuration OpenCode

   Ouvrez votre configuration OpenCode dans un éditeur de texte. Créez le fichier s'il n'existe pas encore.

   WindowsmacOSLinux

   powershell

   $f = "$env:USERPROFILE\.config\opencode\opencode.json"
   md -Force (Split-Path $f) | Out-Null; New-Item $f -ea 0 | Out-Null; Invoke-Item $f

   Connectez-vous pour remplir automatiquement votre clé API

2. 2
   Remplacer le contenu du fichier

   Ajoutez le bloc fournisseur UnoRouter à votre configuration. Fusionnez-le dans le fichier existant en conservant vos blocs mcp ou agent.

   json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "unorouter-live": {
         "name": "UnoRouter",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "apiKey": "YOUR_API_KEY",
           "baseURL": "https://api.unorouter.com/v1"
         },
         "models": {
           "ling-3.1-flash:free": {},
           "agnes-3.0-flash:free": {},
           "minicpm5-2b:free": {},
           "k2-horizon:free": {},
           "qwen3.8-flash-next:free": {}
         }
       }
     }
   }

   Connectez-vous pour remplir automatiquement votre clé API

3. 3
   Vérifier le chargement des modèles

   Enregistrez le fichier et lancez opencode models dans un terminal. Chaque identifiant listé doit apparaître, préfixé par votre clé de fournisseur.

   bash

   opencode models

   Connectez-vous pour remplir automatiquement votre clé API

4. 4
   Choisir un modèle

   Ouvrez le sélecteur de modèles et basculez sur votre nouveau modèle. L'adaptateur gère le streaming et l'appel d'outils.

Modèles recommandés

Modèles gratuits compatibles ici. Collez n'importe quel id de modèle dans le client.

Points de vigilance

• !OpenCode ne propose aucune découverte dynamique de modèles pour les fournisseurs compatibles OpenAI. Chaque modèle souhaité doit figurer dans le bloc "models" avec son identifiant exact.
• !Ne nommez pas la clé du fournisseur simplement "unorouter". Cet identifiant existe déjà dans le registre models.dev, et OpenCode utilise alors sa liste plutôt que la vôtre, ce qui fait disparaître les modèles récents. Le suffixe "-live" ci-dessus évite le conflit.
• !Utilisez les identifiants exacts du catalogue UnoRouter. Supprimez tout préfixe de fournisseur ajouté par un copier-coller et conservez le suffixe :free lorsque l'identifiant en comporte un.
• !Une clé de fournisseur personnalisée sans bloc "models" ne charge aucun modèle, et le fournisseur disparaît totalement du sélecteur.