OpenAI API integrálása az appodba

Az OpenAI API integrálásához hozz létre API-kulcsot egy OpenAI-projektben, tárold szerveroldali titokként OPENAI_API_KEY néven, és hívd az API-t a saját szervereden lévő útvonalról, az OpenAI hivatalos SDK-jával — soha nem böngészőkódból. 2026 szeptemberében az OpenAI gyorsindítója a Responses API-t mutatja be az új projektek kiindulópontjaként. Indulás előtt állíts be költséghatárt, korlátozd a válaszok hosszát, korlátozd, hányszor hívhatja egy felhasználó a funkciót, és a sebességkorlát-hibákat újrapróbálkozással kezeld.

Ez az útmutató a beállítást, a kérési folyamatot, AI-építőknek szóló promptokat és azokat a hibákat fedi le, amelyek kiszivárogtatják a kulcsokat vagy pénzt égetnek el. Az OpenAI részletei a hivatalos dokumentációjából származnak, 2026 szeptemberi állapot szerint. Az általános fogalmakhoz (tokenek, kontextusablakok, árazás) olvasd el először a hogyan használj LLM API-kat cikket.

Mire építhetsz vele

• Chat-asszisztens az appodon belül (hogyan építs AI-chatbot appot)
• „Összefoglalás”, „átírás” vagy „válasz piszkozata” gombok
• Strukturált adatok kinyerése szabad szövegből: egy e-mail rendelésé alakítása, támogatási jegyek címkézése
• Keresés és kérdés-válasz a saját tartalmadon
• Kép-generálás, beszéd és más médiafunkciók, a rendelkezésre álló modellektől függően

Tovább ötletekért: hogyan adj AI-funkciókat az appodhoz.

Az OpenAI-fiók beállítása

1. Hozz létre fiókot és projektet az OpenAI platformon. Az OpenAI éles használatra vonatkozó ajánlásai külön projekteket javasolnak a stagingnek és az élesnek, hogy mindegyiknek saját kulcsai és korlátai legyenek.
2. Hozz létre projekt-API-kulcsot. Az OpenAI lejárati dátum beállítását és a kulcsok rendszeres cseréjét javasolja.
3. Állíts be költségriasztásokat és kemény költséghatárt a limitek oldalán. Az OpenAI útmutatója szerint a riasztások értesítenek, ha a használat átlép egy összeget, a kemény limit pedig havi plafont érvényesít.
4. Adj hozzá fizetési módot. Az OpenAI sebességkorlát-dokumentációja használati szinteket ír le: a limitjeid automatikusan nőnek, ahogy időben többet költesz.

A kérési folyamat

Böngésző  ->  a te szerveri útvonalad  ->  OpenAI API
          <-  (streamelt) válasz      <-

1. A felhasználó rákattint egy gombra vagy üzenetet küld.
2. A böngésző a te útvonaladat hívja, például POST /api/summarise.
3. A szervered ellenőrzi, hogy a felhasználó be van-e jelentkezve és használhatja-e a funkciót.
4. A szerver felépíti a kérést: az utasításokat, a felhasználó bemenetét és az adatbázisodból a feladathoz szükséges adatokat.
5. Meghívja az OpenAI-t a környezetből olvasott kulccsal. Az OpenAI SDK-k az OPENAI_API_KEY értéket automatikusan beolvassák.
6. Streamelve vagy egyben visszaadja a választ, és naplózza a tokenhasználatot.

Az OpenAI hivatalos SDK-csomagjai openai néven érhetők el JavaScripthez/TypeScripthez (npm) és Pythonhoz (pip).

Modell kiválasztása

Az OpenAI többféle modellt kínál, eltérő árakkal és sebességgel, és a kínálat gyakran változik. Kezdj kisebb, olcsóbb modellel, mérd a minőséget valódi példákon, és csak akkor lépj feljebb, ha kell. A modellnevet tartsd konfigurációs értékben vagy titokban, hogy kódírás nélkül lehessen váltani. Az aktuális díjakért nézd meg az OpenAI árazási oldalát.

Lehetőségek és kompromisszumok

Promptok az AI-építődnek

Egy első funkció:

Adj hozzá egy „Összefoglalás” gombot a jegy oldalán. Hívjon egy szerveroldali útvonalat, POST /api/summarise, amely ellenőrzi, hogy a felhasználó be van-e jelentkezve, betölti a jegyet, és meghívja az OpenAI Responses API-t a hivatalos openai SDK-val és a titkos OPENAI_API_KEY kulccsal. A modellnevet a titkos OPENAI_MODEL értékből olvassa. Utasítások: „Foglald össze 3 felsorolási pontban, majd javasolj egy rövid választ. Ne találj ki rendelésszámokat.” Korlátozd a kimenet hosszát, streameld a választ az oldalra, és a kulcsot soha ne küldd a böngészőnek.

Korlátok:

Korlátozd felhasználónként óránként 30 AI-kérésre, az adatbázisban tárolva. Minden kérésnél naplózd a bemeneti és kimeneti tokeneket a felhasználó azonosítójával és a funkció nevével. Ha az OpenAI 429-et ad, tiszteld a Retry-After fejlécet, és próbálkozz újra exponenciális visszalépéssel és véletlen eltolással legfeljebb 3-szor; utána mutasd: „Az AI foglalt, próbáld újra egy perc múlva.” Bármely más hibánál mutass barátságos üzenetet, és az oldal többi része maradjon működőképes.

Hibák és korlátok kezelése

Az OpenAI többféleképpen méri a sebességkorlátokat, például kérés/perc és token/perc értékben, és az hamarabb fogy el, amelyik előbb éri el a határt. Ha túllépsz egyet, az API 429-et ad egy Retry-After fejléccel. Az OpenAI dokumentációja szerint ezt az értéket minimumnak kell tekinteni, és adj hozzá egy kis véletlen késleltetést, hogy a kliensek ne próbálkozzanak mind egyszerre.

Ezekre is készülj fel:

• Időtúllépés hosszú generálásnál. A streamelés segít, és egy észszerű kimeneti plafon is.
• Szolgáltatói kiesések. Az AI-funkció essen vissza szépen, az oldal többi része ne törjön el.
• Rossz kimenet. Strukturált kimenetet validálj, mielőtt elmentenéd, és ne engedd, hogy a modell kimenete érzékeny műveletet indítson kódodbeli ellenőrzés nélkül.

Gyakori hibák

• A kulcs a frontendben vagy a repóban. A böngészőkód nyilvános, egy kiszivárgott kulcsot percek alatt vissza lehet élni. Lásd: hogyan őrizd biztonságban az API-kulcsaidat.
• Nincs költséghatár. Egy ciklus vagy egy visszaélő felhasználó gyorsan nagy számlát tud okozni.
• Nincsenek felhasználónkénti korlátok. A szolgáltatói limit a pénztárcádat védi, nem a többi felhasználódat.
• A biztonság bízása a promptra. A felhasználók beírhatják: „hagyd figyelmen kívül a korábbi utasításokat”. A jogosultságok a szerverkódba tartoznak.
• Többet küldeni, mint kell. A teljes dokumentumok és hosszú előzmények szorozzák a költséget. Csak azt küldd, amire a feladatnak szüksége van.
• A modellnév beégetése. A modellek frissülnek és kivezetésre kerülnek; legyen beállítás.
• Személyes adatok gondolkodás nélküli küldése. Olvasd el az OpenAI adathasználati feltételeit, és csak azt küldd, amire a funkciónak szüksége van.

Ellenőrzőlista

• Külön OpenAI-projektek (vagy kulcsok) a teszteléshez és az éleshez
• A kulcs szerveroldali titokként tárolva, soha nem böngészőkódban vagy a repóban
• Költségriasztások és kemény költséghatár beállítva
• Minden hívás a szerveren megy, és ellenőrzi a felhasználó jogosultságait
• A kimenet hossza korlátozva; a modellnév konfigurálható
• Felhasználónkénti sebességkorlát az appban
• 429-kezelés a Retry-After, visszalépés és véletlen eltolás szerint
• Barátságos hibaállapot; az oldal működik AI nélkül is
• A tokenhasználat funkciónként naplózva
• Tesztelve hosszú, üres és ellenséges bemenetekkel

Az OpenAI API használata a Mythexben

A Mythexen épített appokban az AI-funkciók a saját OpenAI-kulcsodat használják, és az OpenAI-fiókodra terhelődnek, nem a Mythex build-kreditjeire. Add hozzá az OPENAI_API_KEY értéket projekt-titokként a /secrets oldalon, a projektbeállításokban vagy abban a titokkártyában, amelyet az ágenst mutat, ha kulcsra van szüksége, majd írd le a funkciót a fenti promptokhoz hasonlóan. Közzétett appnál a titkok módosítása után publikálj újra, hogy az app átvegye őket. A dokumentációs AI-funkciók hozzáadása a saját API-kulcsokkal recept kezdő promptot ad, a Titkok a csevegésben pedig a titokkártyát magyarázza. Szolgáltatókat hasonlítasz? Lásd: hogyan integráld a Claude API-t.

Kérdések