Použití vlastního klíče (BYOK)
Uložte klíče své organizace pro Anthropic, OpenAI, Google a Mistral AI. Lokalizační požadavky pak budou používat váš klíč a poskytovatel vám je bude účtovat přímo.
Používejte pro lokalizaci vlastní klíč API poskytovatele modelů. Přidejte klíč své organizace na stránce BYOK v nastavení a vyberte model pro lokalizaci. Požadavky na modely daného poskytovatele budou používat váš klíč a poskytovatel vám bude tokeny účtovat přímo. Vyžaduje plán Enterprise.
Podporovaní poskytovatelé: Anthropic, OpenAI, Google a Mistral AI.
Lokalizace s vaším klíčem #
Další funkce, například AI hodnotitelé a návrhy engine, nevyžadují klíč poskytovatele ani výběr modelu.
Účtování #
Když lokalizace používá váš klíč, tokeny modelu vám účtuje poskytovatel a Lingo.dev vám náklady na model neúčtuje. Poplatek za infrastrukturu Lingo.dev pro lokalizovaný obsah se účtuje i nadále. Pokud lokalizace váš klíč nepoužívá, náklady na model se hradí z vašich kreditů Lingo.dev.
Kdo může spravovat klíče #
Používání stránky BYOK se řídí dvěma podmínkami:
- Dostupnost funkce: funkce BYOK musí být pro organizaci aktivní (plán Enterprise). Stránka se v nastavení zobrazuje vždy. Pokud organizace nemá na funkci nárok, zobrazí se zpráva „Vlastní klíče poskytovatelů nejsou ve vašem plánu dostupné“ 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 tedy 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í celý. Na stránce uvidíte jen poslední čtyři znaky a údaj o tom, kdy byl klíč aktualizován. Chcete-li ho změnit, klikněte na Nahradit a vložte nový klíč.
Používání modelů poskytovatele #
Váš klíč se použije, když lokalizační požadavek volá model daného poskytovatele. Chcete-li svůj klíč používat v lokalizačních krocích engine, vyberte model daného poskytovatele v konfiguraci modelů příslušného engine.
| Situace | Co se stane |
|---|---|
| Máte klíč pro poskytovatele modelu, klíč je zapnutý a poskytovatel přes něj model zpřístupňuje | Požadavek použije váš klíč |
| Pro daného poskytovatele nemáte klíč | Lokalizace s modelem z katalogu využívá vaše kredity Lingo.dev |
| Klíč je vypnutý | Lokalizace s modelem z katalogu využívá vaše kredity Lingo.dev |
| Model není v katalogu modelů Lingo.dev a váš klíč pro jeho poskytovatele chybí nebo je vypnutý | Lokalizace s tímto modelem selže, protože klíč Lingo.dev k němu nemá přístup |
| Poskytovatel odmítne přístup k modelu přes váš klíč | U modelu z katalogu se požadavek zopakuje s využitím vašich kreditů Lingo.dev; u modelu mimo katalog selže |
Štítek BYOK
Váš klíč se použije pouze tehdy, když poskytovatel zpřístupňuje model pod přesně tím ID, které máte nastavené v engine. V nabídkách pro výběr modelu a v konfiguraci modelů vašeho engine jsou modely dostupné přes váš klíč označené štítkem BYOK. Uložený model se štítkem Bez BYOK není přes váš klíč dostupný, takže lokalizace s ním využívá vaše kredity Lingo.dev. Uložený model se štítkem Vyžaduje klíč Mistral AI není v katalogu modelů Lingo.dev, a proto funguje pouze s vaším klíčem Mistral AI. Ten ale chybí nebo je vypnutý. Přidejte či zapněte klíč nebo vyberte jiný model.
Chybějící nebo vypnutý klíč nikdy nezastaví lokalizaci s modelem z katalogu.
Modely mimo katalog #
Nabídky pro výběr modelu obsahují také chatovací modely dostupné přes váš klíč Mistral AI, které nejsou v katalogu modelů Lingo.dev, například mistralai/zai-glm-5-3. Mají štítek BYOK a zobrazují se jako provider/model, každý model právě jednou pod ID, které mu přidělilo Mistral AI. Model uložený pod některým ze svých aliasů, například mistralai/zai-glm-latest, také používá váš klíč.
Tyto modely fungují pouze s vaším klíčem, protože vlastní klíč Lingo.dev k nim nemá přístup. Zatím pouze seznam modelů Mistral AI uvádí, které modely jsou chatovací, takže klíče ostatních poskytovatelů nepřidávají žádné modely mimo katalog.
Když je váš klíč odmítnut #
Tyto chyby zastaví lokalizační požadavek. Požadavek se nezopakuje s využitím vašich kreditů Lingo.dev ani nepřejde na další model v konfiguraci modelů engine. Chybová zpráva uvede poskytovatele i to, co je potřeba opravit.
| Situace | Co dělat |
|---|---|
| Poskytovatel omezuje frekvenci požadavků pro váš klíč | Zkuste to za několik minut znovu nebo u poskytovatele zvyšte limity frekvence požadavků pro klíč |
| Na vašem účtu u poskytovatele došly kredity nebo byla vyčerpána kvóta | Doplňte kredity nebo zvyšte kvótu u poskytovatele a zkuste to znovu |
| Poskytovatel váš klíč odmítá, například proto, že byl zneplatněn | Nahraďte klíč v Nastavení → BYOK a zkuste to znovu |
| Lingo.dev nemůže přečíst uložený klíč | Uložte klíč znovu v Nastavení → BYOK a zkuste to znovu |
Jde o vaše vlastní limity a váš vlastní účet. Opakování požadavku s využitím kreditů Lingo.dev by před vámi tento problém skrylo.
Vypnutí klíče #
Vypnutím klíče ho přestanete používat, aniž byste ho smazali. Na stránce se zobrazí Vypnuto a lokalizace s modely daného poskytovatele z katalogu bude využívat vaše kredity Lingo.dev, dokud klíč znovu nezapnete. Modely mimo katalog s vypnutým klíčem nefungují.
Pokud váš plán už neumožňuje používat vlastní klíče, u uloženého klíče se zobrazí Uložený, nepoužívá se. Lokalizace s modely daného poskytovatele z katalogu využívá vaše kredity Lingo.dev a modely mimo katalog nefungují. Klíč zůstane uložený, dokud ho neodeberete.
Odebrání klíče #
Klikněte na Odebrat klíč. Klíč se z Lingo.dev smaže. Lokalizace s modely daného poskytovatele z katalogu začne znovu využívat vaše kredity Lingo.dev a modely mimo katalog přestanou fungovat.
Zneplatněte klíč u poskytovatele
Odebráním klíče z Lingo.dev ho nezneplatníte. U poskytovatele zůstává platný, dokud ho nezneplatníte přímo tam.