Chub / Venus Integrationsanleitung

Überblick

Das Secrets-Panel von Chub akzeptiert eine vollständige URL `/v1/chat/completions` sowie Ihren API key. Eine Schaltfläche Check your proxy prüft die Verbindung, bevor Sie in Prompt Structure ein Modell auswählen.

Quick Config

Kopieren Sie diese beiden Werte in die Reverse-proxy-Felder im Secrets-Panel von Chub.

URL: https://api.unorouter.ai/v1/chat/completions
Key: YOUR_API_KEY

Fügen Sie die vollständige URL mit Endung `/v1/chat/completions` ein. Chub erwartet den vollständigen Pfad; fügen Sie nicht nur die base URL ein.

Schritt-für-Schritt-Einrichtung

1. 1
   Secrets-Panel öffnen

   Klicken Sie oben rechts in Chub auf das Hamburger-Menü und wählen Sie Secrets.

2. 2
   OpenAI ausklappen

   Klicken Sie auf den Abschnitt OpenAI, um ihn auszuklappen.

3. 3
   Zu Reverse proxy scrollen

   Der Unterabschnitt Reverse proxy enthält die Felder URL und Key sowie die Schaltfläche Check your proxy.

4. 4
   URL und Key einfügen

   Die URL endet auf `/v1/chat/completions`. Key ist Ihr UnoRouter API key.

5. 5
   Auf Check your proxy klicken

   Warten Sie auf die grüne Bestätigung. Schlägt sie fehl, prüfen Sie die URL und fügen Sie den Schlüssel erneut ein.

6. 6
   Configuration öffnen

   Gehen Sie zurück in das Hamburger-Menü, wählen Sie Configuration und anschließend Prompt Structure.

7. 7
   OpenAI und Modell wählen

   Setzen Sie das API-Dropdown auf OpenAI und wählen Sie dann im Modell-Dropdown Ihr Ziel-Modell.

Das Modell-Dropdown benötigt eine bestandene Proxy-Prüfung

Chub befüllt das Modell-Dropdown in Prompt Structure erst, nachdem die Proxy-Prüfung erfolgreich war. Ist das Dropdown leer, gehen Sie zurück und führen Sie Check your proxy unter Secrets > OpenAI > Reverse proxy erneut aus.

Fehlerbehebung

• Die Schaltfläche Check your proxy schlägt fehl. Die URL ist falsch. Sie muss auf `/v1/chat/completions` enden; die base URL allein reicht nicht.
• Modell-Dropdown ist leer. Die Proxy-Prüfung ist noch nicht bestanden. Führen Sie Schritt 5 erneut aus und warten Sie auf den grünen Status.
• Antworten kommen leer zurück. In Prompt Structure ist die falsche API ausgewählt. Öffnen Sie Configuration > Prompt Structure und stellen Sie das API-Dropdown auf OpenAI.
• 401 Unauthorized. Ihr API key wurde rotiert oder enthält einen Tippfehler. Erzeugen Sie einen neuen Schlüssel in Ihrem UnoRouter-Dashboard und fügen Sie ihn erneut unter Reverse proxy ein.
• Warnung zur Kontextlänge. Reduzieren Sie den maximalen Kontext in Prompt Structure oder wählen Sie auf der Modelle-Seite von UnoRouter ein Modell mit größerem Kontext.
• Nach einem Reload meldet die Proxy-Prüfung Pass, Nachrichten schlagen aber fehl. Chub puffert den Zustand der Proxy-Prüfung über Sessions hinweg. Klicken Sie in einer neuen Session einmal auf Check your proxy, um eine frische Prüfung zu erzwingen.