Files
BoosAPI/desktop/website/docs/de/guide/providers.md
T
boos e0a5f57793 feat(desktop): embed BoosAPI Desktop client as a subproject
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as
a monorepo subdirectory under desktop/. Source only — node_modules,
dist, Cargo target and the upstream .git history are excluded.

desktop/ keeps its own independent Cargo workspace (desktop/src-tauri
with crates/*); it is not part of the backend boosapi crate, so a
`cargo check` at the metapi root still compiles only the backend. Build
the desktop app from desktop/src-tauri per desktop/README.md.

Note: app icons are still placeholder assets pending the final BoosAPI
logo. The updater signing keys live outside the repo and are not
included.
2026-06-22 11:32:57 +08:00

6.4 KiB

Anbieter konfigurieren

BoosApi verbindet sich gleichzeitig mit beliebig vielen KI-Anbietern. Jeder Anbieter hat seine eigenen API-Schlüssel, Modellliste und Parameterstandards.

Unterstützte Anbieter

Anbieter Beispielmodelle
OpenAI GPT-4o, GPT-4, o3, o4-mini
Anthropic Claude 4 Sonnet, Claude 4 Opus, Claude 3.5 Sonnet
Google Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0
DeepSeek DeepSeek V3, DeepSeek R1
Alibaba Cloud Qwen-Serie
Zhipu AI GLM-Serie
xAI Grok-Serie
OpenAI-kompatible API Ollama, vLLM, LiteLLM, Drittanbieter-Relays usw.

Anbieter hinzufügen

  1. Gehen Sie zu Einstellungen → Anbieter.
  2. Klicken Sie auf die Schaltfläche + unten links.
  3. Füllen Sie die Anbieterdetails aus:
Feld Beschreibung
Name Anzeigename für die Seitenleiste (z.B. OpenAI)
Typ Anbietertyp — bestimmt Standard-Base-URL und API-Verhalten
Symbol Optionales Symbol zur visuellen Identifikation
API-Schlüssel Der geheime Schlüssel aus dem Dashboard Ihres Anbieters
Base URL API-Endpoint (für integrierte Typen vorausgefüllt)
API-Pfad Anfragepfad — Standard ist /v1/chat/completions

Anbieter-Websites, Relay-Dashboards, private Modellplattformen oder lokale Gateway-Seiten können einen Link In BoosApi öffnen bereitstellen. Beim Klick öffnet der Browser die BoosApi-Desktop-App, BoosApi wechselt zu Einstellungen → Anbieter, zeigt einen Bestätigungsdialog und importiert die Konfiguration erst nach Bestätigung durch den Benutzer.

Benutzerablauf

  1. Installieren und öffnen Sie eine BoosApi-Version, die Anbieterlinks unterstützt.
  2. Klicken Sie im Browser auf den Link In BoosApi öffnen des Anbieters.
  3. Prüfen Sie in BoosApi Anbietername, Base URL, Anbietertyp und API-Schlüssel-Präfix.
  4. BoosApi verwendet einen bestehenden Anbieter mit derselben Kombination aus Base URL + Typ wieder. Falls keiner existiert, wird ein neuer Anbieter erstellt; der API-Schlüssel wird nur hinzugefügt, wenn er noch nicht vorhanden ist.

BoosApi validiert den Schlüssel nicht automatisch und ruft Modelle nicht automatisch ab. Klicken Sie nach dem Import auf Modelle abrufen oder fügen Sie Modelle manuell hinzu.

Linkformat

boosapi://providers?name=<name>&baseurl=<base-url>&apikey=<api-key>&type=<provider-type>

Beispiel:

boosapi://providers?name=OpenAI&baseurl=https%3A%2F%2Fapi.openai.com&apikey=sk-xxx&type=openai

Parameter

Parameter Erforderlich Beschreibung
name Ja Anzeigename in BoosApi, z. B. OpenAI oder My Relay
baseurl Ja URL-kodierte Base URL. Nur http und https sind erlaubt; query und hash werden abgelehnt.
apikey Ja API-Schlüssel, der in BoosApi gespeichert wird. BoosApi zeigt im Bestätigungsdialog nur ein Präfix.
type Ja Anbietertyp. Erlaubte Werte: openai, openai_responses, anthropic, gemini, custom.

baseurl kann die bestehende Force-Suffix-Semantik von BoosApi verwenden, z. B. https://example.com!. Beim Import per Link wird api_path nicht gesetzt; BoosApi nutzt weiterhin den Standardpfad des gewählten Anbietertyps.

Website-Konfiguration

Kodieren Sie alle dynamischen Werte mit encodeURIComponent oder URLSearchParams:

<a id="open-boosapi" href="#">In BoosApi öffnen</a>

<script>
  const provider = {
    name: 'My Relay',
    baseurl: 'https://api.example.com',
    apikey: 'sk-user-key',
    type: 'openai',
  };

  const params = new URLSearchParams({
    name: provider.name,
    baseurl: provider.baseurl,
    apikey: provider.apikey,
    type: provider.type,
  });

  document.getElementById('open-boosapi').href = `boosapi://providers?${params.toString()}`;
</script>

Wenn Ihr Dienst API-Schlüssel online erzeugt, erstellen Sie den Link erst, nachdem der Benutzer angemeldet ist und ausdrücklich einen Schlüssel ausgewählt oder erstellt hat.

::: warning Sicherheit Ein API-Schlüssel in einer URL kann im Browserverlauf, in Logs, Erweiterungen oder Analysewerkzeugen sichtbar werden. Platzieren Sie echte Schlüssel nicht auf öffentlichen Seiten, in statischem HTML oder in Drittanbieter-Weiterleitungen. Erzeugen Sie den Link vorzugsweise auf einer privaten Kontoseite nach Benutzerbestätigung. :::

::: tip Test boosapi:// ist ein benutzerdefiniertes Protokoll, das von der installierten Desktop-App im System registriert wird. Nur die Website oder den Vite-Entwicklungsserver auszuführen registriert das Protokoll nicht. Wenn der Link BoosApi nicht öffnet, installieren oder bauen Sie zuerst die aktuelle BoosApi-Desktop-App neu. :::


Aus CC Switch importieren

BoosApi kann CC Switch-Providerkonfigurationen unter Settings -> Providers scannen. Prüfen Sie Kandidaten, wählen Sie importierbare Zeilen aus und importieren Sie Provider, Base URLs, API Keys und Modelllisten. OAuth-only Einträge oder Einträge ohne wiederverwendbare Schlüssel werden mit sichtbarem Grund übersprungen.

Erweiterter Modell-Request-Body

Jedes Modell kann extra_body definieren, ein JSON-Objekt, das flach zu OpenAI-kompatiblen Chat Completions Requests hinzugefügt wird. Das ist nützlich für Anbieteroptionen wie enable_thinking. BoosApi validiert JSON und verhindert das Überschreiben von model, messages, stream, tools und Basis-Sampling-Feldern.

Multi-Key-Rotation

BoosApi unterstützt mehrere API-Schlüssel pro Anbieter. Klicken Sie auf Schlüssel hinzufügen im Anbieter-Detailpanel.


Modellverwaltung

Klicken Sie auf Modelle abrufen im Anbieter-Detailpanel, um die vollständige Liste der verfügbaren Modelle zu laden. Sie können Modell-IDs auch manuell eingeben.

Jedes Modell kann eigene Standardparameterüberschreibungen haben: Temperatur, Max. Tokens, Top P, Häufigkeitsstrafe, Präsenzstrafe.


Ollama (lokale Modelle)

  1. Installieren und starten Sie Ollama.
  2. Erstellen Sie in BoosApi einen neuen Anbieter mit Typ OpenAI.
  3. Setzen Sie die Base URL auf http://localhost:11434.
  4. Klicken Sie auf Modelle abrufen, um lokal heruntergeladene Modelle zu entdecken.

Nächste Schritte

  • MCP-Server — Externe Tools zur Erweiterung der KI-Fähigkeiten verbinden
  • API-Gateway — Ihre Anbieter als lokalen API-Server exponieren