Kā integrēt OpenAI API savā lietotnē

Lai integrētu OpenAI API, izveidojiet API atslēgu OpenAI projektā, saglabājiet to kā servera puses noslēpumu ar nosaukumu OPENAI_API_KEY un izsauciet API no maršruta savā serverī, izmantojot OpenAI oficiālo SDK — nekad no pārlūka koda. No 2026. gada septembra OpenAI ātrā sākuma ceļvedis jauniem projektiem piedāvā Responses API kā sākumpunktu. Pirms palaišanas iestatiet izdevumu limitu, ierobežojiet atbilžu garumu, ierobežojiet, cik bieži katrs lietotājs var izsaukt funkciju, un apstrādājiet ātruma ierobežojuma kļūdas ar atkārtotiem mēģinājumiem.

Šis ceļvedis aptver iestatīšanu, pieprasījuma plūsmu, uzvednes AI veidotājam un kļūdas, kas noplūst atslēgas vai iztērē naudu. OpenAI informācija ir no tās oficiālās dokumentācijas uz 2026. gada septembri. Vispārējiem jēdzieniem (marķieri, konteksta logi, cenas) vispirms izlasiet kā izmantot LLM API.

Ko ar to var veidot

• AI tērzēšanu savā lietotnē (kā izveidot AI tērzēšanas robota lietotni)
• Pogas „Apkopot“, „Pārrakstīt“ vai „Sastādīt atbildi“
• Strukturētu datu izvilkšanu no brīvā teksta: e-pasta pārvēršanu pasūtījumā, atbalsta biļešu marķēšanu
• Meklēšanu un jautājumu atbildēšanu pār jūsu pašu saturu
• Attēlu ģenerēšanu, runu un citas mediju funkcijas atkarībā no pieejamajiem modeļiem

Vairāk ideju ir kā pievienot AI funkcijas savai lietotnei.

OpenAI konta iestatīšana

1. Izveidojiet kontu un projektu OpenAI platformā. OpenAI ražošanas labākās prakses iesaka atsevišķus projektus testēšanai un ražošanai, lai katram būtu savas atslēgas un limiti.
2. Izveidojiet projekta API atslēgu. OpenAI iesaka iestatīt derīguma termiņu un regulāri rotēt atslēgas.
3. Iestatiet izdevumu brīdinājumus un stingru izdevumu limitu limitu lapā. OpenAI ceļvedis saka, ka brīdinājumi paziņo, kad lietojums pārsniedz summu, un stingrs limits uzliek ikmēneša griestus.
4. Pievienojiet norēķinus. OpenAI ātruma ierobežojumu dokumentācija apraksta lietojuma līmeņus: jūsu limiti pieaug automātiski, jo vairāk laika tērējat.

Pieprasījuma plūsma

Pārlūks  ->  jūsu servera maršruts  ->  OpenAI API
         <-  (straumēta) atbilde    <-

1. Lietotājs noklikšķina uz pogas vai nosūta ziņu.
2. Pārlūks izsauc jūsu maršrutu, piemēram, POST /api/summarise.
3. Jūsu serveris pārbauda, vai lietotājs ir pieteicies un drīkst izmantot funkciju.
4. Serveris veido pieprasījumu: norādījumus, lietotāja ievadi un visus datus no datubāzes, kas uzdevumam vajadzīgi.
5. Tas izsauc OpenAI ar atslēgu no vides. OpenAI SDK automātiski nolasa OPENAI_API_KEY.
6. Tas straumē vai atgriež atbildi un reģistrē marķieru lietojumu.

OpenAI oficiālie SDK pakotnes saucas openai gan JavaScript/TypeScript (npm), gan Python (pip) vidē.

Modeļa izvēle

OpenAI piedāvā vairākus modeļus ar dažādām cenām un ātrumu, un to klāsts bieži mainās. Sāciet ar mazāku, lētāku modeli, novērtējiet kvalitāti uz reāliem piemēriem un pāriet uz lielāku tikai tad, ja tas nepieciešams. Glabājiet modeļa nosaukumu konfigurācijas vērtībā vai noslēpumā, lai to varētu mainīt, neatkārtoti rakstot kodu. Aktuālās likmes skatiet OpenAI cenu lapā.

Iespējas un kompromisi

Uzvednes, ko dot AI veidotājam

Pirmā funkcija:

Pievienojiet pogu „Apkopot“ biļetes lapā. Tā izsauc servera maršrutu POST /api/summarise, kas pārbauda, vai lietotājs ir pieteicies, ielādē biļeti un izsauc OpenAI Responses API, izmantojot oficiālo openai SDK un noslēpumu OPENAI_API_KEY. Modeļa nosaukumu nolasiet no noslēpuma OPENAI_MODEL. Norādījumi: „Apkopo 3 punktos, pēc tam ieteic īsu atbildi. Neizdomā pasūtījumu numurus.“ Ierobežojiet izvades garumu, straumējiet atbildi lapā un nekad nesūtiet atslēgu pārlūkam.

Aizsargbarjeras:

Ierobežojiet katram lietotājam 30 AI pieprasījumus stundā, glabājot datubāzē. Reģistrējiet ievades un izvades marķierus katram pieprasījumam kopā ar lietotāja ID un funkcijas nosaukumu. Ja OpenAI atgriež 429, ievērojiet galveni Retry-After un mēģiniet vēlreiz ar eksponenciālu atkāpšanos un nejaušu nobīdi līdz 3 reizēm; pēc tam parādiet „AI ir aizņemts, mēģiniet pēc minūtes.“ Jebkurai citai kļūmei parādiet draudzīgu kļūdas paziņojumu un ļaujiet pārējai lapai darboties.

Kļūdu un ierobežojumu apstrāde

OpenAI mēra ātruma ierobežojumus vairākos veidos, tostarp pieprasījumi minūtē un marķieri minūtē, un jūs sasniedzat to, kurš beidzas pirmais. Kad pārsniedzat kādu no tiem, API atgriež 429 ar galveni Retry-After. OpenAI dokumentācija saka, ka šo vērtību jāuztver kā minimumu un jāpievieno neliela nejauša aizkave, lai klienti visi nemēģinātu vienlaikus.

Jāgatavojas arī:

• Noildzēm ilgās ģenerācijās. Straumēšana palīdz, tāpat kā saprātīgs izvades ierobežojums.
• Pakalpojuma sniedzēja dīkstāvēm. AI funkcijai jādarbojas graciozi, neapturot lapu.
• Sliktām izvadēm. Pārbaudiet strukturēto izvadi, pirms to saglabājat, un neļaujiet modeļa izvadei izraisīt jūtīgas darbības bez pārbaudes jūsu kodā.

Biežākās kļūdas

• Atslēga frontendā vai repozitorijā. Pārlūka kods ir publisks, un noplūdusi atslēga var tikt ļaunprātīgi izmantota dažu minūšu laikā. Skatiet kā glabāt API atslēgas drošībā.
• Nav izdevumu limita. Cilpa vai ļaunprātīgs lietotājs var ātri radīt lielu rēķinu.
• Nav ierobežojumu katram lietotājam. Pakalpojuma sniedzēja limits aizsargā jūsu maku, nevis jūsu pārējos lietotājus.
• Uzvednei uzticēšanās drošībai. Lietotāji var ierakstīt „ignorē iepriekšējos norādījumus“. Atļaujām jābūt serverī.
• Pārāk daudz sūtīšana. Veseli dokumenti un garas vēsturas palielina izmaksas. Sūtiet tikai to, ko uzdevums prasa.
• Modeļa nosaukuma ievietošana kodā. Modeļi tiek atjaunināti un izņemti; padariet to par iestatījumu.
• Personas datu sūtīšana, nedomājot. Izlasiet OpenAI datu lietošanas noteikumus un sūtiet tikai to, ko funkcija vajag.

Kontrolsaraksts

• Atsevišķi OpenAI projekti (vai atslēgas) testēšanai un ražošanai
• Atslēga glabāta kā servera puses noslēpums, nekad pārlūka kodā vai repozitorijā
• Iestatīti izdevumu brīdinājumi un stingrs izdevumu limits
• Visi izsaukumi iet caur jūsu serveri un pārbauda lietotāja atļaujas
• Izvades garums ierobežots; modeļa nosaukums konfigurējams
• Ātruma ierobežojums katram lietotājam jūsu lietotnē
• 429 apstrāde ar Retry-After, atkāpšanos un nejaušu nobīdi
• Draudzīgs kļūdas stāvoklis; lapa darbojas arī bez AI
• Marķieru lietojums reģistrēts katrai funkcijai
• Pārbaudīts ar garām, tukšām un naidīgām ievadēm

OpenAI API izmantošana Mythex

AI funkcijas lietotnēs, ko veidojat Mythex, izmanto jūsu pašu OpenAI atslēgu, un maksa tiek iekasēta jūsu OpenAI kontā, nevis Mythex veidošanas kredītos. Pievienojiet OPENAI_API_KEY kā projekta noslēpumu caur /secrets, projekta iestatījumiem vai noslēpumu kartīti, ko aģents parāda, kad tam vajag atslēgu, un pēc tam aprakstiet funkciju ar uzvedni, līdzīgu iepriekš minētajām. Pēc noslēpumu maiņas publicētā lietotnē publicējiet vēlreiz, lai tā tos paņemtu. Dokumentācijas receptē Pievienot AI funkcijas ar saviem API atslēgām ir sākuma uzvedne, un Noslēpumi čatā izskaidro noslēpumu kartīti. Salīdzināt pakalpojumu sniedzējus? Skatiet kā integrēt Claude API.

Jautājumi