Skip to content

Vlastní klíč OpenAI ​

Na vlastním serveru stačí jeden API klíč OpenAI pro asistenta na boku, AI pomocníka, ranní sumáře i kreslení obrázků. Platíte přímo OpenAI a vaše data jdou jen k OpenAI, nikdy přes nás. Od klíče k prvnímu nakreslenému obrázku vás tahle stránka provede zhruba za deset minut.

Na hostované instanci (killBottleneck Cloud) použijte návod Vlastní model v cloudu. Adresu OpenAI a klíč tam zadáte ve Správě organizace a kreslení zůstává na naší službě.

Co potřebujete ​

  1. API klíč z platform.openai.com → API keys (začíná sk-). Předplatné ChatGPT nestačí, API se platí zvlášť.
  2. Kredit nebo platební kartu na API účtu. Nastavte si tam i měsíční limit (Settings → Limits), ať chyba neudělá velký účet.
  3. Pro kreslení: účet musí mít přístup k modelům na obrázky. OpenAI může nejdřív chtít ověření organizace (Settings → Organization). Do té doby kreslení odmítá a karta obrázku napíše proč.

Asistent ​

Ve Správě organizace → AI funkce vyberte kartu OpenAI a kompatibilní a vyplňte:

PoleHodnota
Adresa APIhttps://api.openai.com/v1
Modelgpt-5.6-luna (změřeno, viz níž) nebo gpt-4o-mini
Tokenváš klíč sk-…

Pak Otestovat připojení a Uložit. Totéž v .env (hodí se pro automatickou instalaci):

bash
KB_AI_PROVIDER=openai
KB_AI_URL=https://api.openai.com/v1
KB_AI_TOKEN=sk-...
KB_AI_MODEL=gpt-5.6-luna
Jedna karta pokryje OpenAI i každou další službu v OpenAI tvaru.

Stejný klíč obslouží i hlasovky (přepíše je OpenAI) a se zapnutým přepínačem Asistent čte obrázky také čtení fotek v asistentovi. Všechny možnosti najdete na stránce Konfigurace.

Uvažující modely fungují bez nastavování navíc ​

gpt-5.6-luna a další modely gpt-5* jsou uvažující. OpenAI u nich odmítá nastavení přemýšlení spolu s voláním nástrojů, a asistent nástroje volá pořád (zakládá kroky, události, pravidla). Do verze v1.0.0 to končilo chybou 400 a do .env bylo potřeba ručně přidat KB_CHAT_OPENAI_EXTRA={"reasoning_effort":"none"}.

Od v1.0.1 si s tím aplikace poradí sama. Když OpenAI nastavení odmítne, zkusí to jednou s vypnutým přemýšlením a případně ještě jednou úplně bez něj. Co u kterého modelu prošlo, si instance pamatuje, takže další tahy projdou hned napoprvé. Když už KB_CHAT_OPENAI_EXTRA v .env máte, můžete ho nechat i smazat. Pořád má přednost.

Co jsme naměřili s gpt-5.6-luna ​

Na čistém účtu, česky, asistent odpovídal a potvrzoval jako běžný uživatel:

  • 20 běžných úkolů (projekt s termíny, schůzka, e-mail, prezentace, stránka s obrázkem, posun termínu, pravidlo na kroky po termínu…): průměrně zhruba 8 sekund na úkol. Napsat celou stránku trvá déle, kolem 90 s.
  • „Připomeň mi zítra v 8 zavolat do banky“: v 10 z 10 běhů vznikla událost v kalendáři s připomínkou. (Před v1.0.1 to bylo 3 z 10: model tvrdil, že připomínky neumí, a uložil jen nápad.)
  • „Každé pondělí v 9:00 mám poradu týmu, dej to do kalendáře“: v 10 z 10 běhů vznikla řada pondělních porad. (Před v1.0.1 to bylo 2 z 10, většinou jediná porada.) Když neřeknete, do kdy, asistent se obvykle nejdřív zeptá (Nejbližší 4 týdny, Do konce roku).

gpt-4o-mini zůstává levnější volbou. V našem srpnovém měření prošel všemi základními AI funkcemi. Výše uvedených 20 úkolů asistenta jsme na něm nepouštěli.

Kreslení obrázků ​

Kreslení má vlastní proměnné, takže pro něj můžete použít jiný klíč (nebo jinou službu):

bash
KB_IMAGE_PROVIDER=openai
KB_IMAGE_TOKEN=sk-...            # může být stejný klíč jako KB_AI_TOKEN
KB_IMAGE_MODEL=gpt-image-1-mini  # výchozí od v1.0.1
KB_IMAGE_TEXT=1                  # volitelně: povolit obrázky s textem

Restartujte aplikaci (docker compose up -d). V Kanceláři se objeví záložka Obrázky a asistent začne na požádání kreslit.

S nastaveným kreslením se v Kanceláři objeví záložka Obrázky. Asistent kreslí i na požádání v rozhovoru.

Co jsme naměřili s gpt-image-1-mini:

  • Jeden obrázek trvá 15–40 sekund (místní model na obrázky je rychlejší, OpenAI pomalejší).
  • Text v obrázku vyšel čitelně včetně diakritiky („PORADA V PONDĚLÍ 9:00“, „Kafe U Lišky“).
  • OpenAI kreslí jen několik velikostí. Banner do e-mailu (1200 × 400) proto vyjde v nejbližší široké velikosti, 1536 × 1024.

Proč gpt-image-1-mini, a ne gpt-image-1

Do v1.0.0 byl výchozí gpt-image-1. Řada nových API klíčů ho už použít nemůže a kreslení hned spadlo s hláškou „Služba obrázků požadavek odmítla (invalid_value)“. Od v1.0.1 je výchozí gpt-image-1-mini, který fungoval na našem testovacím klíči, jenž gpt-image-1 už neměl. Jiný model nastavíte v KB_IMAGE_MODEL.

Víc o obrázcích (styly, prohlížeč, obrázky ve stránkách a v ranním e-mailu) najdete v návodu Obrázky od asistenta.

Když něco nejde ​

Co vidíteCo udělat
Otestovat připojení hlásí 401Špatný nebo smazaný klíč. Vytvořte nový a vložte ho bez mezer.
429 / insufficient_quotaAPI účet nemá kredit, nebo jste narazili na měsíční limit. Dobijte na platform.openai.com.
Asistent hlásí chybu 400 se zmínkou o reasoning_effortMáte v1.0.0 nebo starší. Aktualizujte (Aktualizace), nebo přidejte KB_CHAT_OPENAI_EXTRA={"reasoning_effort":"none"}.
Karta obrázku píše požadavek odmítlaKlíč nemá přístup k modelu. Zkontrolujte KB_IMAGE_MODEL, případně ověřte organizaci u OpenAI.
Záložka Obrázky chybíChybí KB_IMAGE_TOKEN, nebo aplikace po úpravě .env neproběhla restartem.

Kam jdou data ​

Všechno, co asistentovi pošlete, jde k OpenAI: vaše zprávy, výňatky z map, podklady pro stránky a obrázky. Přes nás nic nejde. Co s tím OpenAI dělá, určují jeho podmínky pro API. Klíč zůstává na vašem serveru a do prohlížeče se nikdy nevrací.

Dál ​

Open source pod licencí MIT · © Tengo s.r.o.