Kako vključiti OpenAI API v svojo aplikacijo

Za vključitev OpenAI API ustvarite API ključ v projektu OpenAI, shranite ga kot skrivnost na strežniku z imenom OPENAI_API_KEY in kličite API s poti na svojem strežniku z uradnim OpenAI SDK, nikoli iz kode brskalnika. Od septembra 2026 OpenAI v hitrem začetku predstavlja Responses API kot izhodišče za nove projekte. Pred izdajo nastavite omejitev porabe, omejite dolžino odgovorov, število klicev funkcije na uporabnika in napake omejitve hitrosti obravnavajte s ponovnimi poskusi.

Ta vodnik zajema nastavitev, potek zahteve, pozive za AI graditelj in napake, ki razkrijejo ključe ali zapravijo denar. Podatki o OpenAI so iz njihove uradne dokumentacije po stanju septembra 2026. Za splošne pojme (žetoni, kontekstna okna, cene) najprej preberite kako uporabljati LLM API-je.

Kaj lahko z njim zgradite

Klepetalnega pomočnika v aplikaciji (kako zgraditi aplikacijo s klepetalnim robotom z AI)
Gumbe „Povzemi“, „Prepiši“ ali „Napiši odgovor“
Izluščenje strukturiranih podatkov iz prostega besedila: pretvorba e-pošte v naročilo, označevanje podpornih zahtevkov
Iskanje in odgovarjanje na vprašanja iz vaše vsebine
Generiranje slik, govor in druge medijske funkcije, odvisno od razpoložljivih modelov

Več idej je v kako dodati funkcije z AI v svojo aplikacijo.

Nastavitev računa OpenAI

Ustvarite račun in projekt na platformi OpenAI. OpenAI-jeve najboljše prakse za produkcijo priporočajo ločene projekte za testno in produkcijsko okolje, da ima vsak svoje ključe in omejitve.
Ustvarite API ključ projekta. OpenAI priporoča nastavitev datuma poteka in redno zamenjavo ključev.
Nastavite opozorila o porabi in trdo omejitev porabe na strani z omejitvami. OpenAI-jev vodnik pravi, da vas opozorila obvestijo, ko poraba preseže znesek, trda omejitev pa uveljavi mesečni strop.
Dodajte obračun. OpenAI-jeva dokumentacija o omejitvah opisuje stopnje porabe: vaše omejitve se samodejno zvišajo, ko skozi čas porabite več.

Potek zahteve

Brskalnik  ->  vaša strežniška pot  ->  OpenAI API
           <-  (pretočen) odgovor  <-

Uporabnik klikne gumb ali pošlje sporočilo.
Brskalnik pokliče vašo pot, na primer POST /api/summarise.
Vaš strežnik preveri, ali je uporabnik prijavljen in sme uporabljati funkcijo.
Strežnik zgradi zahtevo: navodila, uporabnikov vnos in podatke iz vaše baze, ki jih naloga potrebuje.
Pokliče OpenAI s ključem iz okolja. Uradni SDK-ji OpenAI samodejno preberejo OPENAI_API_KEY.
Odgovor pretoči ali vrne in zabeleži porabo žetonov.

Uradna SDK-ja OpenAI se imenujeta openai za JavaScript/TypeScript (npm) in Python (pip).

Izbira modela

OpenAI ponuja več modelov po različnih cenah in hitrostih, paleta pa se pogosto spreminja. Začnite z manjšim, cenejšim modelom, kakovost izmerite na pravih primerih in preklopite na večjega le, če ga potrebujete. Ime modela hranite v konfiguraciji ali skrivnosti, da ga lahko spremenite brez prepisovanja kode. Trenutne cene preverite na OpenAI-jevi strani s cenami.

Možnosti in kompromisi

Odločitev	Preprosta izbira	Kdaj iti dlje
Pretakanje	Vrnite celoten odgovor	Pretakajte za klepet in dolge odgovore; uporabniki takoj vidijo besedilo
Spomin pogovora	Pošiljajte nedavna sporočila vsakič	Povzemite starejša sporočila, ko se klepeti podaljšajo
Oblika izhoda	Navaden besedilni odgovor	Zahtevajte strukturiran JSON, kadar vaša koda mora brati polja
Vaši podatki	Vključite ustrezen zapis v zahtevo	Dodajte iskanje po vaši vsebini, kadar je je preveč (kaj je RAG)
Obsežno delo, ki ni nujno	Zanka čez elemente	Uporabite OpenAI-jevo serijsko možnost za nižjo ceno, kadar lahko rezultati počakajo

Poziv za vaš AI graditelj

Prva funkcija:

Dodaj gumb „Povzemi“ na stran z zahtevkom. Kliče strežniško pot POST /api/summarise, ki preveri, ali je uporabnik prijavljen, naloži zahtevek in pokliče OpenAI Responses API z uradnim SDK openai in skrivnostjo OPENAI_API_KEY. Ime modela preberi iz skrivnosti OPENAI_MODEL. Navodila: „Povzemi v 3 alinejah, nato predlagaj kratek odgovor. Ne izmišljuj si številk naročil.“ Omeji dolžino izhoda, odgovor pretakaj na stran in ključa nikoli ne pošiljaj v brskalnik.

Zaščitne ograje:

Omeji vsakega uporabnika na 30 zahtev z AI na uro, shranjenih v bazi. Za vsako zahtevo zabeleži vhodne in izhodne žetone z ID-jem uporabnika in imenom funkcije. Če OpenAI vrne 429, upoštevaj glavo Retry-After, poskusi znova z eksponentnim čakanjem in naključnim zamikom do 3-krat; nato pokaži „AI je zaseden, poskusite čez minuto.“ Za vse druge napake pokaži prijazno sporočilo in naj ostane preostala stran delujoča.

Obravnava napak in omejitev

OpenAI meri omejitve hitrosti na več načinov, vključno z zahtevami na minuto in žetoni na minuto, in omejitev, ki se prva izteče, je tista, ki vas ustavi. Ko jo presežete, API vrne 429 z glavo Retry-After. OpenAI-jeva dokumentacija pravi, naj to vrednost jemljete kot najmanjši čas čakanja in dodate majhen naključni zamik, da se odjemalci ne bi vsi hkrati ponovno poskusili.

Prav tako se pripravite na:

Časovne omejitve pri dolgih generiranjih. Pretakanje pomaga, pomaga pa tudi smiselna omejitev izhoda.
Izpade ponudnika. Funkcija z AI naj se elegantno ponesreči, ne da bi zrušila stran.
Slab izhod. Preverite strukturiran izhod, preden ga shranite, in ne dovolite, da izhod modela sproži občutljiva dejanja brez preverjanja v vaši kodi.

Pogoste napake

Ključ v frontendu ali v repozitoriju. Koda v brskalniku je javna, uhajajoč ključ pa se lahko zlorabi v nekaj minutah. Glejte kako varno hraniti API ključe.
Brez omejitve porabe. Zanka ali zlorabljiv uporabnik lahko hitro naredi velik račun.
Brez omejitev na uporabnika. Omejitev ponudnika varuje vašo denarnico, ne vaših drugih uporabnikov.
Zanašanje na poziv za varnost. Uporabniki lahko vtipkajo „ignore previous instructions“. Dovoljenja sodijo v strežniško kodo.
Pošiljanje več, kot je potrebno. Celotni dokumenti in dolge zgodovine množijo strošek. Pošljite le to, kar naloga potrebuje.
Trdo kodiran ime modela. Modeli se posodabljajo in ukinjajo; naredite ga za nastavitev.
Pošiljanje osebnih podatkov brez razmisleka. Preberite OpenAI-jeve pogoje o uporabi podatkov in pošljite le to, kar funkcija potrebuje.

Kontrolni seznam

Ločeni projekti (ali ključi) OpenAI za testiranje in produkcijo
Ključ shranjen kot skrivnost na strežniku, nikoli v kodi brskalnika ali v repozitoriju
Opozorila o porabi in trda omejitev porabe nastavljeni
Vsi klici gredo prek vašega strežnika in preverjajo dovoljenja uporabnika
Dolžina izhoda omejena; ime modela nastavljivo
Omejitev na uporabnika v aplikaciji
Obravnava 429 z Retry-After, čakanjem in naključnim zamikom
Prijazno stanje napake; stran deluje brez AI
Poraba žetonov zabeležena po funkciji
Preizkušeno z dolgimi, praznimi in sovražnimi vnosi

Uporaba OpenAI API v Mythex

Funkcije z AI v aplikacijah, ki jih gradite na Mythex, uporabljajo vaš lasten ključ OpenAI in se obračunavajo na vaš račun OpenAI, ne na kredite za gradnjo Mythex. Dodajte OPENAI_API_KEY kot skrivnost projekta prek /secrets, nastavitev projekta ali kartice s skrivnostmi, ki jo agent prikaže, ko potrebuje ključ, nato opišite funkcijo s pozivom, kot so zgornji. Po spremembi skrivnosti na objavljeni aplikaciji jo objavite znova, da prevzame nove vrednosti. Recept v dokumentaciji Dodajanje funkcij z AI z lastnimi API ključi vsebuje začetni poziv, Skrivnosti v klepetu pa pojasni kartico s skrivnostmi. Primerjate ponudnike? Glejte kako vključiti Claude API.

Vprašanja

Kateri OpenAI API naj uporabim za novo aplikacijo?

Od septembra 2026 OpenAI v hitrem začetku predstavlja Responses API kot izhodišče za nove projekte, primeri pa uporabljajo client.responses.create() v uradnih SDK-jih. Pred začetkom preverite trenutno priporočilo v OpenAI dokumentaciji.

Ali lahko kličem OpenAI API iz brskalnika?

Ne s svojim skrivnim ključem. Kdorkoli lahko prebere kodo v brskalniku in ključ ponovno uporabi, da vam poveča račun. Brskalnik mora klicati vašo strežniško pot, vaš strežnik pa OpenAI s ključem, shranjenim kot spremenljivka okolja.

Kako preprečim, da bi OpenAI API preveč stal?

OpenAI-jev vodnik za produkcijo priporoča opozorila o porabi in trdo mesečno omejitev na strani z omejitvami. V aplikaciji omejite dolžino odgovorov, število zahtev na uporabnika in beležite porabo žetonov, da vidite, katere funkcije najbolj stanejo.

Kaj pomeni napaka 429 pri OpenAI?

Pomeni, da ste dosegli omejitev hitrosti. OpenAI-jeva dokumentacija pravi, da odgovor vključuje glavo Retry-After; počakajte vsaj toliko, dodajte kratek naključni zamik in poskusite znova z eksponentnim čakanjem.