Ako integrovať OpenAI API do svojej appky

Ak chcete integrovať OpenAI API, vytvorte API kľúč v projekte OpenAI, uložte ho ako tajomstvo na strane servera s názvom OPENAI_API_KEY a volajte API z trasy na vlastnom serveri pomocou oficiálneho SDK od OpenAI, nikdy z kódu v prehliadači. Podľa rýchleho štartu OpenAI z septembra 2026 je východiskom pre nové projekty Responses API. Pred spustením nastavte limit výdavkov, obmedzte dĺžku odpovedí, ohraničte, ako často môže každý používateľ funkciu volať, a chyby limitu požiadaviek ošetrite opakovaním.

Tento návod pokrýva nastavenie, tok požiadaviek, prompty pre AI tvorcu appiek a chyby, ktoré vedú k únikom kľúčov alebo plytvaniu peniazmi. Údaje od OpenAI sú z jeho oficiálnej dokumentácie k septembru 2026. Všeobecné pojmy (tokeny, kontextové okná, ceny) si najprv prečítajte v článku ako používať LLM API.

Čo sa s tým dá postaviť

• Chatovací asistent vo vnútri appky (ako vytvoriť appku s AI chatbotom)
• Tlačidlá „Zhrň toto“, „Prepíš toto“ alebo „Navrhni odpoveď“
• Extrakcia štruktúrovaných dát z voľného textu: premena e-mailu na objednávku, označovanie podporných tiketov
• Vyhľadávanie a odpovede na otázky nad vaším vlastným obsahom
• Funkcie generovania obrázkov, reči a iných médií, podľa dostupných modelov

Viac nápadov je v článku ako pridať AI funkcie do appky.

Nastavenie účtu OpenAI

1. Vytvorte účet a projekt na platforme OpenAI. Produkčné osvedčené postupy OpenAI odporúčajú oddelené projekty pre staging a produkciu, aby každý mohol mať vlastné kľúče a limity.
2. Vytvorte API kľúč projektu. OpenAI odporúča nastaviť dátum expirácie a kľúče pravidelne rotovať.
3. Nastavte upozornenia na výdavky a pevný limit výdavkov na stránke s limitmi. Sprievodca OpenAI uvádza, že upozornenia vás upozornia, keď využitie prekročí sumu, a pevný limit vynúti mesačný strop.
4. Pridajte fakturáciu. Dokumentácia OpenAI k limitom popisuje úrovne využitia: vaše limity sa automaticky zvyšujú, čím viac v čase míňate.

Tok požiadaviek

Prehliadač  ->  trasa na vašom serveri  ->  OpenAI API
            <-  (streamovaná) odpoveď   <-

1. Používateľ klikne na tlačidlo alebo pošle správu.
2. Prehliadač volá vašu trasu, napríklad POST /api/summarise.
3. Váš server skontroluje, že je používateľ prihlásený a smie túto funkciu použiť.
4. Server zostaví požiadavku: pokyny, vstup používateľa a dáta z databázy, ktoré úloha potrebuje.
5. Volá OpenAI s kľúčom z prostredia. SDK od OpenAI načítajú OPENAI_API_KEY automaticky.
6. Odpoveď streamuje alebo vracia a zaznamenáva využitie tokenov.

Oficiálne SDK od OpenAI sa volajú openai pre JavaScript/TypeScript (npm) aj Python (pip).

Výber modelu

OpenAI ponúka viac modelov s rôznymi cenami a rýchlosťami a ich ponuka sa často mení. Začnite menším, lacnejším modelom, merajte kvalitu na reálnych príkladoch a na väčší prejdite len vtedy, keď ho naozaj potrebujete. Názov modelu držte v konfiguračnej hodnote alebo tajomstve, aby ste ho mohli zmeniť bez prepisovania kódu. Aktuálne sadzby nájdete na cenovej stránke OpenAI.

Možnosti a kompromisy

Prompty pre vášho AI tvorcu

Prvá funkcia:

Pridaj tlačidlo „Zhrň“ na stránku tiketu. Volá serverovú trasu POST /api/summarise, ktorá skontroluje, že je používateľ prihlásený, načíta tiket a volá OpenAI Responses API cez oficiálne SDK openai a tajomstvo OPENAI_API_KEY. Názov modelu načítaj z tajomstva OPENAI_MODEL. Pokyny: „Zhrň v 3 odrážkach a potom navrhni krátku odpoveď. Nevymýšľaj čísla objednávok.“ Obmedz dĺžku výstupu, streamuj odpoveď na stránku a kľúč nikdy neposielaj do prehliadača.

Pravidlá:

Obmedz každého používateľa na 30 požiadaviek AI za hodinu, uložených v databáze. Zaznamenávaj vstupné a výstupné tokeny každej požiadavky s ID používateľa a názvom funkcie. Ak OpenAI vráti 429, rešpektuj hlavičku Retry-After a opakuj s exponenciálnym odstupom a jitterom až 3-krát; potom zobraz „AI je zaneprázdnená, skús to o minútu.“ Pri akejkoľvek inej chybe zobraz priateľskú správu a nechaj zvyšok stránky funkčný.

Ošetrenie chýb a limitov

OpenAI meria limity požiadaviek viacerými spôsobmi, vrátane požiadaviek za minútu a tokenov za minútu, a narazíte na ten, ktorý sa vyčerpá skôr. Keď ho prekročíte, API vráti 429 s hlavičkou Retry-After. Dokumentácia OpenAI uvádza, že túto hodnotu treba brať ako minimum a pridať malé náhodné oneskorenie, aby klienti neopakovali všetci naraz.

Počítajte aj s týmto:

• Časové limity pri dlhých generovaniach. Streamovanie pomáha, rovnako ako rozumný strop výstupu.
• Výpadky poskytovateľa. Funkcia AI má zlyhať elegantne a nerozbiť stránku.
• Zlý výstup. Overte štruktúrovaný výstup pred uložením a nenechajte výstup modelu spúšťať citlivé akcie bez kontroly vo vašom kóde.

Časté chyby

• Kľúč vo frontende alebo v repozitári. Kód v prehliadači je verejný a uniknutý kľúč možno zneužiť za pár minút. Pozrite ako chrániť API kľúče.
• Žiadny limit výdavkov. Slučka alebo zneužívajúci používateľ môže rýchlo nabehnúť veľký účet.
• Žiadne limity na používateľa. Limit poskytovateľa chráni vašu peňaženku, nie ostatných používateľov.
• Dôverovanie promptu v bezpečnosti. Používatelia môžu napísať „ignoruj predchádzajúce pokyny“. Oprávnenia patria do kódu na serveri.
• Posielanie viac, než treba. Celé dokumenty a dlhé históriu násobia náklady. Pošlite len to, čo úloha potrebuje.
• Napevno zapísaný názov modelu. Modely sa aktualizujú a vyraďujú; urobte z neho nastavenie.
• Posielanie osobných údajov bez rozmyslu. Prečítajte si podmienky používania dát od OpenAI a posielajte len to, čo funkcia potrebuje.

Kontrolný zoznam

• Oddelené projekty alebo kľúče OpenAI pre testovanie a produkciu
• Kľúč uložený ako tajomstvo na strane servera, nikdy v kóde v prehliadači ani v repozitári
• Nastavené upozornenia na výdavky a pevný limit výdavkov
• Všetky volania idú cez váš server a kontrolujú oprávnenia používateľa
• Dĺžka výstupu obmedzená; názov modelu nastaviteľný
• Limit požiadaviek na používateľa vo vašej appke
• Ošetrenie 429 s Retry-After, odstupom a jitterom
• Priateľský stav chyby; stránka funguje aj bez AI
• Využitie tokenov zaznamenané pre každú funkciu
• Otestované s dlhými, prázdnymi a nepriateľskými vstupmi

Použitie OpenAI API v Mythexe

AI funkcie v appkách, ktoré stavate na Mythexe, používajú váš vlastný kľúč OpenAI a fakturujú sa na váš účet OpenAI, nie na kredity Mythexu na budovanie. Pridajte OPENAI_API_KEY ako tajomstvo projektu cez /secrets, nastavenia projektu alebo kartu tajomstiev, ktorú agent zobrazí, keď kľúč potrebuje, a potom opíšte funkciu promptom podobným tým vyššie. Po zmene tajomstiev na publikovanej appke ju znova publikujte, aby ich prevzala. Návod Pridanie AI funkcií s vlastnými API kľúčmi obsahuje štartovací prompt a Tajomstvá v chate vysvetľuje kartu tajomstiev. Porovnávate poskytovateľov? Pozrite ako integrovať Claude API.

Otázky