Lokalisierung mit deinem eigenen Schlüssel (BYOK)
Nutze für die Lokalisierung deinen eigenen API-Schlüssel eines Modellanbieters. Hinterlege den Schlüssel deiner Organisation auf der Seite BYOK unter Einstellungen und wähle anschließend ein Lokalisierungsmodell aus. Anfragen an die Modelle dieses Anbieters verwenden deinen Schlüssel. Die verbrauchten Tokens stellt dir der Anbieter direkt in Rechnung. Verfügbar im Enterprise-Tarif.
Unterstützte Anbieter: Anthropic, OpenAI, Google und Mistral AI.
Lokalisierung mit deinem Schlüssel#
Andere Funktionen wie KI-Bewerter und Engine-Vorschläge benötigen weder einen Anbieterschlüssel noch eine Modellauswahl.
Abrechnung#
Wenn die Lokalisierung über deinen Schlüssel läuft, stellt dir der Anbieter die verbrauchten Tokens in Rechnung. Für Lokalisierungen ohne deinen Schlüssel werden deine Lingo.dev-Credits verwendet.
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 Lokalisierungsanfrage ein Modell dieses Anbieters aufruft. Damit auch die Lokalisierungsschritte einer Engine deinen Schlüssel nutzen, wähle in der Modellkonfiguration der Engine ein Modell dieses Anbieters 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 Lokalisierung mit einem Katalogmodell nutzt deine Lingo.dev-Credits |
| Der Schlüssel ist ausgeschaltet | Die Lokalisierung mit einem Katalogmodell nutzt deine Lingo.dev-Credits |
| Das Modell ist nicht im Lingo.dev-Modellkatalog enthalten, und dein Schlüssel für diesen Anbieter fehlt oder ist deaktiviert | Die Lokalisierung mit diesem Modell schlägt fehl, weil der Schlüssel von Lingo.dev keinen Zugriff darauf ermöglicht |
| Der Anbieter verweigert den Zugriff auf das Modell mit deinem Schlüssel | Bei einem Katalogmodell erfolgt ein erneuter Versuch mit deinen Lingo.dev-Credits; bei einem Modell außerhalb des Katalogs schlägt der Vorgang fehl |
BYOK-Kennzeichnung
Dein Schlüssel wird nur verwendet, wenn der Anbieter das Modell unter exakt der ID bereitstellt, die in deiner Engine hinterlegt ist. In der Modellauswahl und der Modellkonfiguration deiner Engine sind Modelle, die über deinen Schlüssel verfügbar sind, mit BYOK gekennzeichnet. Ein gespeichertes Modell mit der Kennzeichnung Nicht BYOK ist über deinen Schlüssel nicht verfügbar. Die Lokalisierung mit diesem Modell nutzt daher deine Lingo.dev-Credits. Ein gespeichertes Modell mit der Kennzeichnung Mistral AI-Schlüssel erforderlich ist nicht im Lingo.dev-Modellkatalog enthalten und kann deshalb nur mit deinem Mistral AI-Schlüssel genutzt werden. Dieser Schlüssel fehlt jedoch oder ist deaktiviert. Füge den Schlüssel hinzu, aktiviere ihn oder wähle ein anderes Modell.
Ein fehlender oder deaktivierter Schlüssel verhindert niemals die Lokalisierung mit einem Katalogmodell.
Modelle außerhalb des Katalogs#
In der Modellauswahl findest du auch Chatmodelle, die über deinen Mistral AI-Schlüssel verfügbar sind, aber nicht im Lingo.dev-Modellkatalog stehen, etwa mistralai/zai-glm-5-3. Sie sind mit BYOK gekennzeichnet und erscheinen als provider/model, jeweils einmal pro Modell unter der von Mistral AI vergebenen ID. Auch ein Modell, das unter einem seiner Aliase gespeichert ist, etwa mistralai/zai-glm-latest, wird mit deinem Schlüssel ausgeführt.
Diese Modelle lassen sich nur mit deinem Schlüssel nutzen, da der eigene Schlüssel von Lingo.dev keinen Zugriff darauf ermöglicht. Derzeit gibt nur die Modellliste von Mistral AI an, welche Modelle Chatmodelle sind. Schlüssel für andere Anbieter fügen daher keine Modelle außerhalb des Katalogs hinzu.
Wenn dein Schlüssel abgelehnt wird#
Diese Fehler stoppen die Lokalisierungsanfrage. Es folgt weder ein erneuter Versuch mit deinen Lingo.dev-Credits noch ein Wechsel zum nächsten Modell in der Modellkonfiguration der Engine. 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 |
Es geht um deine eigenen Limits und dein eigenes Konto. Ein erneuter Versuch mit Lingo.dev-Credits würde das Problem vor dir verbergen.
Schlüssel ausschalten#
Deaktiviere den Schlüssel, um ihn nicht mehr zu verwenden, ohne ihn zu löschen. Auf der Seite wird Deaktiviert angezeigt. Die Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt deine Lingo.dev-Credits, bis du den Schlüssel wieder aktivierst. Modelle außerhalb des Katalogs lassen sich nicht nutzen, solange der Schlüssel deaktiviert ist.
Wenn dein Tarif die Nutzung eigener Schlüssel nicht mehr umfasst, wird ein gespeicherter Schlüssel als Gespeichert, nicht in Nutzung angezeigt. Die Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt deine Lingo.dev-Credits, und Modelle außerhalb des Katalogs lassen sich nicht nutzen. 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 Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt wieder deine Lingo.dev-Credits, und Modelle außerhalb des Katalogs lassen sich nicht mehr nutzen.
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.