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:

  1. 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.
  2. 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 #

  1. Otevřete Nastavení → BYOK.
  2. Klikněte na Přidat klíč vedle poskytovatele.
  3. 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.

SituaceCo se stane
Máte klíč pro poskytovatele modelu, klíč je zapnutý a poskytovatel přes něj model zpřístupňujePož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.

SituaceCo 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ótaDoplňte kredity nebo zvyšte kvótu u poskytovatele a zkuste to znovu
Poskytovatel váš klíč odmítá, například proto, že byl zneplatněnNahraď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.