Eigene Schlüssel verwenden (BYOK)
Hinterlege die API-Schlüssel deiner Organisation für Modellanbieter auf der Seite BYOK unter Einstellungen. Lokalisierungsanfragen für die Modelle des jeweiligen Anbieters werden dann mit deinem Schlüssel direkt an diesen Anbieter gesendet und von ihm abgerechnet. Verfügbar im Enterprise-Tarif.
Unterstützte Anbieter: Anthropic, OpenAI, Google und Mistral AI.
Welche Anfragen deinen Schlüssel verwenden#
Nur die Lokalisierung läuft über deinen Schlüssel. Alles andere läuft weiterhin über den Schlüssel von Lingo.dev.
| Anfrage | Schlüssel |
|---|---|
| Lokalisierung: die localize-API, Lokalisierungsaufträge, der Playground und jeder Lokalisierungsschritt, den eine Engine ausführt | Dein Schlüssel, sofern du einen für den Anbieter des Modells hinterlegt hast |
| Qualitätsschranke | Schlüssel von Lingo.dev |
| KI-Bewerter | Schlüssel von Lingo.dev |
| Engine-Vorschläge | Schlüssel von Lingo.dev |
Abrechnung#
Wird eine Anfrage mit deinem Schlüssel ausgeführt, stellt dir der Anbieter die dabei verbrauchten Tokens in Rechnung.
Wer Schlüssel verwalten kann#
Der Zugriff auf die Seite BYOK hängt von zwei Voraussetzungen ab:
- Freischaltung: Die BYOK-Funktion muss für die Organisation aktiviert sein (Enterprise-Tarif). Die Seite wird immer unter Einstellungen angezeigt. Ohne Freischaltung steht dort „Eigene Anbieterschlüssel sind in deinem Tarif nicht verfügbar“, und du kannst keinen Schlüssel speichern.
- Berechtigung: Um einen Schlüssel hinzuzufügen, zu ersetzen, ein- oder auszuschalten oder zu entfernen, benötigt das Mitglied in seiner Rolle die Berechtigung Einstellungen verwalten (
org:manage_settings). Ohne RBAC hat jedes Mitglied die Rolle „Inhaber“ und verfügt über diese Berechtigung.
Jedes Mitglied kann sehen, für welche Anbieter ein Schlüssel hinterlegt ist und ob er verwendet wird. Mit einem Organisations-API-Schlüssel lassen sich Schlüssel nicht ändern. Melde dich dafür mit deinem persönlichen Konto an.
Schlüssel hinzufügen#
- Öffne Einstellungen → BYOK.
- Klicke neben dem Anbieter auf Schlüssel hinzufügen.
- Füge den API-Schlüssel ein und speichere ihn.
Beim Speichern lässt Lingo.dev den Schlüssel vom Anbieter validieren. Akzeptiert der Anbieter ihn nicht, wird er nicht gespeichert. Überprüfe den Schlüssel in deinem Konto beim Anbieter und füge ihn erneut ein.
Sichtbarkeit des Schlüssels
Ein gespeicherter Schlüssel wird danach nicht mehr vollständig angezeigt. Auf der Seite siehst du nur die letzten vier Zeichen und den Zeitpunkt der letzten Aktualisierung. Um ihn zu ändern, klicke auf Ersetzen und füge einen neuen Schlüssel ein.
Modelle eines Anbieters verwenden#
Dein Schlüssel wird verwendet, wenn eine Engine ein Modell dieses Anbieters aufruft. Damit ein Modell über deinen Schlüssel läuft, wähle es in der Modellkonfiguration der Engine aus.
| Situation | Was passiert |
|---|---|
| Du hast einen Schlüssel für den Anbieter des Modells hinterlegt und eingeschaltet | Die Anfrage läuft über deinen Schlüssel |
| Kein Schlüssel für diesen Anbieter | Die Anfrage läuft wie bisher über den Schlüssel von Lingo.dev und wird mit deinen Credits abgerechnet |
| Der Schlüssel ist ausgeschaltet | Die Anfrage läuft über den Schlüssel von Lingo.dev und wird mit deinen Credits abgerechnet |
| Der Anbieter verweigert den Zugriff auf das Modell mit deinem Schlüssel | Die Anfrage wird mit dem Schlüssel von Lingo.dev erneut versucht und mit deinen Credits abgerechnet |
Ein fehlender oder ausgeschalteter Schlüssel stoppt deine Lokalisierung nicht. Verweigert der Anbieter den Zugriff auf das Modell jedoch erst, nachdem er bereits mit der Antwort begonnen hat, kann die Anfrage stattdessen fehlschlagen. Um das zu vermeiden, gib deinem Schlüssel Zugriff auf das Modell oder wähle ein anderes Modell.
Wenn dein Schlüssel abgelehnt wird#
Die folgenden Fehler stoppen die Anfrage. Sie wird weder über den Schlüssel von Lingo.dev noch mit dem nächsten Modell in der Modellkonfiguration der Engine fortgesetzt. Die Fehlermeldung nennt den Anbieter und erklärt, was du beheben musst.
| Situation | Was du tun kannst |
|---|---|
| Der Anbieter begrenzt die Anfragerate für deinen Schlüssel | Versuche es in ein paar Minuten erneut oder erhöhe beim Anbieter die Anfragelimits für den Schlüssel |
| Das Guthaben oder Kontingent deines Kontos beim Anbieter ist aufgebraucht | Lade beim Anbieter Guthaben auf oder erhöhe das Kontingent und versuche es dann erneut |
| Der Anbieter lehnt deinen Schlüssel ab, zum Beispiel weil er widerrufen wurde | Ersetze den Schlüssel unter Einstellungen → BYOK und versuche es anschließend erneut |
| Lingo.dev kann den gespeicherten Schlüssel nicht lesen | Speichere den Schlüssel unter Einstellungen → BYOK noch einmal und versuche es anschließend erneut |
Hier geht es um deine eigenen Limits und dein eigenes Konto. Würden die Anfragen auf den Schlüssel von Lingo.dev umgeleitet, bliebe das Problem für dich verborgen.
Schlüssel ausschalten#
Schalte den Schlüssel aus, wenn du ihn nicht mehr verwenden, aber nicht löschen möchtest. Die Seite zeigt Aus an. Die Modelle dieses Anbieters laufen dann über den Schlüssel von Lingo.dev und werden mit deinen Credits abgerechnet, bis du deinen Schlüssel wieder einschaltest.
Wenn dein Tarif die Verwendung eigener Schlüssel nicht mehr erlaubt, wird ein hinterlegter Schlüssel als Gespeichert, nicht in Verwendung angezeigt. Die Modelle dieses Anbieters laufen über den Schlüssel von Lingo.dev und werden mit deinen Credits abgerechnet. Der gespeicherte Schlüssel bleibt erhalten, bis du ihn entfernst.
Schlüssel entfernen#
Klicke auf Schlüssel entfernen. Der Schlüssel wird aus Lingo.dev gelöscht. Die Modelle dieses Anbieters laufen dann wieder über den Schlüssel von Lingo.dev und werden mit deinen Credits abgerechnet.
Beim Anbieter widerrufen
Wenn du einen Schlüssel aus Lingo.dev entfernst, wird er dadurch nicht widerrufen. Er bleibt beim Anbieter gültig, bis du ihn dort widerrufst.