Kaip integruoti OpenAI API į savo programėlę
Norėdami integruoti OpenAI API, sukurkite API raktą OpenAI projekte, įrašykite jį kaip serverio pusės paslaptį, pavadintą OPENAI_API_KEY, ir kvieskite API iš savo serverio maršruto naudodami oficialų OpenAI SDK — niekada iš naršyklės kodo. Nuo 2026 m. rugsėjo OpenAI greito starto vadove naujiems projektams kaip pradžios tašką pateikiama Responses API. Prieš paleidimą nustatykite išlaidų ribą, apribokite atsakymų ilgį, ribokite, kaip dažnai kiekvienas naudotojas gali kviesti funkciją, ir apdorokite greičio ribos klaidas bandydami dar kartą.
Šis vadovas apima paruošimą, užklausos srautą, raginimus DI kūrėjui ir klaidas, dėl kurių nutekėja raktai arba iššvaistomi pinigai. OpenAI informacija paimta iš jų oficialios dokumentacijos nuo 2026 m. rugsėjo. Bendrąsias sąvokas (žetonus, konteksto langus, kainodarą) pirmiausia perskaitykite kaip naudoti LLM API.
Ką su juo galite sukurti
- Pokalbių asistentą programėlės viduje (kaip sukurti DI pokalbių roboto programėlę)
- Mygtukus „Apibendrinti šį“, „Perrašyti šį“ ar „Parengti atsakymą“
- Struktūrizuotų duomenų ištraukimą iš laisvo teksto: el. laiško pavertimą užsakymu, paramos bilietų žymėjimą
- Paiešką ir atsakymus į klausimus remiantis jūsų pačių turiniu
- Vaizdų generavimą, kalbą ir kitas medijos funkcijas, priklausomai nuo turimų modelių
Daugiau idėjų yra kaip pridėti DI funkcijų į savo programėlę.
OpenAI paskyros paruošimas
- Sukurkite paskyrą ir projektą OpenAI platformoje. OpenAI gamybos geriausios praktikos rekomenduoja atskirus projektus testavimui ir produkcijai, kad kiekvienas turėtų savo raktus ir ribas.
- Sukurkite projekto API raktą. OpenAI rekomenduoja nustatyti galiojimo pabaigos datą ir reguliariai keisti raktus.
- Nustatykite išlaidų įspėjimus ir griežtą išlaidų ribą limitų puslapyje. OpenAI vadove nurodyta, kad įspėjimai praneša, kai naudojimas viršija sumą, o griežta riba įveda mėnesio viršutinę ribą.
- Pridėkite apmokėjimą. OpenAI greičio ribų dokumentacijoje aprašomos naudojimo pakopos: jūsų ribos laikui bėgant automatiškai didėja, kai išleidžiate daugiau.
Užklausos srautas
Naršyklė -> jūsų serverio maršrutas -> OpenAI API
<- (srautu) atsakymas <-
- Naudotojas paspaudžia mygtuką arba išsiunčia žinutę.
- Naršyklė kreipiasi į jūsų maršrutą, pavyzdžiui,
POST /api/summarise. - Jūsų serveris patikrina, ar naudotojas prisijungęs ir turi teisę naudoti funkciją.
- Serveris sudaro užklausą: instrukcijas, naudotojo įvestį ir visus duomenis iš jūsų duomenų bazės, kurių reikia užduočiai.
- Jis kviečia OpenAI su raktu iš aplinkos. OpenAI SDK automatiškai nuskaito
OPENAI_API_KEY. - Jis perduoda atsakymą srautu arba grąžina jį ir įrašo žetonų naudojimą.
OpenAI oficialūs SDK paketai vadinasi openai tiek JavaScript/TypeScript (npm), tiek Python (pip) kalboms.
Modelio pasirinkimas
OpenAI siūlo kelis modelius skirtingomis kainomis ir greičiais, o modelių sąrašas dažnai keičiasi. Pradėkite nuo mažesnio, pigesnio modelio, įvertinkite kokybę su tikrais pavyzdžiais ir pereikite prie galingesnio tik tada, kai jo reikia. Modelio pavadinimą laikykite konfigūracijos reikšmėje ar paslaptyje, kad galėtumėte jį pakeisti nerašydami kodo iš naujo. Dabartinius įkainius rasite OpenAI kainodaros puslapyje.
Parinktys ir kompromisai
| Sprendimas | Paprastas pasirinkimas | Kada eiti toliau |
|---|---|---|
| Srautinis perdavimas | Grąžinti visą atsakymą | Srautu pokalbiams ir ilgiems atsakymams; naudotojai iš karto mato tekstą |
| Pokalbio atmintis | Siųsti naujausias žinutes kiekvieną kartą | Apibendrinti senesnes žinutes, kai pokalbiai tampa ilgi |
| Išvesties formatas | Paprastas tekstas | Prašyti struktūrizuoto JSON, kai jūsų kodas turi nuskaityti laukus |
| Jūsų pačių duomenys | Įtraukti atitinkamą įrašą į užklausą | Pridėti paiešką jūsų turinyje, kai per daug įtraukti (žr. kas yra RAG) |
| Masinis, neskubus darbas | Ciklas per elementus | Naudoti OpenAI paketinį variantą mažesnei kainai, kai rezultatai gali palaukti |
Raginimai jūsų DI kūrėjui
Pirmoji funkcija:
Pridėkite mygtuką „Apibendrinti“ bilieto puslapyje. Jis kviečia serverio maršrutą POST /api/summarise, kuris patikrina, ar naudotojas prisijungęs, įkelia bilietą ir kviečia OpenAI Responses API naudodamas oficialų openai SDK ir paslaptį OPENAI_API_KEY. Modelio pavadinimą nuskaitykite iš paslapties OPENAI_MODEL. Instrukcijos: „Apibendrinkite 3 punktais, tada pasiūlykite trumpą atsakymą. Neišgalvokite užsakymų numerių.“ Apribokite išvesties ilgį, srautu rodykite atsakymą puslapyje ir niekada nesiųskite rakto naršyklei.
Apsaugos priemonės:
Apribokite kiekvieną naudotoją iki 30 DI užklausų per valandą, saugomų duomenų bazėje. Įrašykite įvesties ir išvesties žetonus kiekvienai užklausai su naudotojo ID ir funkcijos pavadinimu. Jei OpenAI grąžina 429, paisykite Retry-After antraštės ir bandykite dar kartą su eksponentiniu atidėjimu ir atsitiktiniu vėlavimu iki 3 kartų; po to rodykite „DI užimtas, bandykite po minutės.“ Kitoms nesėkmėms rodykite draugišką klaidą ir palikite likusį puslapį veikiantį.
Klaidų ir ribų valdymas
OpenAI matuoja greičio ribas keliais būdais, įskaitant užklausas per minutę ir žetonus per minutę, ir jūs pasiekiate tą, kuri pirmiausia pasibaigia. Kai viršijate vieną iš jų, API grąžina 429 su Retry-After antraštė. OpenAI dokumentacijoje sakoma, kad tą reikšmę reikia laikyti minimalia ir pridėti nedidelį atsitiktinį vėlavimą, kad klientai nekartotų visi kartu.
Taip pat numatykite:
- Laiko limitus ilgoms generacijoms. Srautinis perdavimas padeda, kaip ir protingas išvesties apribojimas.
- Teikėjo gedimus. DI funkcija turėtų sklandžiai nenusisekti nesugadinant puslapio.
- Blogą išvestį. Patikrinkite struktūrizuotą išvestį prieš ją išsaugodami ir neleiskite modelio išvesčiai paleisti jautrių veiksmų be patikros jūsų kode.
Dažnos klaidos
- Raktas frontend'e ar repozitorijoje. Naršyklės kodas yra viešas, o nutekėjęs raktas per kelias minutes gali būti piktnaudžiaujamas. Žr. kaip saugoti API raktus.
- Nėra išlaidų ribos. Ciklas ar piktnaudžiaujantis naudotojas gali greitai sukelti didelę sąskaitą.
- Nėra ribų vienam naudotojui. Jūsų teikėjo riba saugo jūsų piniginę, o ne kitus jūsų naudotojus.
- Pasitikėjimas raginimu saugumui. Naudotojai gali įrašyti „ignore previous instructions“. Leidimai priklauso serverio kodui.
- Siuntimas daugiau nei reikia. Visi dokumentai ir ilgos istorijos didina kainą. Siųskite tai, ko reikia užduočiai.
- Modelio pavadinimo įrašymas tiesiai į kodą. Modeliai atnaujinami ir išimami; padarykite tai nustatymu.
- Asmeninių duomenų siuntimas negalvojant. Perskaitykite OpenAI duomenų naudojimo sąlygas ir siųskite tik tai, ko funkcijai reikia.
Kontrolinis sąrašas
- Atskiri OpenAI projektai (arba raktai) testavimui ir produkcijai
- Raktas laikomas kaip serverio pusės paslaptis, niekada naršyklės kode ar repozitorijoje
- Nustatyti išlaidų įspėjimai ir griežta išlaidų riba
- Visi kvietimai eina per jūsų serverį ir tikrina naudotojo leidimus
- Išvesties ilgis apribotas; modelio pavadinimas konfigūruojamas
- Greičio riba vienam naudotojui jūsų programėlėje
- 429 apdorojimas su Retry-After, atidėjimu ir atsitiktiniu vėlavimu
- Draugiška klaidos būsena; puslapis veikia be DI
- Žetonų naudojimas įrašomas pagal funkciją
- Išbandyta su ilgomis, tuščiomis ir priešiškomis įvestimis
OpenAI API naudojimas Mythex
DI funkcijos programėlėse, kurias kuriate Mythex, naudoja jūsų pačių OpenAI raktą, apmokestinamą jūsų OpenAI paskyroje, o ne Mythex kūrimo kreditais. Pridėkite OPENAI_API_KEY kaip projekto paslaptį per /secrets, projekto nustatymus arba paslapčių kortelę, kurią agentas rodo, kai reikia rakto, tada aprašykite funkciją naudodami aukščiau pateiktus raginimus. Pakeitę paslaptis paskelbtoje programėlėje, paskelbkite ją iš naujo, kad ji jas pasiimtų. Dokumentacijos receptas Pridėkite DI funkcijas su savo API raktais turi pradinį raginimą, o Paslaptys pokalbyje paaiškina paslapčių kortelę. Lyginate teikėjus? Žr. kaip integruoti Claude API.
Klausimai
Kurį OpenAI API turėčiau naudoti naujai programėlei?
Nuo 2026 m. rugsėjo OpenAI greito starto vadove naujiems projektams kaip pradžios tašką pateikia Responses API, su pavyzdžiais, naudojančiais client.responses.create() jų oficialiuose SDK. Prieš pradėdami, patikrinkite OpenAI dokumentaciją dėl dabartinės rekomendacijos.
Ar galiu kviesti OpenAI API iš naršyklės?
Ne su savo slaptu raktu. Bet kas gali perskaityti naršyklės kodą ir panaudoti raktą, kad padidintų jūsų sąskaitą. Naršyklė turėtų kviesti jūsų pačių serverio maršrutą, o serveris kviečia OpenAI su raktu, įrašytu kaip aplinkos kintamasis.
Kaip sustabdyti, kad OpenAI API per daug kainuotų?
OpenAI gamybos vadove rekomenduojami išlaidų įspėjimai ir griežta mėnesio išlaidų riba limitų puslapyje. Savo programėlėje apribokite atsakymų ilgį, ribokite užklausas vienam naudotojui ir įrašykite žetonų naudojimą, kad matytumėte, kurios funkcijos kainuoja daugiausia.
Ką reiškia 429 klaida iš OpenAI?
Tai reiškia, kad pasiekėte greičio ribą. OpenAI greičio ribų dokumentacijoje nurodoma, kad atsakyme yra Retry-After antraštė; palaukite bent tiek, pridėkite nedidelį atsitiktinį vėlavimą ir bandykite dar kartą su eksponentiniu atidėjimu.