OpenCode AI Gateway: Verbinden Sie mehrere LLMs über eine API

Ein OpenCode AI-Gateway bietet Ihnen eine stabile API-Schicht zwischen Ihrem Terminal-Workflow und den Modellen, die Sie tatsächlich verwenden möchten. Wenn Sie mit separaten Anbieter-Schlüsseln, separaten Abrechnungsseiten und separaten Verfügbarkeitsrisiken jonglieren, kann diese zusätzliche Schicht OpenCode im täglichen Betrieb erheblich erleichtern.

ShareAI erfüllt diese Rolle gut, da es Ihnen eine API für über 150 Modelle bietet, plus intelligentes Routing, Failover und Marktplatz-Sichtbarkeit. OpenCode unterstützt bereits benutzerdefinierte OpenAI-kompatible Anbieter, sodass die Einrichtung hauptsächlich darin besteht, OpenCode auf die richtige Basis-URL zu verweisen und das Modell hinzuzufügen, das Sie verwenden möchten.

Dieser Leitfaden ist Teil unserer Entwickler Artikel über AI-Routing, Modellzugriff und produktionsreife Integrationen.

Warum überhaupt ein OpenCode AI-Gateway verwenden?

OpenCode ist darauf ausgelegt, mit vielen Anbietern zu arbeiten, und seine öffentlichen Dokumentationen zeigen Unterstützung für benutzerdefinierte Anbieter-Konfigurationen, benutzerdefinierte baseURL Werte und OpenAI-kompatible Endpunkte. Diese Flexibilität ist leistungsstark, bedeutet aber auch, dass Sie jeden Anbieter separat verwalten können, wenn Sie eigentlich nur einen sauberen Coding-Workflow möchten.

• Ein API-Schlüssel statt eines Schlüssels pro Modellanbieter.
• Eine Abrechnungsoberfläche statt mehrerer Dashboards.
• Einfacheres Wechseln zwischen Modellen für schnelle Bearbeitungen, Aufgaben mit langem Kontext oder umfangreichere Überarbeitungen.
• Eine Routing-Schicht, die helfen kann, wenn ein Anbieter langsam, nicht verfügbar oder nicht mehr die beste Wahl für die Aufgabe ist.

Für Entwickler, die Flexibilität wünschen, ohne separate Anbieter-Infrastruktur zu pflegen, ist dies normalerweise der Punkt, an dem sich ein AI-Gateway auszahlt.

Wie OpenCode diese Einrichtung unterstützt

Laut den offiziellen OpenCode-Anbieter-Dokumentation, Sie können die Anbieter-Einstellungen anpassen über opencode.json, eine benutzerdefinierte baseURL, und verwenden @ai-sdk/openai-kompatibel für OpenAI-kompatible Anbieter. Das öffentliche OpenCode-GitHub-Repository dokumentiert auch seine Konfigurationspfade und bestätigt, dass das Tool für Anbieter-Flexibilität entwickelt wurde.

Das bedeutet, dass Sie kein spezielles ShareAI-Integrationspaket benötigen, um loszulegen. Sie können ShareAI als benutzerdefinierten Anbieter hinzufügen, Ihren API-Schlüssel in einer Umgebungsvariable speichern und dann das genaue Modell auswählen, das OpenCode aufrufen soll.

Schritt 1: Erstellen Sie Ihren ShareAI-API-Schlüssel und wählen Sie ein Modell aus

Beginnen Sie mit der Erstellung von Zugangsdaten in Erstellen Sie einen API-Schlüssel. Durchsuchen Sie dann die ShareAI-Modellmarktplatz , um zu entscheiden, welches Modell Ihren OpenCode-Workflow unterstützen soll.

Ein praktisches Muster ist, ein Standardmodell für alltägliche Codierungsaufgaben auszuwählen und ein oder zwei Alternativen im Kopf zu behalten für Fälle, in denen Sie geringere Latenz, geringere Kosten oder ein stärkeres Argumentationsmodell wünschen.

Schritt 2: Fügen Sie ShareAI als benutzerdefinierten Anbieter in opencode.json hinzu

OpenCode ermöglicht es Ihnen, einen benutzerdefinierten Anbieter mit einem OpenAI-kompatiblen Endpunkt zu definieren. Eine einfache Startvorlage sieht so aus:

{
  "$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"
        }
      }
    }
  }
}

Ersetzen Ihr-ShareAI-Modell mit der genauen Modellkennung, die Sie aus dem ShareAI-Modellkatalog verwenden möchten. Halten Sie den API-Schlüssel aus der Datei selbst heraus und laden Sie ihn stattdessen über eine Umgebungsvariable.

export SHAREAI_API_KEY="your_api_key_here"

Wenn Sie das breitere Anforderungsformat und die Authentifizierungsdetails wünschen, API-Referenz deckt den Kernablauf der ShareAI-API ab.

Schritt 3: Wechseln Sie Modelle, ohne Ihre Einrichtung neu aufzubauen

Sobald ShareAI die Anbieter-Ebene ist, werden Modelländerungen viel einfacher. Sie müssen nicht mehr jedes Mal die Anbieter-Authentifizierung überarbeiten, wenn Sie ein anderes Modell testen möchten. Stattdessen behalten Sie dieselbe API-Oberfläche und ändern das Modell, auf das OpenCode verweist.

Das ist besonders nützlich, wenn sich Ihr Coding-Workflow je nach Aufgabe ändert. Sie könnten ein Modell für schnelle Bearbeitungen, ein anderes für größere Repository-Analysen und ein drittes als Rückfalloption verwenden, wenn Kosten oder Latenz wichtiger sind als maximale Leistung. Sie können Optionen vergleichen im Modell-Marktplatz und das Verhalten überprüfen im Spielplatz bevor Sie einen Standard festlegen.

Wann direkte Anbieter-Schlüssel weiterhin sinnvoll sind

Es gibt immer noch Fälle, in denen ein direkter Ansatz vernünftig ist. Wenn Sie auf eine anbieter-spezifische Beta-Funktion, eine private Unternehmensvereinbarung oder eine strenge Governance-Einrichtung innerhalb des Anbieters angewiesen sind, möchten Sie diesen Weg möglicherweise getrennt halten.

Aber für Teams, die hauptsächlich möchten, dass OpenCode flexibel, portabel und einfacher zu bedienen bleibt, ist die Verwendung eines OpenCode-AI-Gateways oft die sauberere Standardoption. Es reduziert die Kontoausbreitung und ermöglicht es Ihnen, Modelle anhand von Leistung und Eignung zu bewerten, anstatt anhand des zuletzt konfigurierten Anbieter-Logins.

Fazit

Ein OpenCode-AI-Gateway geht nicht darum, mehr Tools hinzuzufügen, nur um der Sache willen. Es geht darum, einen einzigen Coding-Workflow beizubehalten, während Sie sich die Möglichkeit geben, Modelle zu wechseln, Anbieter zu vergleichen und weiterzumachen, wenn sich die zugrunde liegende Modelllandschaft verändert. Wenn das das ist, was Sie von OpenCode wollen, bietet Ihnen ShareAI eine praktische Möglichkeit, dies über eine API zu tun.