Passerelle OpenCode AI : Connectez plusieurs LLM via une seule API

Une passerelle OpenCode AI vous offre une couche API stable entre votre flux de travail terminal et les modèles que vous souhaitez réellement utiliser. Si vous jonglez avec des clés de fournisseurs distinctes, des pages de facturation distinctes et des risques de disponibilité distincts, cette couche supplémentaire peut rendre OpenCode beaucoup plus facile à utiliser au quotidien.

ShareAI remplit bien ce rôle car il vous offre une API pour plus de 150 modèles, ainsi qu'un routage intelligent, un basculement et une visibilité sur le marché. OpenCode prend déjà en charge les fournisseurs personnalisés compatibles avec OpenAI, donc la configuration consiste principalement à pointer OpenCode vers la bonne URL de base et à ajouter le modèle que vous souhaitez utiliser.

Ce guide fait partie de nos Développeurs articles sur le routage AI, l'accès aux modèles et les intégrations prêtes pour la production.

Pourquoi utiliser une passerelle OpenCode AI en premier lieu ?

OpenCode est conçu pour fonctionner avec de nombreux fournisseurs, et sa documentation publique montre un support pour la configuration de fournisseurs personnalisés, des valeurs baseURL.

• et des points de terminaison compatibles avec OpenAI. Cette flexibilité est puissante, mais cela signifie également que vous pouvez finir par gérer chaque fournisseur séparément alors que tout ce que vous voulez vraiment est un flux de travail de codage propre.
• Une clé API au lieu d'une clé par fournisseur de modèle.
• Une surface de facturation au lieu de plusieurs tableaux de bord.
• Un changement plus fluide entre les modèles pour des modifications rapides, des tâches à long contexte ou des refactorisations plus lourdes.

Une couche de routage qui peut aider lorsqu'un fournisseur est lent, indisponible ou n'est plus le meilleur choix pour le travail.

Pour les développeurs qui souhaitent de la flexibilité sans avoir à maintenir une plomberie de fournisseurs distincts, c'est généralement à ce moment-là qu'une passerelle AI commence à être rentable.

Comment OpenCode prend en charge cette configuration Documentation du fournisseur OpenCode, vous pouvez personnaliser les paramètres du fournisseur via opencode.json, définir un valeurs, personnalisé, et utiliser @ai-sdk/openai-compatible pour les fournisseurs compatibles avec OpenAI. Le dépôt public GitHub d'OpenCode documente également ses chemins de configuration et confirme que l'outil est conçu pour une flexibilité au niveau du fournisseur.

Cela signifie que vous n'avez pas besoin d'un package d'intégration ShareAI spécial pour commencer. Vous pouvez ajouter ShareAI comme fournisseur personnalisé, conserver votre clé API dans une variable d'environnement, puis choisir le modèle exact que vous souhaitez qu'OpenCode utilise.

Étape 1 : Créez votre clé API ShareAI et choisissez un modèle

Commencez par générer des identifiants dans Créer une clé API. Ensuite, parcourez le marché des modèles ShareAI pour décider quel modèle doit soutenir votre flux de travail OpenCode.

Un modèle pratique consiste à choisir un modèle par défaut pour les tâches de codage quotidiennes et à garder une ou deux alternatives en tête pour les cas où vous souhaitez une latence plus faible, un coût réduit ou un modèle de raisonnement plus puissant.

Étape 2 : Ajoutez ShareAI comme fournisseur personnalisé dans opencode.json

OpenCode vous permet de définir un fournisseur personnalisé avec un point de terminaison compatible OpenAI. Un modèle de départ simple ressemble à ceci :

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

Remplacer votre-modèle-shareai avec l'identifiant exact du modèle que vous souhaitez utiliser à partir du catalogue de modèles ShareAI. Gardez la clé API hors du fichier lui-même et chargez-la via une variable d'environnement à la place.

export SHAREAI_API_KEY="votre_clé_api_ici"

Si vous souhaitez le format de requête plus large et les détails d'authentification, le Référence API couvre le flux principal de l'API ShareAI.

Étape 3 : Changez de modèles sans reconstruire votre configuration

Une fois que ShareAI est la couche fournisseur, les changements de modèle deviennent beaucoup plus légers. Vous n'avez plus besoin de retravailler l'authentification du fournisseur chaque fois que vous souhaitez tester un modèle différent. À la place, vous conservez la même surface API et changez le modèle vers lequel vous pointez OpenCode.

Cela est particulièrement utile lorsque votre flux de travail de codage change selon la tâche. Vous pourriez vouloir un modèle pour des modifications rapides, un autre pour un raisonnement sur un dépôt plus large, et un troisième comme solution de secours lorsque le coût ou la latence compte plus que la capacité maximale. Vous pouvez comparer les options dans le marché de modèles transparent et vérifier le comportement dans le Terrain de jeu avant de verrouiller un modèle par défaut.

Quand les clés de fournisseur direct restent pertinentes

Il existe encore des cas où aller directement est raisonnable. Si vous dépendez d'une fonctionnalité bêta spécifique au fournisseur, d'un accord d'entreprise privé ou d'une configuration stricte de gouvernance interne au fournisseur, vous pourriez vouloir garder cette voie séparée.

Mais pour les équipes qui souhaitent principalement qu'OpenCode reste flexible, portable et plus facile à utiliser, l'utilisation d'une passerelle OpenCode AI est souvent le choix par défaut le plus propre. Cela réduit la prolifération des comptes et vous permet d'évaluer les modèles en fonction de leurs performances et de leur adéquation, plutôt qu'en fonction du dernier fournisseur que vous avez configuré.

Conclusion finale

Une passerelle OpenCode AI ne consiste pas à ajouter plus d'outils pour le plaisir. Il s'agit de conserver un seul flux de travail de codage tout en vous donnant la possibilité de changer de modèles, de comparer les fournisseurs et de continuer à avancer lorsque le paysage des modèles sous-jacents évolue. Si c'est ce que vous attendez d'OpenCode, ShareAI vous offre un moyen pratique de le faire via une seule API.