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
- API klíč z platform.openai.com → API keys (začíná
sk-). Předplatné ChatGPT nestačí, API se platí zvlášť. - Kredit nebo platební kartu na API účtu. Nastavte si tam i měsíční limit (Settings → Limits), ať chyba neudělá velký účet.
- 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:
| Pole | Hodnota |
|---|---|
| Adresa API | https://api.openai.com/v1 |
| Model | gpt-5.6-luna (změřeno, viz níž) nebo gpt-4o-mini |
| Token | váš klíč sk-… |
Pak Otestovat připojení a Uložit. Totéž v .env (hodí se pro automatickou instalaci):
KB_AI_PROVIDER=openai
KB_AI_URL=https://api.openai.com/v1
KB_AI_TOKEN=sk-...
KB_AI_MODEL=gpt-5.6-lunaStejný 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):
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 textemRestartujte aplikaci (docker compose up -d). V Kanceláři se objeví záložka Obrázky a asistent začne na požádání kreslit.
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íte | Co udělat |
|---|---|
| Otestovat připojení hlásí 401 | Špatný nebo smazaný klíč. Vytvořte nový a vložte ho bez mezer. |
| 429 / insufficient_quota | API úč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_effort | Má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ítla | Klíč 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
- Konfigurace → AI: další poskytovatelé, stropy útraty, zvláštní model pro sumáře
- Proměnné prostředí: všechny volby
KB_AI_*aKB_IMAGE_* - AI asistent na boku: co všechno asistent umí

