Eigenen Schlüssel verwenden (BYOK)
Hinterlegen Sie die Schlüssel Ihrer Organisation für Anthropic, OpenAI, Google und Mistral AI. So laufen Lokalisierungsanfragen über Ihren eigenen Schlüssel, und der Anbieter rechnet direkt mit Ihnen ab.
Nutzen Sie für die Lokalisierung Ihren eigenen API-Schlüssel eines Modellanbieters. Hinterlegen Sie den Schlüssel Ihrer Organisation auf der Seite BYOK unter Einstellungen und wählen Sie anschließend ein Modell für die Lokalisierung. Anfragen an die Modelle dieses Anbieters laufen über Ihren Schlüssel, und der Anbieter stellt Ihnen die Kosten für die Tokens direkt in Rechnung. Verfügbar im Enterprise-Tarif.
Unterstützte Anbieter: Anthropic, OpenAI, Google und Mistral AI.
Lokalisierung mit Ihrem Schlüssel #
Andere Funktionen wie KI-Bewerter und Engine-Vorschläge erfordern weder einen Anbieterschlüssel noch die Auswahl eines Modells.
Abrechnung #
Wenn die Lokalisierung über Ihren Schlüssel läuft, stellt Ihnen der Anbieter die Kosten für die Tokens des Modells in Rechnung. Lingo.dev berechnet in diesem Fall keine Modellkosten. Die Infrastrukturgebühr von Lingo.dev für lokalisierte Inhalte fällt weiterhin an. Bei einer Lokalisierung ohne Ihren Schlüssel werden die Modellkosten von Ihrem Lingo.dev-Guthaben abgezogen.
Wer Schlüssel verwalten kann #
Für die Nutzung der BYOK-Seite gelten zwei Voraussetzungen:
- Freischaltung: Die BYOK-Funktion muss für die Organisation aktiviert sein (Enterprise-Tarif). Die Seite wird immer unter Einstellungen angezeigt. Ohne Freischaltung erscheint die Meldung „Eigene Anbieterschlüssel sind in Ihrem Tarif nicht verfügbar“, und Sie können keinen Schlüssel speichern.
- Berechtigung: Zum Hinzufügen, Ersetzen, Aktivieren, Deaktivieren und Entfernen eines Schlüssels muss die Rolle des Mitglieds die Berechtigung Einstellungen verwalten (
org:manage_settings) enthalten. 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 API-Schlüssel der Organisation lassen sich diese Schlüssel nicht ändern. Melden Sie sich stattdessen mit einem persönlichen Konto an.
Schlüssel hinzufügen #
- Öffnen Sie Einstellungen → BYOK.
- Klicken Sie neben dem Anbieter auf Schlüssel hinzufügen.
- Fügen Sie den API-Schlüssel ein und speichern Sie ihn.
Beim Speichern validiert Lingo.dev den Schlüssel beim Anbieter. Akzeptiert der Anbieter ihn nicht, wird er nicht gespeichert. Kontrollieren Sie den Schlüssel in Ihrem Anbieterkonto und fügen Sie ihn erneut ein.
Sichtbarkeit des Schlüssels
Ein gespeicherter Schlüssel wird nie wieder vollständig angezeigt. Auf der Seite sehen Sie nur die letzten vier Zeichen und den Zeitpunkt der letzten Aktualisierung. Um den Schlüssel zu ändern, klicken Sie auf Ersetzen und fügen Sie einen neuen ein.
Modelle eines Anbieters verwenden #
Ihr Schlüssel wird verwendet, wenn eine Lokalisierungsanfrage ein Modell dieses Anbieters aufruft. Damit die Lokalisierungsschritte einer Engine Ihren Schlüssel nutzen, legen Sie in der Modellkonfiguration der Engine ein Modell dieses Anbieters fest.
| Situation | Was passiert |
|---|---|
| Sie haben einen aktivierten Schlüssel für den Anbieter des Modells, und der Anbieter stellt das Modell über diesen Schlüssel bereit | Die Anfrage läuft über Ihren Schlüssel |
| Kein Schlüssel für diesen Anbieter | Die Lokalisierung mit einem Katalogmodell nutzt Ihr Lingo.dev-Guthaben |
| Der Schlüssel ist deaktiviert | Die Lokalisierung mit einem Katalogmodell nutzt Ihr Lingo.dev-Guthaben |
| Das Modell ist nicht im Modellkatalog von Lingo.dev enthalten, und Ihr Schlüssel für dessen Anbieter fehlt oder ist deaktiviert | Die Lokalisierung mit diesem Modell schlägt fehl, da der Schlüssel von Lingo.dev keinen Zugriff darauf ermöglicht |
| Der Anbieter verweigert den Zugriff auf das Modell mit Ihrem Schlüssel | Bei einem Katalogmodell wird die Anfrage mit Ihrem Lingo.dev-Guthaben erneut versucht; bei einem Modell außerhalb des Katalogs schlägt sie fehl |
BYOK-Kennzeichnung
Ihr Schlüssel wird nur verwendet, wenn der Anbieter das Modell unter exakt der ID bereitstellt, die in Ihrer Engine festgelegt ist. In der Modellauswahl und der Modellkonfiguration Ihrer Engine werden Modelle, die über Ihren Schlüssel verfügbar sind, mit BYOK gekennzeichnet. Ein gespeichertes Modell mit der Kennzeichnung Kein BYOK ist nicht über Ihren Schlüssel verfügbar. Die Lokalisierung damit nutzt daher Ihr Lingo.dev-Guthaben. Ein gespeichertes Modell mit der Kennzeichnung Mistral AI-Schlüssel erforderlich ist nicht im Modellkatalog von Lingo.dev enthalten und lässt sich deshalb nur mit Ihrem Mistral AI-Schlüssel ausführen. Dieser Schlüssel fehlt jedoch oder ist deaktiviert. Fügen Sie den Schlüssel hinzu, aktivieren Sie ihn oder wählen Sie ein anderes Modell.
Ein fehlender oder deaktivierter Schlüssel verhindert niemals die Lokalisierung mit einem Katalogmodell.
Modelle außerhalb des Katalogs #
Die Modellauswahl bietet auch Chatmodelle, die über Ihren Mistral AI-Schlüssel verfügbar, aber nicht im Modellkatalog von Lingo.dev enthalten sind, etwa mistralai/zai-glm-5-3. Sie sind mit BYOK gekennzeichnet und werden als provider/model angezeigt. Jedes Modell erscheint genau einmal unter der ID, die Mistral AI dafür verwendet. Auch ein Modell, das unter einem seiner Aliasse wie mistralai/zai-glm-latest gespeichert ist, läuft über Ihren Schlüssel.
Diese Modelle laufen ausschließlich über Ihren Schlüssel, 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 anderer Anbieter ergänzen daher keine Modelle außerhalb des Katalogs.
Wenn Ihr Schlüssel abgelehnt wird #
Diese Fehler stoppen die Lokalisierungsanfrage. Sie wird weder mit Ihrem Lingo.dev-Guthaben erneut versucht noch mit dem nächsten Modell in der Modellkonfiguration der Engine fortgesetzt. Die Fehlermeldung nennt den Anbieter und zeigt, was Sie beheben müssen.
| Situation | Was zu tun ist |
|---|---|
| Der Anbieter begrenzt die Anfragerate Ihres Schlüssels | Versuchen Sie es in einigen Minuten erneut oder erhöhen Sie beim Anbieter die Limits für die Anfragerate Ihres Schlüssels |
| Das Guthaben oder Kontingent Ihres Anbieterkontos ist aufgebraucht | Laden Sie beim Anbieter Guthaben auf oder erhöhen Sie das Kontingent und versuchen Sie es anschließend erneut |
| Der Anbieter lehnt Ihren Schlüssel ab, zum Beispiel weil er widerrufen wurde | Ersetzen Sie den Schlüssel unter Einstellungen → BYOK und versuchen Sie es anschließend erneut |
| Lingo.dev kann den gespeicherten Schlüssel nicht lesen | Speichern Sie den Schlüssel unter Einstellungen → BYOK erneut und versuchen Sie es anschließend noch einmal |
Hier geht es um Ihre eigenen Limits und Ihr eigenes Konto. Ein erneuter Versuch mit Lingo.dev-Guthaben würde das Problem für Sie verdecken.
Schlüssel deaktivieren #
Deaktivieren Sie den Schlüssel, wenn Sie ihn nicht mehr verwenden, aber nicht löschen möchten. Auf der Seite erscheint Deaktiviert. Die Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt Ihr Lingo.dev-Guthaben, bis Sie den Schlüssel wieder aktivieren. Modelle außerhalb des Katalogs lassen sich nicht ausführen, solange der Schlüssel deaktiviert ist.
Wenn eigene Schlüssel in Ihrem Tarif nicht mehr verfügbar sind, wird ein gespeicherter Schlüssel als Gespeichert, nicht in Verwendung angezeigt. Die Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt Ihr Lingo.dev-Guthaben, und Modelle außerhalb des Katalogs lassen sich nicht ausführen. Der gespeicherte Schlüssel bleibt erhalten, bis Sie ihn entfernen.
Schlüssel entfernen #
Klicken Sie auf Schlüssel entfernen. Der Schlüssel wird aus Lingo.dev gelöscht. Die Lokalisierung mit den Katalogmodellen dieses Anbieters nutzt wieder Ihr Lingo.dev-Guthaben, und Modelle außerhalb des Katalogs lassen sich nicht mehr ausführen.
Beim Anbieter widerrufen
Wenn Sie einen Schlüssel aus Lingo.dev entfernen, wird er dadurch nicht widerrufen. Er bleibt beim Anbieter gültig, bis Sie ihn dort widerrufen.