Oh My Pi

Ein Anbieterblock in ~/.omp/agent/models.yml — baseUrl, api, apiKey — richtet Oh My Pi auf Kunavo aus; die Erkennung lädt die Modellliste über GET /v1/models.

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1
    api: openai-completions
    apiKey: KUNAVO_API_KEY       # an env-var name; literal text also works
    discovery:
      type: openai-models-list   # reads GET /v1/models

# Prefer a fixed list to a discovered one? Drop the discovery block and
# declare ids instead. Omitted metadata defaults to a 128,000-token context
# window and a 16,384-token output limit, so set the real numbers from
# /models when they differ.
#
#     models:
#       - id: claude-sonnet-5
#         name: Claude Sonnet 5
#         contextWindow: ...
#         maxTokens: ...

Schritt für Schritt

1. Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
2. Exportiere den Wert als KUNAVO_API_KEY in der Shell, mit der du omp startest. omp behandelt apiKey zunächst als Namen einer Umgebungsvariablen und verwendet den Text andernfalls direkt als Schlüssel. Ein Tippfehler im Variablennamen wird daher stillschweigend übernommen und führt erst bei der ersten Anfrage zu einem Fehler. Ein mit ! beginnender Wert wird stattdessen als Shell-Befehl ausgeführt – das ist die 1Password-Variante.
3. Füge den obigen Block in ~/.omp/agent/models.yml ein. Die Anbieter-ID – hier kunavo – kannst du selbst wählen; sie bildet die erste Hälfte jedes Auswahlfelds.
4. Führe omp models kunavo aus, um die Datei zu laden und nur diesen Anbieter aufzulisten. Bei einem YAML- oder Schemafehler werden models.yml validation failed und das fehlerhafte Feld ausgegeben. Mit omp models refresh kunavo erzwingst du einen neuen Erkennungsaufruf, statt den zwischengespeicherten Katalog zu verwenden.
5. Teste die Konfiguration mit einem exakten Auswahlwert: omp -p --model kunavo/claude-sonnet-5 "Reply with only OK". Starte dann omp, gib /model ein und weise Standard die gewünschte ID zu – beim Öffnen lädt der Modell-Hub models.yml neu. /switch ändert nur die aktuelle Sitzung.

Abgeglichen mit Die Seite „Anbieter“ von omp am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in Oh My Pi.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Erkennung: Welcher Typ und was im Auswahlmenü erscheint

omp bietet sechs Werte für discovery.type. Zwei davon scheinen für ein Gateway geeignet, doch nur einer ist es tatsächlich. proxy ist dokumentiert für „einen gemischten OpenAI-/Anthropic-Proxy, dessen Modellzeilen supported_endpoint_types angeben“. Anhand dieses Feldes wird für jedes Modell das jeweilige Drahtformat bestimmt. Kunavos GET /v1/models gibt dieses Feld nicht aus. Bei proxy würde daher jede Zeile auf die anbieterweite Einstellung api zurückfallen oder ganz entfallen, falls nichts festgelegt wurde. Zu verwenden ist openai-models-list, dokumentiert als „allgemeiner OpenAI-kompatibler GET /v1/models-Endpunkt“. Deshalb enthält der obige Block weiterhin api: openai-completions: Laut omp gilt „Mit Ausnahme von proxy erfordert die Erkennung ein anbieterweites api“.

Beachte eine Folge, bevor du das Auswahlmenü öffnest: Kunavos Modellliste enthält den gesamten aktivierten Katalog. Bei einem erkannten Anbieter erscheinen daher neben den Chat-IDs auch Bild-, Video- und Musik-IDs, die sich über den Chat-Transport nicht aufrufen lassen. Für Chat-Modelle stellt Kunavo context_length bereit. Laut Modelldokumentation liest die allgemeine Erkennung von omp dieses Feld nach max_model_len aus. Bei Medienmodellen fehlt es, sodass omp für diese den Standardwert von 128,000 Token annimmt statt eines echten Werts. Wenn du ein kurzes, korrektes Auswahlmenü möchtest, entferne den Erkennungsblock und gib die drei oder vier IDs an, die du tatsächlich verwendest.

omp unterstützt auch anthropic-messages, und Kunavo antwortet mit /v1/messages. Diese Seite enthält kein Konfigurationsbeispiel für diese Kombination: Die beiden hier zitierten Seiten legen das Basis-URL-Format für die OpenAI-kompatible Route fest, sagen aber nichts darüber aus, wie ein abschließendes /v1 bei der Anthropic-Route behandelt wird. Ein Konfigurationsblock soll schließlich direkt kopierbar sein. Wenn du diesen Weg wählst, findest du unter disableStrictTools: true die dokumentierte Lösung für Tool-Aufrufe, die an einem Anthropic-kompatiblen Endpunkt mit einem 400-Fehler scheitern.