Kako ugraditi OpenAI API u svoju aplikaciju

Za ugradnju OpenAI API-ja stvorite API ključ u OpenAI projektu, spremite ga kao tajnu vrijednost na poslužitelju pod imenom OPENAI_API_KEY i pozovite API s rute na vlastitom poslužitelju koristeći OpenAI-jev službeni SDK, nikada iz koda u pregledniku. Od rujna 2026. OpenAI-jev brzi početak predstavlja Responses API kao polazište za nove projekte. Prije lansiranja postavite ograničenje potrošnje, ograničite duljinu odgovora, ograničite koliko često svaki korisnik može pozvati značajku i obradite greške ograničenja brzine ponovnim pokušajima.

Ovaj vodič pokriva postavljanje, tijek zahtjeva, upite za AI graditelj i greške koje otkrivaju ključeve ili troše novac. Podaci o OpenAI-ju su iz njihove službene dokumentacije od rujna 2026. Za opće pojmove (tokeni, kontekstualni prozori, cijene) najprije pročitajte kako koristiti LLM API-je.

Što s njim možete izgraditi

Chat asistenta unutar aplikacije (kako izraditi aplikaciju AI chatbota)
Gumbe „Sažmi ovo“, „Prepiši ovo“ ili „Napiši nacrt odgovora“
Izvlačenje strukturiranih podataka iz slobodnog teksta: pretvaranje e-poruke u narudžbu, označavanje zahtjeva podrške
Pretraživanje i odgovaranje na pitanja iz vlastitog sadržaja
Generiranje slika, govor i druge medijske značajke, ovisno o dostupnim modelima

Više ideja nalazi se u kako dodati AI značajke u svoju aplikaciju.

Postavljanje OpenAI računa

Kreirajte račun i projekt na OpenAI platformi. OpenAI-jeve najbolje prakse za produkciju preporučuju zasebne projekte za staging i produkciju, kako svaki može imati vlastite ključeve i ograničenja.
Kreirajte API ključ projekta. OpenAI preporučuje postavljanje datuma isteka i redovitu zamjenu ključeva.
Postavite upozorenja o potrošnji i tvrdo ograničenje potrošnje na stranici s ograničenjima. OpenAI-jev vodič kaže da upozorenja obavještavaju kada potrošnja prijeđe iznos, a tvrdo ograničenje nameće mjesečnu granicu.
Dodajte naplatu. OpenAI-jeva dokumentacija o ograničenjima opisuje razine korištenja: ograničenja vam automatski rastu kako tijekom vremena trošite više.

Tijek zahtjeva

Preglednik  ->  vaša ruta na poslužitelju  ->  OpenAI API
            <-  (streamani) odgovor       <-

Korisnik klikne gumb ili pošalje poruku.
Preglednik poziva vašu rutu, na primjer POST /api/summarise.
Vaš poslužitelj provjerava je li korisnik prijavljen i smije li koristiti značajku.
Poslužitelj gradi zahtjev: upute, unos korisnika i sve podatke iz vaše baze koje zadatak treba.
Poziva OpenAI s ključem iz okruženja. OpenAI-jevi SDK-ovi automatski čitaju OPENAI_API_KEY.
Streama ili vraća odgovor i bilježi potrošnju tokena.

OpenAI-jevi službeni SDK paketi zovu se openai i za JavaScript/TypeScript (npm) i za Python (pip).

Odabir modela

OpenAI nudi nekoliko modela s različitim cijenama i brzinama, a ponuda se često mijenja. Počnite s manjim, jeftinijim modelom, izmjerite kvalitetu na stvarnim primjerima i prijeđite na veći samo ako je potrebno. Držite naziv modela u konfiguracijskoj vrijednosti ili tajni kako biste ga mogli promijeniti bez prepisivanja koda. Aktualne cijene pogledajte na OpenAI-jevoj stranici s cijenama.

Opcije i kompromisi

Odluka	Jednostavan izbor	Kada ići dalje
Streaming	Vratiti cijeli odgovor	Streamajte za chat i duge odgovore; korisnici odmah vide tekst
Memorija razgovora	Slati nedavne poruke svaki put	Sažimajte starije poruke kada chatovi postanu dugi
Format izlaza	Običan tekst	Tražite strukturirani JSON kada vaš kod mora čitati polja
Vlastiti podaci	Uključiti relevantan zapis u zahtjev	Dodajte pretraživanje po svom sadržaju kada ga ima previše za uključivanje (pogledajte što je RAG)
Veliki, nehitni poslovi	Petlja po stavkama	Koristite OpenAI-jevu opciju batcheva za nižu cijenu kada rezultati mogu pričekati

Upiti za vaš AI graditelj

Prva značajka:

Dodaj gumb „Sažmi“ na stranici zahtjeva. Poziva rutu na poslužitelju POST /api/summarise koja provjerava je li korisnik prijavljen, učitava zahtjev i poziva OpenAI Responses API koristeći službeni openai SDK i tajnu OPENAI_API_KEY. Učitaj naziv modela iz tajne OPENAI_MODEL. Upute: „Sažmi u 3 točke, zatim predloži kratak odgovor. Ne izmišljaj brojeve narudžbi.“ Ograniči duljinu izlaza, streamaj odgovor na stranicu i nikada ne šalji ključ pregledniku.

Zaštitne mjere:

Ograniči svakog korisnika na 30 AI zahtjeva po satu, spremljeno u bazi podataka. Bilježi ulazne i izlazne tokene po zahtjevu uz ID korisnika i naziv značajke. Ako OpenAI vrati 429, poštuj zaglavlje Retry-After i ponovi uz eksponencijalno čekanje i jitter do 3 puta; nakon toga prikaži „AI je zauzet, pokušajte ponovno za minutu.“ Za svaku drugu grešku prikaži prijateljsku poruku i neka ostatak stranice radi.

Obrada grešaka i ograničenja

OpenAI mjeri ograničenja brzine na više načina, uključujući zahtjeve po minuti i tokene po minuti, a vi dosegnete onaj koji se prvi potroši. Kada prijeđete jedno, API vraća 429 sa zaglavljem Retry-After. OpenAI-jeva dokumentacija kaže da tu vrijednost treba shvatiti kao minimum i dodati malo slučajnog kašnjenja kako klijenti ne bi svi ponovno pokušavali u isto vrijeme.

Također planirajte:

Vremenska ograničenja kod dugih generiranja. Streaming pomaže, kao i razumno ograničenje izlaza.
Prekide rada pružatelja. AI značajka treba elegantno zakazati, bez rušenja stranice.
Loš izlaz. Provjerite strukturirani izlaz prije spremanja i ne dopustite da izlaz modela pokrene osjetljive radnje bez provjere u vašem kodu.

Česte greške

Ključ u frontendu ili u repozitoriju. Kod u pregledniku je javan, a procurjeli ključ može se zloupotrijebiti u nekoliko minuta. Pogledajte kako čuvati API ključeve sigurnima.
Nema ograničenja potrošnje. Petlja ili zloupotrebljavajući korisnik mogu brzo napraviti velik račun.
Nema ograničenja po korisniku. Ograničenje vašeg pružatelja štiti vaš novčanik, a ne ostale korisnike.
Oslanjanje na upit za sigurnost. Korisnici mogu upisati „zanemari prethodne upute“. Dozvole pripadaju kodu na poslužitelju.
Slanje više nego što treba. Cijeli dokumenti i dugačke povijesti višestruko povećavaju trošak. Pošaljite što zadatak treba.
Tvrdo kodiran naziv modela. Modeli se ažuriraju i povlače; neka bude postavka.
Slanje osobnih podataka bez razmišljanja. Pročitajte OpenAI-jeve uvjete korištenja podataka i šaljite samo ono što značajka treba.

Popis za provjeru

Zasebni OpenAI projekti (ili ključevi) za testiranje i produkciju
Ključ spremljen kao tajna na poslužitelju, nikada u kodu u pregledniku ili repozitoriju
Postavljena upozorenja o potrošnji i tvrdo ograničenje potrošnje
Svi pozivi idu preko vašeg poslužitelja i provjeravaju dozvole korisnika
Duljina izlaza ograničena; naziv modela podesiv
Ograničenje po korisniku u vašoj aplikaciji
Obrada 429 s Retry-After, čekanjem i jitterom
Prijateljsko stanje greške; stranica radi bez AI-ja
Potrošnja tokena bilježi se po značajci
Testirano dugim, praznim i neprijateljskim unosima

Korištenje OpenAI API-ja u Mythexu

AI značajke u aplikacijama koje gradite na Mythexu koriste vaš vlastiti OpenAI ključ, naplaćen na vaš OpenAI račun, a ne na Mythex kredite za izradu. Dodajte OPENAI_API_KEY kao tajnu projekta putem /secrets, postavki projekta ili kartice s tajnama koju agent prikaže kada mu treba ključ, zatim opišite značajku upitom sličnim gore navedenima. Nakon promjene tajni na objavljenoj aplikaciji ponovno je objavite kako bi ih preuzela. Dokumentacijski recept Dodavanje AI značajki s vlastitim API ključevima sadrži početni upit, a Tajne u chatu objašnjava karticu s tajnama. Uspoređujete pružatelje? Pogledajte kako ugraditi Claude API.

Pitanja

Koji OpenAI API trebam koristiti za novu aplikaciju?

Od rujna 2026. OpenAI-jev brzi početak predstavlja Responses API kao polazište za nove projekte, s primjerima koji koriste client.responses.create() u njihovim službenim SDK-ovima. Prije početka provjerite OpenAI-jevu dokumentaciju za aktualnu preporuku.

Mogu li pozivati OpenAI API iz preglednika?

Ne s vašim tajnim ključem. Svatko može pročitati kod u pregledniku i ponovno upotrijebiti ključ kako bi povećao vaš račun. Preglednik treba pozivati vašu vlastitu rutu na poslužitelju, a vaš poslužitelj poziva OpenAI s ključem spremljenim kao varijabla okruženja.

Kako spriječiti da OpenAI API previše košta?

OpenAI-jev vodič za produkciju preporučuje upozorenja o potrošnji i tvrdo mjesečno ograničenje potrošnje na stranici s ograničenjima. U svojoj aplikaciji ograničite duljinu odgovora, ograničite zahtjeve po korisniku i bilježite potrošnju tokena kako biste vidjeli koje značajke najviše koštaju.

Što znači greška 429 od OpenAI-ja?

Znači da ste dosegnuli ograničenje brzine. OpenAI-jeva dokumentacija o ograničenjima kaže da odgovor sadrži zaglavlje Retry-After; pričekajte barem toliko, dodajte malo slučajnog kašnjenja i ponovite uz eksponencijalno čekanje.