Použití vlastního klíče (BYOK)
Na stránce BYOK v Nastavení si uložte vlastní klíče API své organizace pro poskytovatele modelů. Požadavky na lokalizaci využívající modely daného poskytovatele pak putují přímo k němu s vaším klíčem a poskytovatel vám je přímo účtuje. Tato funkce vyžaduje plán Enterprise.
Podporovaní poskytovatelé: Anthropic, OpenAI, Google a Mistral AI.
Které požadavky používají váš klíč#
Váš klíč se používá pouze pro lokalizaci. Vše ostatní nadále používá klíč Lingo.dev.
| Požadavek | Klíč |
|---|---|
| Lokalizace: API localize, lokalizační úlohy, Playground a každý lokalizační krok, který engine spustí | Váš klíč, pokud ho máte pro poskytovatele daného modelu |
| Kontrola kvality | Klíč Lingo.dev |
| AI hodnotitelé | Klíč Lingo.dev |
| Návrhy engine | Klíč Lingo.dev |
Účtování#
Když se požadavek zpracuje pomocí vašeho klíče, poskytovatel vám naúčtuje spotřebované tokeny.
Kdo může spravovat klíče#
Přístup ke stránce BYOK se řídí dvěma podmínkami:
- Nárok na funkci: funkce BYOK musí být pro organizaci aktivní (plán Enterprise). Stránka se v Nastavení zobrazuje vždy. Bez nároku na funkci se zobrazí zpráva "Váš plán nepodporuje vlastní klíče poskytovatelů" a klíč nelze uložit.
- Oprávnění: přidání, nahrazení, zapnutí, vypnutí i odebrání klíče vyžaduje oprávnění Spravovat nastavení (
org:manage_settings) v roli člena. Bez RBAC má každý člen roli Vlastník a s ní i toto oprávnění.
Každý člen vidí, u kterých poskytovatelů je uložený klíč a zda se používá. Klíče nelze měnit pomocí klíče API organizace. Přihlaste se proto pod osobním účtem.
Přidání klíče#
- Otevřete Nastavení → BYOK.
- Klikněte na Přidat klíč vedle poskytovatele.
- Vložte klíč API a uložte ho.
Lingo.dev při ukládání ověří klíč u poskytovatele. Pokud ho poskytovatel nepřijme, klíč se neuloží. Zkontrolujte ho ve svém účtu u poskytovatele a vložte ho znovu.
Zobrazení klíče
Po uložení se klíč už nikdy nezobrazí v plném znění. Na stránce uvidíte pouze poslední čtyři znaky a údaj o poslední aktualizaci. Chcete-li klíč změnit, klikněte na Nahradit a vložte nový klíč.
Používání modelů poskytovatele#
Váš klíč se použije, když engine zavolá model daného poskytovatele. Chcete-li model poskytovatele spouštět s vlastním klíčem, nastavte tento model v konfiguraci modelů pro engine.
| Situace | Co se stane |
|---|---|
| Máte klíč pro poskytovatele daného modelu a klíč je zapnutý | Požadavek se zpracuje s vaším klíčem |
| Pro daného poskytovatele nemáte klíč | Požadavek se jako dosud zpracuje s klíčem Lingo.dev a za vaše kredity |
| Klíč je vypnutý | Požadavek se zpracuje s klíčem Lingo.dev a za vaše kredity |
| Poskytovatel odmítne použití modelu s vaším klíčem | Požadavek se zopakuje s klíčem Lingo.dev a za vaše kredity |
Chybějící nebo vypnutý klíč lokalizaci nikdy nezastaví. Pokud však poskytovatel odmítne použití modelu až poté, co model začne odpovídat, může požadavek selhat. Chcete-li tomu předejít, povolte svému klíči přístup k modelu nebo vyberte jiný model.
Když poskytovatel odmítne váš klíč#
Následující chyby zpracování požadavku zastaví. Nepřejde se na klíč Lingo.dev ani na další model v konfiguraci modelů pro engine. Chybová zpráva uvede poskytovatele a popíše, co je třeba opravit.
| Situace | Co dělat |
|---|---|
| Poskytovatel omezuje frekvenci požadavků pro váš klíč | Zkuste to znovu za několik minut nebo u poskytovatele zvyšte limity frekvence požadavků pro daný klíč |
| Na vašem účtu u poskytovatele došly kredity nebo byla vyčerpána kvóta | Doplňte kredity nebo u poskytovatele zvyšte kvótu a pak to zkuste znovu |
| Poskytovatel odmítne váš klíč, například proto, že byl zneplatněn | Vyměňte klíč v Nastavení → BYOK a zkuste to znovu |
| Lingo.dev nemůže přečíst uložený klíč | Znovu uložte klíč v Nastavení → BYOK a zkuste to znovu |
Jde o vaše vlastní limity a váš vlastní účet. Přesměrování požadavků na klíč Lingo.dev by před vámi problém skrylo.
Vypnutí klíče#
Vypnutím klíče ho přestanete používat, aniž byste ho smazali. Na stránce se zobrazí stav Vypnuto a modely daného poskytovatele budou používat klíč Lingo.dev a vaše kredity, dokud svůj klíč znovu nezapnete.
Pokud váš plán už nepodporuje vlastní klíče, u uloženého klíče se zobrazí stav Uložen, nepoužívá se. Modely daného poskytovatele používají klíč Lingo.dev a vaše kredity. Uložený klíč zůstane zachován, dokud ho neodeberete.
Odebrání klíče#
Klikněte na Odebrat klíč. Klíč se z Lingo.dev smaže a modely daného poskytovatele budou opět používat klíč Lingo.dev a vaše kredity.
Zneplatněte klíč u poskytovatele
Odebráním klíče z Lingo.dev se klíč nezneplatní. U poskytovatele zůstává platný, dokud ho tam nezneplatníte.