RisuAI Integrationsanleitung

Überblick

Über den Slot Custom Models in RisuAI können Sie eine Request URL, einen API key und eine Modell-ID einfügen. Der Haken: Ein Schalter namens Autofill Request URL; ist er aktiv, schreibt RisuAI die eingefügte URL um und bricht die Verbindung stillschweigend.

Quick Config

Kopieren Sie diese drei Werte in die Felder Custom Models in den Advanced Settings von RisuAI.

Request URL: https://api.unorouter.ai/v1/chat/completions
API Key:    YOUR_API_KEY
Modell-ID:   claude-opus-4-5

Fügen Sie die vollständige URL mit Endung `/v1/chat/completions` ein. RisuAI bietet im Modus Custom Models kein Modell-Dropdown; die Modell-ID ist ein manuelles Textfeld.

Schritt-für-Schritt-Einrichtung

1. 1
   Advanced Settings öffnen

   Öffnen Sie in RisuAI die Settings und anschließend Advanced Settings.

2. 2
   Einen Modell-Slot wählen

   Klicken Sie auf den Modell-Selektor Chat Bot, scrollen Sie an das Ende der Modellliste und wählen Sie Custom Models.

3. 3
   Autofill Request URL deaktivieren

   Dieser Schalter muss AUS sein, bevor Sie irgendetwas einfügen. Siehe die wichtige Warnung oben.

4. 4
   Request URL einfügen

   Fügen Sie die vollständige URL mit Endung `/v1/chat/completions` ein.

5. 5
   API Key einfügen

   Fügen Sie Ihren UnoRouter API key in das Feld API Key ein. Manche RisuAI-Builds bezeichnen dieses Feld als Authorization; verwenden Sie dieses Feld, falls API Key nicht erscheint.

6. 6
   Modell-ID einfügen

   Tippen oder fügen Sie den exakten Modellnamen von der Modelle-Seite von UnoRouter ein.

7. 7
   Speichern

   Schließen Sie das Settings-Panel; RisuAI schreibt die Konfiguration in den localStorage.

8. 8
   Testnachricht senden

   Öffnen Sie einen beliebigen Chat und senden Sie eine Testnachricht, um die Antwort zu prüfen.

Warum der Autofill-Schalter wichtig ist

Autofill Request URL wurde eingeführt, um Tippfehler bei benannten Preset-Anbietern zu verhindern. Für Custom Models wird er zur Stolperfalle: RisuAI schreibt Ihre Custom-URL auf einen Standardwert um, der nicht auf uns zeigt. Falls ein RisuAI-Update diesen Schalter wieder aktiviert, wiederholen Sie Schritt 3, bevor Sie irgendetwas anderes debuggen.

Auxiliary Model konfigurieren

RisuAI nutzt einen zweiten Modell-Slot für Übersetzung, Zusammenfassung und das Erraten von Namen. Wiederholen Sie die Schritte 2 bis 7 für den Selektor Auxiliary Model mit derselben UnoRouter-URL und demselben Schlüssel.

Fehlerbehebung

• 404 oder 'Invalid URL'. Autofill Request URL war beim Einfügen aktiv; RisuAI hat die URL umgeschrieben. Deaktivieren Sie den Schalter und fügen Sie die Request URL erneut ein.
• Hat vorher funktioniert, jetzt keine Antwort. Ein RisuAI-Update kann Autofill Request URL stillschweigend wieder aktivieren. Öffnen Sie Custom Models und prüfen Sie, ob er weiterhin deaktiviert ist.
• 401 Unauthorized. RisuAI-Builds zeigen manchmal sowohl API Key als auch Authorization an; je nach Version wird nur eines ausgelesen. Verschieben Sie Ihren Schlüssel in das andere Feld und versuchen Sie es erneut.
• Model not found. Die Modell-ID muss exakt einem Modellnamen entsprechen. Kopieren Sie den Wert von der Modelle-Seite von UnoRouter; tippen Sie ihn nicht ab.
• Übersetzung oder Zusammenfassung funktioniert nicht. Das Auxiliary Model ist nicht konfiguriert. Wiederholen Sie das Setup für den Auxiliary-Model-Slot.
• Streaming-Ausgabe ist stückweise oder unvollständig. Der SSE-Parser von RisuAI erwartet reine `data:`-Events. Ein Unternehmens-Proxy, der das Präfix entfernt, erzeugt fehlerhaftes Streaming. Testen Sie nach Möglichkeit in einem Netz ohne Unternehmens-Proxy.
• Einstellungen werden nach Neustart des Browsers zurückgesetzt. RisuAI speichert die Konfiguration im localStorage, den manche Privatsphäre-Modi leeren. Exportieren Sie Ihre Konfiguration aus den Settings in eine Datei als Backup.