Zum Hauptinhalt springen
OpenCode ist ein KI-Coding-Agent fürs Terminal. Venice funktioniert über die Custom-Provider-Konfiguration von OpenCode mit dem OpenAI-kompatiblen Adapter und einer eigenen Base URL.

Custom Provider

Venice als Provider in opencode.json hinzufügen

OpenAI-kompatibel

Verwendet Venices /chat/completions-Endpoint

Umgebungs-Key

Liest deinen API-Schlüssel aus VENICE_API_KEY

Voraussetzungen

  • Ein Venice API-Schlüssel von venice.ai/settings/api
  • OpenCode installiert und einsatzbereit auf deinem Rechner

Einrichtung

1

Venice API-Schlüssel setzen

Exportiere deinen Venice API-Schlüssel in der Shell, in der du OpenCode ausführst:
export VENICE_API_KEY="your-api-key"
2

OpenCode-Konfigurationsdatei erstellen

Für ein projekt-spezifisches Setup erstelle opencode.json im Projekt-Root.Für ein globales Setup verwende stattdessen ~/.config/opencode/opencode.json.
3

Venice-Provider hinzufügen

Füge folgende Konfiguration in opencode.json ein:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "venice/zai-org-glm-5-1",
  "small_model": "venice/zai-org-glm-5-1",
  "provider": {
    "venice": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Venice AI",
      "options": {
        "baseURL": "https://api.venice.ai/api/v1",
        "apiKey": "{env:VENICE_API_KEY}"
      },
      "models": {
        "zai-org-glm-5-1": {
          "name": "GLM 5.1"
        },
        "kimi-k2-5": {
          "name": "Kimi K2.5"
        },
        "minimax-m25": {
          "name": "MiniMax M2.5"
        }
      }
    }
  }
}
4

OpenCode starten

Starte OpenCode aus demselben Projektverzeichnis:
opencode
OpenCode lädt opencode.json, verwendet VENICE_API_KEY und routet das ausgewählte Venice-Modell über https://api.venice.ai/api/v1.

Setup überprüfen

Führe in OpenCode aus:
/models
Du solltest die in deiner Konfiguration definierten Venice-Modelle sehen. Wähle eines aus und sende einen kleinen Test-Prompt. Wenn du wie oben "model": "venice/zai-org-glm-5-1" gesetzt hast, sollte OpenCode dieses Venice-Modell standardmäßig verwenden. Du kannst den Default ändern, indem du zai-org-glm-5-1 durch eine andere Modell-ID aus dem Textmodell-Katalog ersetzt und sie in die models-Map aufnimmst.

Konfigurations-Hinweise

  • Belasse baseURL auf https://api.venice.ai/api/v1. OpenCodes OpenAI-kompatibler Adapter verwendet diese Base URL für Chat-Completions.
  • Belasse npm auf @ai-sdk/openai-compatible für Venices OpenAI-kompatiblen Chat-Endpoint.
  • Die Provider-ID ist venice, deshalb verwenden Modell-Referenzen das Format venice/<model-id>.
  • Bevorzugst du OpenCodes /connect-Flow, wähle Other, verwende venice als Provider-ID, füge deinen Venice API-Schlüssel ein und entferne options.apiKey aus der Konfiguration.
OpenCode unterstützt bereits Custom-Provider-baseURL-Werte und OpenAI-kompatible Provider über @ai-sdk/openai-compatible. Es sind keine Änderungen am OpenCode-Core-Provider für Venice nötig.

Ressourcen

Venice Textmodelle

Verfügbare Venice-Modell-IDs

OpenCode-Provider-Doku

Custom-Provider- und Base-URL-Referenz