Kuidas integreerida OpenAI API oma rakendusse

OpenAI API integreerimiseks loo OpenAI projektis API-võti, hoia see serveripoolse saladusena nimega OPENAI_API_KEY ja kutsu API-d oma serveri marsruudist, kasutades OpenAI ametlikku SDK-d, mitte kunagi brauseri koodist. 2026. aasta septembri seisuga esitab OpenAI kiirjuhend Responses API alguspunktina uutele projektidele. Sea kulupiirang enne avamist, piira vastuse pikkust, piira, kui sageli iga kasutaja funktsiooni kasutada saab, ja käsitle piirangu vigu uuesti proovimisega.

See juhend käsitleb seadistamist, päringuvoogu, prompte AI-ehitajale ja vigu, mis lekitavad võtmeid või raiskavad raha. OpenAI andmed on pärit nende ametlikust dokumentatsioonist 2026. aasta septembri seisuga. Üldiste mõistete (tokenid, kontekstiaknad, hinnastamine) jaoks loe kõigepealt kuidas kasutada LLM API-sid.

Mida selle abil ehitada

• Vestlusassistent sinu rakenduses (kuidas ehitada AI-vestlusroboti rakendus)
• Nupud „Võta kokku“, „Ümberkirjuta“ või „Koosta vastus“
• Struktureeritud andmete eraldamine vabateksti seest: e-kirja muutmine tellimuseks, tugipiletite märgistamine
• Otsing ja küsimustele vastamine sinu enda sisu põhjal
• Pildi genereerimine, kõne ja muud meediafunktsioonid, sõltuvalt saadaolevatest mudelitest

Rohkem ideid on lehel kuidas lisada AI-funktsioone oma rakendusse.

OpenAI konto seadistamine

1. Loo konto ja projekt OpenAI platvormil. OpenAI tootmise parimad tavad soovitavad eraldi projekte testimiseks ja tootmiseks, et kumbki saaks oma võtmed ja piirangud.
2. Loo projekti API-võti. OpenAI soovitab seada aegumiskuupäeva ja võtmeid regulaarselt vahetada.
3. Seadista kulu teavitused ja kindel kulupiirang piirangute lehel. OpenAI juhendi järgi teavitavad hoiatused, kui kasutus ületab summa, ja kindel piirang jõustab kuukulu ülempiiri.
4. Lisa arveldus. OpenAI piirangute dokumentatsioon kirjeldab kasutustasemeid: sinu piirangud tõusevad automaatselt, kui kulutad ajaga rohkem.

Päringu voog

Brauser  ->  sinu serveri marsruut  ->  OpenAI API
         <-  (voogedastatud) vastus <-

1. Kasutaja klõpsab nupule või saadab sõnumi.
2. Brauser kutsub sinu marsruuti, näiteks POST /api/summarise.
3. Sinu server kontrollib, et kasutaja on sisse logitud ja tohib funktsiooni kasutada.
4. Server koostab päringu: juhised, kasutaja sisend ja andmed sinu andmebaasist, mida ülesanne vajab.
5. See kutsub OpenAI-d võtmega keskkonnast. OpenAI SDK-d loevad OPENAI_API_KEY automaatselt.
6. See voogedastab või tagastab vastuse ja logib tokenite kasutuse.

OpenAI ametlik SDK pakett on nimega openai nii JavaScripti/TypeScripti (npm) kui ka Pythoni (pip) jaoks.

Mudeli valimine

OpenAI pakub mitut mudelit erinevate hindade ja kiirustega ning valik muutub sageli. Alusta väiksema ja odavama mudeliga, mõõda kvaliteeti päris näidetel ning mine suuremale ainult siis, kui seda vajad. Hoia mudeli nimi konfiguratsiooni väärtuses või saladuses, et saaksid seda muuta ilma koodi ümber kirjutamata. Praeguste hindade jaoks vaata OpenAI hinnastamise lehte.

Valikud ja kompromissid

Promptid AI-ehitajale

Esimene funktsioon:

Lisa piletilehele nupp „Võta kokku“. See kutsub serveri marsruuti POST /api/summarise, mis kontrollib, et kasutaja on sisse logitud, laadib pileti ja kutsub OpenAI Responses API-d ametliku openai SDK-ga ja saladusega OPENAI_API_KEY. Loe mudeli nimi saladusest OPENAI_MODEL. Juhised: „Võta kokku 3 punktina, seejärel paku lühike vastus. Ära leiuta tellimuste numbreid.“ Piira väljundi pikkust, voogedasta vastus lehele ja ära kunagi saada võtit brauserile.

Piirangud:

Piira iga kasutaja 30 AI-päringuga tunnis, mis salvestatakse andmebaasi. Logi sisend- ja väljundtokenid iga päringu kohta koos kasutaja ID ja funktsiooni nimega. Kui OpenAI tagastab 429, arvesta päist Retry-After ja proovi uuesti eksponentsiaalse ooteajaga ja juhuslikkusega kuni 3 korda; pärast seda näita „AI on hõivatud, proovi mõne minuti pärast uuesti.“ Mis tahes muu tõrke korral näita viisakat veateadet ja hoia ülejäänud leht töös.

Vigade ja piirangute käsitlemine

OpenAI mõõdab päringupiiranguid mitmel viisil, sealhulgas päringuid minutis ja tokeneid minutis, ja jõuad alati sellele, mis otsa saab esimesena. Kui ületad ühe neist, tagastab API 429 koos päisega Retry-After. OpenAI dokumentatsiooni järgi tuleks seda väärtust käsitleda miinimumina ja lisada väike juhuslik viivitus, et kliendid ei proovi kõik koos uuesti.

Arvesta ka järgmisega:

• Ajalimiidid pikkade genereerimiste puhul. Voogedastus aitab, samuti mõistlik väljundi piirang.
• Teenusepakkuja katkestused. AI-funktsioon peaks ebaõnnestuma viisakalt, ilma et lehe muud osad katkeksid.
• Halb väljund. Kontrolli struktureeritud väljundit enne salvestamist ja ära lase mudeli väljundil käivitada tundlikke tegevusi ilma koodis oleva kontrollita.

Levinud vead

• Võti frontendis või repos. Brauserikood on avalik ja lekkinud võtit saab mõne minutiga kuritarvitada. Vaata kuidas hoida API-võtmeid turvaliselt.
• Kulupiirangu puudumine. Tsükkel või kuritarvitav kasutaja võib kiiresti suure arve tekitada.
• Kasutajapõhiste piirangute puudumine. Pakkuja piirang kaitseb sinu rahakotti, mitte teisi kasutajaid.
• Turvalisuse usaldamine promptile. Kasutajad saavad kirjutada „ignoreeri eelnevaid juhiseid“. Õigused kuuluvad serveri koodi.
• Rohkem saatmine, kui vaja. Terved dokumendid ja pikad ajalood korrutavad kulu. Saada ainult see, mida ülesanne vajab.
• Mudeli nime kõvakodeerimine. Mudeleid uuendatakse ja pensionile saadetakse; tee sellest seade.
• Isikuandmete saatmine mõtlemata. Loe OpenAI andmekasutuse tingimusi ja saada ainult see, mida funktsioon vajab.

Kontrollnimekiri

• Testimiseks ja tootmiseks eraldi OpenAI projektid (või võtmed)
• Võti on salvestatud serveripoolse saladusena, mitte brauseri koodis ega repos
• Kulu teavitused ja kindel kulupiirang on seatud
• Kõik päringud käivad läbi sinu serveri ja kontrollivad kasutaja õigusi
• Väljundi pikkus on piiratud; mudeli nimi on seadistatav
• Rakenduses on kasutajapõhine päringupiirang
• 429 käsitlemine koos päisega Retry-After, ooteaja ja juhuslikkusega
• Viisakas veaolek; leht töötab ka ilma AI-ta
• Tokenite kasutus logitakse funktsiooni kaupa
• Testitud pikkade, tühjade ja vaenulike sisenditega

OpenAI API kasutamine Mythexis

AI-funktsioonid rakendustes, mille ehitad Mythexis, kasutavad sinu enda OpenAI võtit, mis arveldatakse sinu OpenAI kontolt, mitte Mythexi ehituskrediitidelt. Lisa OPENAI_API_KEY projekti saladusena lehe /secrets kaudu, projekti seadetes või saladuste kaardi kaudu, mida agent kuvab, kui vajab võtit, ning kirjelda funktsiooni ülaltoodud sarnase promptiga. Pärast saladuste muutmist avaldatud rakenduses avalda uuesti, et muudatused jõustuksid. Dokumentatsiooni retsept Lisa AI-funktsioonid oma API-võtmetega sisaldab alguspromptit ning Saladused vestluses selgitab saladuste kaarti. Kas võrdled pakkujaid? Vaata kuidas integreerida Claude API.

Küsimused