Eigenen Modellschlüssel verbinden

Verbindungsdaten zusammentragen

Du benötigst einen API-Schlüssel des Dienstes, den du aufrufen möchtest, dessen API-Basis-URL, eine verfügbare Modell-ID sowie ein kompatibles Protokoll oder Preset. Ein Konto auf einer Chat-Website für Endnutzer bietet nicht automatisch API-Zugriff oder API-Guthaben.

Jeder Tarif, einschließlich Free, unterstützt BYOK. Für deinen Anbieterschlüssel gelten die Abrechnung und das Kontingent dieses Anbieters statt des OpenDesign-Guthabens.

Anbieter hinzufügen

1. Öffne Settings → Models & providers → API providers.
2. Wähle das Preset für den Dienst, der deinen Schlüssel ausgestellt hat. Bei Custom provider muss das Protokoll mit dem von diesem Dienst dokumentierten Protokoll übereinstimmen.
3. Füge in API Key nur das Geheimnis ein. Füge weder Bearer noch Anführungszeichen oder eine JSON-Konfigurationshülle hinzu.
4. Prüfe Base URL. Wenn die Adresse eines Presets gesperrt ist, verwende dessen Option für eine benutzerdefinierte URL, bevor du einen anderen Endpunkt eingibst.
5. Wähle ein Modell aus der verfügbaren Liste aus oder gib unter Custom die exakte API-Modell-ID ein. Das Laden von Modellen hängt vom Dienst und Konto ab.
6. Führe Test aus. Lies die Antwort: Ein erfolgreicher Test bestätigt diese kleine Anfrage, nicht jedes Tool, Medienmodell oder jede zukünftige Anfrage.
7. Warte auf die Speicherbestätigung. Öffne Settings erneut, um Anbieter, Adresse und Modell zu prüfen. Kehre dann zum Projekt zurück und wähle diese Verbindung aus, bevor du eine kleine Aufgabe sendest.

Halte den Schlüssel geheim. Das Feld kann zur lokalen Prüfung mit Show eingeblendet werden; schwärze den Schlüssel, bevor du einen Screenshot teilst.

Beispiel: DeepSeek

Erstelle einen Schlüssel auf der DeepSeek Platform. Verwende https://api.deepseek.com als Basis-URL und wähle ein Modell aus, das dein Konto aufrufen kann. Verwende eine ID aus der aktuellen Modellliste des Anbieters, zum Beispiel deepseek-flash; der Screenshot des installierten Clients enthält noch einen älteren Preset-Alias. Gib bei Bedarf die aktuelle ID als benutzerdefiniertes Modell ein. In der installierten Version 0.25.0 kann die Verknüpfung Get key die falsche Anbieterseite öffnen. Verwende stattdessen die Konsole des Anbieters, anstatt einen nicht zugehörigen OpenAI-Schlüssel zu erstellen.

Kopiere die exakte ID aus der aktuellen DeepSeek-API-Dokumentation und nicht den Anzeigenamen aus einem alten Screenshot. Verwende für dieses Beispiel mit OpenAI-Protokoll nicht den separaten /anthropic-Endpunkt.

Beispiel: OpenRouter

Erstelle einen Schlüssel in den Schlüsseleinstellungen von OpenRouter. Verwende https://openrouter.ai/api/v1. Kopiere eine Modell-ID aus der Liste der verfügbaren OpenRouter-Modelle, einschließlich des Anbieterpräfixes. Füge keinen direkten Anthropic- oder OpenAI-Schlüssel in das OpenRouter-Preset ein. Der Schlüssel gehört zu dem Gateway, das die Anfrage empfängt.

1. Wähle OpenRouter unter API providers aus und füge einen von OpenRouter ausgestellten Schlüssel ein.
2. Verwende https://openrouter.ai/api/v1 als Base URL.
3. Kopiere die exakte Modell-ID aus dem OpenRouter-Modellverzeichnis, einschließlich des Anbieterpräfixes.
4. Teste die Verbindung, warte, bis sie gespeichert wurde, und wähle sie im Projekt aus, bevor du eine Anfrage ausführst.

Anderen Anbieter prüfen

Ein Schlüssel ist nicht die gesamte Ausführungsumgebung

BYOK-Aufgaben benötigen weiterhin die unterstützte Laufzeitumgebung, die die Datei- und Toolvorgänge des Agenten ausführt. Wenn die App meldet, dass die Laufzeitumgebung nicht verfügbar ist, befolge deren Installations- oder Anweisungen für eine erneute Suche. Durch Ersetzen des Schlüssels wird keine ausführbare Datei installiert.

Abrechnung verstehen

BYOK-Anfragen werden von dem Anbieter oder Gateway abgerechnet, dessen Schlüssel du eingegeben hast. Ein OpenDesign-Abonnement und das Guthaben eines externen Anbieters sind voneinander getrennt. Siehe Abrechnung und Fehlerbehebung bei Verbindungen, wenn mit einem gültigen Schlüssel weiterhin keine Aufgabe ausgeführt werden kann.

Testergebnis auswerten und Fehler beheben

Sende nach einem erfolgreichen Test eine kleine Anfrage im vorhandenen Projekt und prüfe die Antwort sowie alle erstellten Dateien. Wenn der Test erfolgreich ist, aber Dateivorgänge fehlschlagen, prüfe die im Abschnitt zur Ausführungsumgebung beschriebene Laufzeitumgebung; ersetze einen funktionierenden Schlüssel nicht wiederholt.