OpenCode mit APIMaster.ai

Fügen Sie APIMaster als OpenAI-kompatiblen Anbieter in OpenCode Desktop hinzu, mit optionalen Reasoning-Stufen über opencode.jsonc.

OpenCode Desktop ist der grafische Client für OpenCode (derzeit Beta): lokale Agent-Sitzungen, Dateibearbeitungen und Shell-Ausführungen. APIMaster.ai ist OpenAI-kompatibel — fügen Sie es unter Einstellungen → Anbieter → Benutzerdefinierter Anbieter hinzu.

Holen Sie sich zuerst Ihren API-Schlüssel. Verwenden Sie unten den Platzhalter your_apimaster_key; Screenshots maskieren echte Schlüssel.

Voraussetzungen

OpenCode Desktop installiert von opencode.ai/download.
- Windows: opencode-desktop-win-x64.exe
- macOS: brew install --cask opencode-desktop oder .dmg
- Linux: .deb / .rpm / AppImage
APIMaster API-Schlüssel aus der Konsole.

Schritt 1 — Anbieter öffnen

Starten Sie OpenCode Desktop und öffnen Sie einen Arbeitsbereich.
Klicken Sie auf das Zahnrad-Symbol (unten links).
Wählen Sie Anbieter in der Seitenleiste.
Scrollen Sie zu Benutzerdefinierter Anbieter (Fügen Sie einen OpenAI-kompatiblen Anbieter per Basis-URL hinzu).
Klicken Sie auf + Verbinden.

Einstellungen → Anbieter → Benutzerdefinierter Anbieter

Schritt 2 — Benutzerdefiniertes Anbieterformular

Feld	Wert
Anbieter-ID	`apimaster`
Anzeigename	`APIMaster.ai`
Basis-URL	`https://apimaster.ai/v1`
API-Schlüssel	Ihr APIMaster-Schlüssel

Benutzerdefiniertes Anbieterformular

Lassen Sie Header leer, es sei denn, Sie authentifizieren sich nur über Header.

Schritt 3 — Modelle hinzufügen & absenden

Auf dem nächsten Bildschirm ordnen Sie Modelle zu (links = Bezeichnung in OpenCode, rechts = Modell-ID, die an APIMaster gesendet wird — normalerweise identisch):

Links	Rechts
`gpt-5.4`	`gpt-5.4`
`claude-sonnet-4-6`	`claude-sonnet-4-6`

Klicken Sie auf + Modell hinzufügen für weitere Zeilen.
Klicken Sie auf Absenden.

Modelle hinzufügen und absenden

Wählen Sie IDs aus dem Marktplatz. Vermeiden Sie reine Bildmodelle (z. B. gpt-image-2) für Agent-Chats.

Schritt 4 — Ein Modell auswählen

Starten oder öffnen Sie eine Sitzung.
Öffnen Sie das Modell-Dropdown unterhalb der Eingabe.
Wählen Sie unter APIMaster.ai ein Modell aus (z. B. claude-sonnet-4-6).

Modellauswahl

Schritt 5 — Testen

Senden Sie hallo oder eine kleine Programmieraufgabe. Eine normale Assistant-Antwort (Dateibearbeitungen / Shell) bedeutet, dass APIMaster verbunden ist.

Chat-Test

Fortgeschritten: `opencode.jsonc` & Reasoning

Der obige UI-Ablauf ist für einen schnellen Start ausreichend. Um Reasoning / Thinking-Effort-Stufen (low, high, max, …) für dieselbe Modell-ID zu konfigurieren, bearbeiten Sie opencode.jsonc.

Konfigurationsdatei-Speicherort

Betriebssystem	Pfad
macOS / Linux	`~/.config/opencode/opencode.jsonc`
Windows	`C:\Users\<benutzername>\.config\opencode\opencode.jsonc`

Erstellen Sie die Datei, falls sie fehlt. Starten Sie OpenCode Desktop neu oder beginnen Sie eine neue Sitzung nach dem Speichern.

API-Schlüssel (nicht in jsonc speichern)

Speichern Sie Ihren API-Schlüssel nicht in opencode.jsonc.

Verwenden Sie:

/connect im Terminal, oder
Einstellungen → Anbieter → Anbieter verbinden (wie in Schritten 1–2 oben).

Bewahren Sie Geheimnisse im Authentifizierungsspeicher von OpenCode auf; jsonc definiert nur Anbieter, Modelle und Reasoning-Varianten.

APIMaster-Anbieter in jsonc

Anbieter-ID: apimaster. npm-Paket: @ai-sdk/openai-compatible.

baseURL muss sein:

https://apimaster.ai/v1

Nicht https://apimaster.ai/ — OpenCode hängt /chat/completions an. Ohne /v1 erhalten Sie https://apimaster.ai/chat/completions → 404 Nicht gefunden.

Vollständiges Beispiel mit Reasoning-Varianten — herunterladen und die Konfiguration von OpenCode überschreiben:

Laden Sie opencode.jsonc herunter
Überschreiben (oder speichern als):
- macOS / Linux: ~/.config/opencode/opencode.jsonc
- Windows: C:\Users\<benutzername>\.config\opencode\opencode.jsonc
Konfigurieren Sie den API-Schlüssel über /connect oder die UI (niemals in jsonc).
Starten Sie OpenCode Desktop neu oder beginnen Sie eine neue Sitzung.

Sichern Sie Ihre vorhandene Datei vor dem Überschreiben oder führen Sie nur den Block provider.apimaster zusammen.

Minimale Struktur:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apimaster": {
      "name": "APIMaster.ai",
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://apimaster.ai/v1" },
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4",
          "variants": {
            "low": { "reasoningEffort": "low" },
            "high": { "reasoningEffort": "high" }
          }
        }
      }
    }
  }
}

Reasoning-Prinzipien

variants = mehrere Reasoning-Stufen für eine Modell-ID in der UI.
Für OpenAI-kompatible APIs bildet OpenCode reasoningEffort → reasoning_effort im Anforderungstext ab.
Variantennamen sollten dem tatsächlichen Parameter entsprechen (high → "reasoningEffort": "high").
Jedes Modell unterstützt unterschiedliche Stufen — konfigurieren Sie gemäß der offiziellen Dokumentation; keine versteckte Neuzuordnung.

Reasoning-Stufen nach Modell

Modell	Reasoning-Varianten	Hinweise
`gpt-5.4`	`low`, `medium`, `high`, `xhigh`	GPT-Reasoning
`gpt-5.5`	`low`, `medium`, `high`, `xhigh`	GPT-Reasoning
`deepseek-v4-flash`	`high`, `max`	DeepSeek-Denken (empfohlen)
`deepseek-v4-pro`	`high`, `max`	DeepSeek-Denken (empfohlen)
`claude-sonnet-4-6`	`low`, `medium`, `high`, `max`	Claude Sonnet-Aufwand
`claude-opus-4-7`	`low`, `medium`, `high`, `xhigh`, `max`	Claude Opus-Aufwand
`claude-opus-4-8`	`low`, `medium`, `high`, `xhigh`, `max`	Claude Opus-Aufwand
`claude-haiku-4-5`	keine	Keine unbestätigten Aufwandstufen
`minimax-m3`	keine	Keine unbestätigten Aufwandstufen

Siehe opencode.jsonc für die vollständige Datei.

Reasoning in OpenCode wechseln

Speichern Sie opencode.jsonc, dann neu starten oder neue Sitzung.
Verwenden Sie das Modell-/Reasoning-Dropdown (z. B. gpt-5.4 / high).
Falls in Ihrem Build unterstützt: Strg + Umschalt + D durchläuft die Reasoning-Stufen.

Fehlerbehebung

UI-Einrichtung

Problem	Lösung
401	Schlüssel prüfen; bei Offenlegung rotieren
Modell nicht gefunden	Basis-URL muss `https://apimaster.ai/v1` sein; Modell-ID muss mit dem Marktplatz übereinstimmen
Keine APIMaster-Modelle	Anbieter in Einstellungen bearbeiten → Zuordnungen hinzufügen → Absenden
Langsam / Zeitüberschreitung	Versuchen Sie ein anderes Modell; verwenden Sie den API-Schlüssel-Tester

Reasoning / jsonc

Warum nur high und max für DeepSeek?
Der offizielle OpenAI-kompatible Denkaufwand für DeepSeek ist high und max. Vermeiden Sie low / medium / xhigh, die unvorhersehbar neu zugeordnet werden.

Warum max für Claude Sonnet, nicht xhigh?
Die höchste Stufe von Sonnet ist max; xhigh ist für Opus (claude-opus-4-7 / claude-opus-4-8).

Warum keine Varianten für Haiku oder MiniMax M3?
Ohne dokumentierte reasoningEffort-Werte überspringen Sie Varianten — das Modell funktioniert trotzdem; die UI zeigt nur keine Reasoning-Unterstufen an.

Erhalten Sie immer noch 400?

baseURL = https://apimaster.ai/v1 (nicht die Site-Root).
Die Schreibweise der Modell-ID stimmt mit dem Marktplatz überein.
Schlüssel über /connect oder UI konfiguriert.
Entfernen Sie vorübergehend variants — wenn einfache Anfragen funktionieren, ist das gewählte reasoning_effort möglicherweise für dieses Modell nicht unterstützt.

Sicherheit

Teilen Sie niemals Schlüssel im Chat oder in ungeschwärzten Screenshots.
Rotieren Sie Schlüssel, die in Screenshots oder Logs aufgetaucht sind.
OpenCode kann Dateien lesen/schreiben und Shell-Befehle ausführen — verwenden Sie nur vertrauenswürdige Arbeitsbereiche.

Checkliste

OpenCode Desktop installiert
Benutzerdefinierter Anbieter verbunden oder apimaster in opencode.jsonc
Basis-URL / baseURL = https://apimaster.ai/v1 (nicht https://apimaster.ai/)
API-Schlüssel über /connect oder UI (nicht in jsonc)
Mindestens ein Chat-Modell zugeordnet
(Optional) Reasoning-Varianten entsprechen den offiziellen Stufen
Testnachricht erfolgreich

Zusammenfassung

Schlüssel: baseURL (https://apimaster.ai/v1), Modell-ID, API-Schlüssel (/connect oder UI), optionale Reasoning-Varianten.
Varianten-Namen = tatsächliche reasoning_effort-Werte.
Konfigurieren Sie Stufen pro Modell; überspringen Sie Varianten, wenn nicht unterstützt (Haiku, MiniMax M3).