Omezení klíče API: IP a nástroje
Každý klíč API NeuralSpace může mít dvě omezení: ze kterých adres pracuje a ke kterým nástrojům poskytuje přístup. Nastavení žije na stránce API klíče, je aplikován ihned po uložení a je zkontrolován na serveru před přístupem k modelu: zakázaný požadavek je odmítnut s chybou 403, tokeny za něj nejsou strženy.
Proč omezovat klíč
Klíč API je přístup k placeným modelům v rámci vašeho zůstatku. Pokud se klíč dostane do nesprávných rukou, požadavky jiných lidí budou z vašeho účtu utraceny a vy si toho všimnete pouze při pohledu na debetní historii. Nejběžnější scénář pokrývají dvě jednoduchá omezení:
- klíč je v kódu robota nebo aplikace, která běží z jednoho serveru - svažte klíč s adresou tohoto serveru a odcizená kopie klíče ze stroje někoho jiného nebude fungovat;
- klíč se vydává pro konkrétní úkol - ponechte pouze potřebné nástroje, například chat a obrázky, a vypněte video, zvuk a vše ostatní, aby se nepoužívaly „současně“.
Kde nastavit omezení
- Otevřete stránku API klíče.
- Pod požadovaným klíčem klikněte na „Omezení“.
- Vyplňte seznam povolených IP adres a zrušte zaškrtnutí políček, které klíč nemá používat.
- Klikněte na „Uložit“ - omezení se projeví okamžitě.
Nastavení jsou vázána na konkrétní klíč: každý klíč má svůj vlastní seznam adres a vlastní sadu nástrojů. Omezení fungují ve světlých i tmavých tématech stránek.
Povolené IP adresy
V poli adresy můžete zadat jednu nebo více IP adres – jednu na řádek, celkem až 50. Prázdné pole znamená, že klíč je akceptován z jakékoli adresy, jako dříve: omezení je povoleno pouze v případě, že je seznam plný.
Skutečná adresa klienta je kontrolována, i když k nám požadavek přichází přes proxy nebo serverovou vrstvu - tedy vazba na server funguje i ve schématech, kde je aplikace umístěna za balancerem. Pokud se adresa ze serveru změnila, jednoduše přidejte novou do seznamu a uložte.
Dostupné nástroje
Pod seznamem adres je strom nástrojů. Nejvyšší úroveň je pět kategorií: LLM (chatové modely), Obrázky, Videa, Zvuk a Ostatní. Zrušením zaškrtnutí kategorie ji zcela zakážete; Když je kategorie povolena, zaškrtávací políčka uvnitř fungují cíleně – můžete ponechat pár konkrétních modelů a zbytek deaktivovat.
Ve výchozím nastavení je vše povoleno. Ukládáme pouze ty, které jsou vypnuté, takže nové nástroje a modely, které budeme mít později, jsou ihned k dispozici na klíč – není třeba je samostatně zapínat.
Co se stane se zamítnutou žádostí?
Požadavek z nevyřešené adresy nebo na deaktivovaný nástroj obdrží odpověď 403 s jasným popisem důvodu, a to se stane před kontaktováním modelu - peníze za takové volání nejsou strženy.
Servisní požadavky - kontrola zůstatku, seznam modelů a nápověda API - nepodléhají omezením: zůstávají dostupné s jakýmkoli klíčem, takže aplikace může vždy zjistit svůj zůstatek a katalog.
Kde platí omezení
Klíčová omezení jsou respektována ve všech cestách provádění: ve veřejném rozhraní API, na serveru MCP a v hlasových spojeních. Není možné samostatně zakázat jeden provozní režim a povolit jiný - kontrola se provádí na skutečném nástroji, který provádí požadavek.
Kdo z toho bude mít prospěch?
Každý, kdo vezme klíč mimo svůj počítač: vývojáři robotů a mobilních aplikací, týmy se sdíleným klíčem pro několik služeb a ti, kteří dávají přístup dodavatelům po dobu trvání projektu. Omezení nejsou o nedůvěře, ale o tom, že únik klíče přestává být drahý.
Často kladené otázky
Je možné určit rozsah adres nebo masku?
Ne, jsou uvedeny jednotlivé adresy - do 50 kusů. Pokud je adres více nebo se mění, zkontrolujte úlohu: obvykle stačí navázat klíč na jeden trvalý server.
Co se stane, když necháte seznam prázdný?
Klíč funguje z libovolné adresy, stejně jako před nastavením omezení. Pravidlo je povoleno pouze po dokončení seznamu.
Jsou vyvážení, seznam modelů a dokumentace omezené?
Ne. Toto jsou servisní požadavky, jsou dostupné s jakýmkoli klíčem - jinak by aplikace nemohla zkontrolovat zůstatek a zobrazit dostupné modely.
Musím nové modely povolit ručně?
Ne. Vypnuto je pouze to, co jste nezaškrtli; vše ostatní, včetně nových nástrojů, funguje okamžitě s klíčem.
Lze omezení později změnit?
Ano, kdykoli. Otevřete „Omezení“ vedle klíče, upravte seznam nebo zaškrtávací políčka a uložte – změny se použijí na další požadavky.