Kako integrisati OpenAI API u svoju aplikaciju

Da biste integrisali OpenAI API, napravite API ključ u OpenAI projektu, čuvajte ga kao tajnu na serveru pod imenom OPENAI_API_KEY i pozivajte API iz rute na vlastitom serveru koristeći OpenAI-jev zvanični SDK, nikada iz koda u pregledaču. Od septembra 2026. OpenAI-jev vodič za brzi start predstavlja Responses API kao polaznu tačku za nove projekte. Prije lansiranja postavite ograničenje potrošnje, ograničite dužinu odgovora, ograničite koliko često svaki korisnik može pozivati funkciju i obradite greške ograničenja zahtjeva ponavljanjem.

Ovaj vodič pokriva postavljanje, tok zahtjeva, upite za AI graditelja i greške koje otkrivaju ključeve ili troše novac. Podaci o OpenAI-ju su iz njegove zvanične dokumentacije od septembra 2026. Za opće pojmove (tokeni, kontekstni prozori, cijene) prvo pročitajte kako koristiti LLM API-je.

Šta s njim možete napraviti

• Chat asistenta unutar aplikacije (kako napraviti aplikaciju AI chatbota)
• Dugmad „Sažmi ovo”, „Prepiši ovo” ili „Napiši nacrt odgovora”
• Izdvajanje strukturiranih podataka iz slobodnog teksta: pretvaranje e-poruke u narudžbu, označavanje tiketa podrške
• Pretragu i odgovaranje na pitanja iz vašeg sadržaja
• Generisanje slika, govor i druge medijske funkcije, zavisno od dostupnih modela

Više ideja nalazi se u kako dodati AI funkcije u svoju aplikaciju.

Postavljanje OpenAI računa

1. Napravite račun i projekt na OpenAI platformi. OpenAI-jeve najbolje prakse za produkciju preporučuju odvojene projekte za staging i produkciju, tako da svaki ima svoje ključeve i ograničenja.
2. Napravite API ključ projekta. OpenAI preporučuje postavljanje datuma isteka i redovnu zamjenu ključeva.
3. Postavite upozorenja o potrošnji i tvrdo ograničenje na stranici s ograničenjima. OpenAI-jev vodič kaže da upozorenja obavještavaju kada potrošnja pređe iznos, a tvrdo ograničenje sprovodi mjesečnu granicu.
4. Dodajte naplatu. OpenAI-jeva dokumentacija o ograničenjima opisuje nivoe korištenja: vaša ograničenja automatski rastu kako tokom vremena trošite više.

Tok zahtjeva

Pregledač  ->  vaša ruta na serveru  ->  OpenAI API
           <-  (streamovan) odgovor  <-

1. Korisnik klikne dugme ili pošalje poruku.
2. Pregledač poziva vašu rutu, na primjer POST /api/summarise.
3. Vaš server provjerava da je korisnik prijavljen i da smije koristiti funkciju.
4. Server gradi zahtjev: upute, unos korisnika i sve podatke iz vaše baze koje zadatak treba.
5. Poziva OpenAI s ključem iz okruženja. OpenAI-jevi SDK-ovi automatski čitaju OPENAI_API_KEY.
6. Streamuje ili vraća odgovor i bilježi potrošnju tokena.

OpenAI-jevi zvanični SDK paketi se zovu openai i za JavaScript/TypeScript (npm) i za Python (pip).

Izbor modela

OpenAI nudi više modela različitih cijena i brzina, a ponuda se često mijenja. Počnite s manjim, jeftinijim modelom, izmjerite kvalitet na stvarnim primjerima i prelazite na veći samo ako je potrebno. Držite naziv modela u konfiguracijskoj vrijednosti ili tajni da ga možete promijeniti bez prepisivanja koda. Pogledajte OpenAI stranicu s cijenama za aktuelne tarife.

Opcije i kompromisi

Upiti za vašeg AI graditelja

Prva funkcija:

Dodaj dugme „Sažmi” na stranici tiketa. Ono poziva rutu na serveru POST /api/summarise koja provjerava da je korisnik prijavljen, učitava tiket i poziva OpenAI Responses API koristeći zvanični openai SDK i tajnu OPENAI_API_KEY. Čitaj naziv modela iz tajne OPENAI_MODEL. Upute: „Sažmi u 3 tačke, zatim predloži kratak odgovor. Ne izmišljaj brojeve narudžbi.” Ograniči dužinu izlaza, streamuj odgovor na stranicu i nikada ne šalji ključ pregledaču.

Zaštitne mjere:

Ograniči svakog korisnika na 30 AI zahtjeva po satu, sačuvanih u bazi podataka. Bilježi ulazne i izlazne tokene po zahtjevu uz ID korisnika i naziv funkcije. Ako OpenAI vrati 429, poštuj zaglavlje Retry-After i ponovi uz eksponencijalno čekanje i nasumično kašnjenje do 3 puta; nakon toga prikaži „AI je zauzet, pokušajte za minut.” Za svaku drugu grešku prikaži prijateljsku poruku i neka ostatak stranice radi.

Obrada grešaka i ograničenja

OpenAI mjeri ograničenja na više načina, uključujući zahtjeve po minuti i tokene po minuti, a dostignete ono koje se prvo potroši. Kada ga premašite, API vraća 429 sa zaglavljem Retry-After. OpenAI-jeva dokumentacija kaže da tu vrijednost tretirate kao minimum i dodate kratko nasumično kašnjenje da se klijenti ne bi svi ponovo pokušali istovremeno.

Takođe predvidite:

• Isteke vremena kod dugih generisanja. Streaming pomaže, kao i razumno ograničenje izlaza.
• Ispade provajdera. AI funkcija treba da zakaže elegantno, bez rušenja stranice.
• Loš izlaz. Provjerite strukturirani izlaz prije čuvanja i ne dozvolite da izlaz modela pokrene osjetljive radnje bez provjere u vašem kodu.

Česte greške

• Ključ u frontendu ili u repozitoriju. Kod u pregledaču je javan, a procurjeli ključ može se zloupotrijebiti u roku od nekoliko minuta. Pogledajte kako čuvati API ključeve sigurnim.
• Nema ograničenja potrošnje. Petlja ili zloupotrebljavajući korisnik mogu brzo napraviti veliki račun.
• Nema ograničenja po korisniku. Ograničenje provajdera štiti vaš novčanik, a ne vaše ostale korisnike.
• Oslanjanje na upit za sigurnost. Korisnici mogu upisati „zanemari prethodne upute”. Dozvole pripadaju kodu na serveru.
• Slanje više nego što treba. Cijeli dokumenti i dugi historijati višestruko povećavaju cijenu. Šaljite ono što zadatak treba.
• Ugrađivanje naziva modela u kod. Modeli se ažuriraju i povlače; neka to bude postavka.
• Slanje ličnih podataka bez razmišljanja. Pročitajte OpenAI uslove korištenja podataka i šaljite samo ono što funkcija treba.

Kontrolna lista

• Odvojeni OpenAI projekti (ili ključevi) za testiranje i produkciju
• Ključ sačuvan kao tajna na serveru, nikada u kodu u pregledaču ili repozitoriju
• Postavljena upozorenja o potrošnji i tvrdo ograničenje potrošnje
• Svi pozivi prolaze kroz vaš server i provjeravaju dozvole korisnika
• Ograničena dužina izlaza; naziv modela je podesiv
• Ograničenje zahtjeva po korisniku u vašoj aplikaciji
• Obrada 429 s Retry-After, čekanjem i nasumičnim kašnjenjem
• Prijateljsko stanje greške; stranica radi bez AI-ja
• Potrošnja tokena bilježi se po funkciji
• Testirano s dugim, praznim i neprijateljskim unosima

Korištenje OpenAI API-ja u Mythexu

AI funkcije u aplikacijama koje gradite na Mythexu koriste vlastiti OpenAI ključ, naplaćen na vaš OpenAI račun, a ne iz Mythex kredita za izgradnju. Dodajte OPENAI_API_KEY kao tajnu projekta preko /secrets, postavki projekta ili kartice s tajnama koju agent prikaže kada mu treba ključ, zatim opišite funkciju upitom sličnim gore navedenim. Nakon promjene tajni u objavljenoj aplikaciji, ponovo je objavite da bi ih preuzela. Recept iz dokumentacije Dodajte AI funkcije uz svoje API ključeve ima početni upit, a Tajne u chatu objašnjava karticu s tajnama. Poredite provajdere? Pogledajte kako integrisati Claude API.

Pitanja