Jinsi ya Kuunganisha OpenAI API kwenye Programu Yako

Ili kuunganisha OpenAI API, tengeneza ufunguo wa API kwenye mradi wa OpenAI, uuhifadhi kama siri ya upande wa seva iitwayo OPENAI_API_KEY, kisha uite API kutoka kwenye njia ya seva yako mwenyewe ukitumia SDK rasmi ya OpenAI, kamwe si kutoka kwenye msimbo wa kivinjari. Kufikia Septemba 2026, mwongozo wa kuanza haraka wa OpenAI unaweka Responses API kama mahali pa kuanzia kwa miradi mipya. Weka kikomo cha matumizi kabla ya kuzindua, punguza urefu wa majibu, weka kikomo cha mara ngapi kila mtumiaji anaweza kuita kipengele, na shughulikia hitilafu za kikomo cha kasi kwa kujaribu tena.

Mwongozo huu unashughulikia usanidi, mtiririko wa ombi, maagizo kwa mjenzi wa AI, na makosa yanayovuja funguo au kuteketeza pesa. Maelezo ya OpenAI yanatokana na nyaraka zake rasmi kufikia Septemba 2026. Kwa dhana za jumla (tokeni, madirisha ya muktadha, bei), soma kwanza jinsi ya kutumia LLM APIs.

Unachoweza kujenga nayo

• Msaidizi wa mazungumzo ndani ya programu yako (jinsi ya kujenga programu ya chatbot ya AI)
• Vitufe vya "Fupisha hii", "andika upya hii" au "rasimu jibu"
• Kutoa data iliyopangwa kutoka kwenye maandishi huru: kugeuza barua pepe kuwa oda, kuweka lebo kwenye tiketi za usaidizi
• Utafutaji na kujibu maswali juu ya maudhui yako mwenyewe
• Vipengele vya picha, sauti na vyombo vingine vya habari, kulingana na models zinazopatikana

Mawazo zaidi yako kwenye jinsi ya kuongeza vipengele vya AI kwenye programu yako.

Kuweka akaunti yako ya OpenAI

1. Tengeneza akaunti na mradi kwenye jukwaa la OpenAI. Mbinu bora za uzalishaji za OpenAI zinapendekeza miradi tofauti kwa staging na uzalishaji, ili kila moja iwe na funguo na vikomo vyake.
2. Tengeneza ufunguo wa API wa mradi. OpenAI inapendekeza kuweka tarehe ya kuisha na kuzungusha funguo mara kwa mara.
3. Weka arifa za matumizi na kikomo kigumu cha matumizi kwenye ukurasa wa vikomo. Mwongozo wa OpenAI unasema arifa zinakujulisha matumizi yanapopita kiasi fulani, na kikomo kigumu kinatekeleza kikomo cha kila mwezi.
4. Weka malipo. Nyaraka za vikomo vya kasi za OpenAI zinaeleza ngazi za matumizi: vikomo vyako vinaongezeka kiotomatiki unapotumia zaidi kwa muda.

Mtiririko wa ombi

Kivinjari  ->  njia ya seva yako  ->  OpenAI API
           <-  (jibu lililotiririshwa) <-

1. Mtumiaji anabofya kitufe au anatuma ujumbe.
2. Kivinjari kinaita njia yako, kwa mfano POST /api/summarise.
3. Seva yako inakagua mtumiaji ameingia na anaruhusiwa kutumia kipengele.
4. Seva inajenga ombi: maagizo, ingizo la mtumiaji, na data yoyote kutoka kwenye hifadhidata inayohitajika na kazi.
5. Inaita OpenAI ikitumia ufunguo kutoka kwenye mazingira. SDK za OpenAI zinasoma OPENAI_API_KEY zenyewe.
6. Inatiririsha au kurudisha jibu, na kuandika matumizi ya tokeni.

SDK rasmi za OpenAI zinaitwa openai, kwa JavaScript/TypeScript (npm) na kwa Python (pip).

Kuchagua model

OpenAI inatoa models kadhaa kwa bei na kasi tofauti, na orodha inabadilika mara kwa mara. Anza na model ndogo na ya bei nafuu, pima ubora kwenye mifano halisi, na panda ngazi tu ukihitaji. Weka jina la model kwenye thamani ya usanidi au siri ili uweze kulibadilisha bila kuandika upya msimbo. Angalia ukurasa wa bei wa OpenAI kwa viwango vya sasa.

Chaguo na mabadilishano

Maagizo ya kumpa mjenzi wako wa AI

Kipengele cha kwanza:

Ongeza kitufe cha "Fupisha" kwenye ukurasa wa tiketi. Kinaita njia ya seva POST /api/summarise inayokagua mtumiaji ameingia, inapakia tiketi, na kuita OpenAI Responses API kwa kutumia SDK rasmi ya openai na siri OPENAI_API_KEY. Soma jina la model kutoka kwenye siri OPENAI_MODEL. Maagizo: "Fupisha kwa vitone 3, kisha pendekeza jibu fupi. Usibuni namba za oda." Weka kikomo cha urefu wa matokeo, tiririsha jibu kwenye ukurasa, na usiwahi kutuma ufunguo kwenye kivinjari.

Vikwazo:

Mpe kila mtumiaji maombi 30 ya AI kwa saa, yakihifadhiwa kwenye hifadhidata. Andika tokeni za ingizo na za matokeo kwa kila ombi pamoja na kitambulisho cha mtumiaji na jina la kipengele. Ikiwa OpenAI itarudisha 429, heshimu kichwa cha Retry-After na ujaribu tena kwa kusubiri kwa muda unaoongezeka kwa kasi na jitter hadi mara 3; baada ya hapo, onyesha "AI iko busy, jaribu tena baada ya dakika moja." Onyesha ujumbe wa kirafiki kwa hitilafu nyingine yoyote, na acha ukurasa mzima uendelee kufanya kazi.

Kushughulikia hitilafu na vikomo

OpenAI inapima vikomo vya kasi kwa njia kadhaa, ikiwemo maombi kwa dakika na tokeni kwa dakika, na unafikia kile kinachoisha kwanza. Ukizidi moja, API inarudisha 429 yenye kichwa Retry-After. Nyaraka za OpenAI zinasema utumie thamani hiyo kama kiwango cha chini na uongeze ucheleweshaji mdogo wa kubahatisha ili wateja wasijaribu tena wote kwa pamoja.

Pia panga kwa:

• Muda wa kusubiri kwenye uzalishaji mrefu. Utiririshaji unasaidia, na ndivyo pia kikomo cha matokeo kinachofaa.
• Kukatika kwa mtoa huduma. Kipengele cha AI kinapaswa kushindwa kwa upole bila kuvunja ukurasa.
• Matokeo mabaya. Thibitisha matokeo yaliyopangwa kabla ya kuyahifadhi, na usiruhusu matokeo ya model yasababishe vitendo nyeti bila ukaguzi kwenye msimbo wako.

Makosa ya kawaida

• Ufunguo kwenye sehemu ya mbele au kwenye hifadhi ya msimbo. Msimbo wa kivinjari uko wazi, na ufunguo uliovuja unaweza kutumiwa vibaya ndani ya dakika chache. Angalia jinsi ya kulinda funguo za API.
• Hakuna kikomo cha matumizi. Kitanzi au mtumiaji mwenye nia mbaya anaweza kuteketeza bili kubwa haraka.
• Hakuna vikomo vya kila mtumiaji. Kikomo cha mtoa huduma kinalinda mkoba wako, si watumiaji wako wengine.
• Kuamini prompt kwa usalama. Watumiaji wanaweza kuandika "puuza maagizo yaliyotangulia". Ruhusa zinapaswa kuwa kwenye msimbo wa seva.
• Kutuma zaidi ya kinachohitajika. Hati nzima na historia ndefu zinazidisha gharama. Tuma kile tu kazi inachohitaji.
• Kuandika jina la model moja kwa moja kwenye msimbo. Models zinasasishwa na kustaafishwa; ziweke kwenye mipangilio.
• Kutuma data binafsi bila kufikiri. Soma masharti ya matumizi ya data ya OpenAI na utume tu kinachohitajika na kipengele.

Orodha ya ukaguzi

• Miradi tofauti ya OpenAI (au funguo) kwa majaribio na uzalishaji
• Ufunguo umehifadhiwa kama siri ya upande wa seva, kamwe si kwenye msimbo wa kivinjari au kwenye hifadhi
• Arifa za matumizi na kikomo kigumu cha matumizi vimewekwa
• Miito yote inapita kwenye seva yako na inakagua ruhusa za mtumiaji
• Urefu wa matokeo umewekewa kikomo; jina la model linaweza kusanidiwa
• Kikomo cha kasi cha kila mtumiaji kwenye programu yako
• Ushughulikiaji wa 429 kwa Retry-After, kurudi nyuma na jitter
• Hali ya hitilafu ya kirafiki; ukurasa unafanya kazi bila AI
• Matumizi ya tokeni yanaandikwa kwa kila kipengele
• Imejaribiwa kwa ingizo refu, tupu na lenye uadui

Kutumia OpenAI API kwenye Mythex

Vipengele vya AI kwenye programu unazojenga kwenye Mythex vinatumia ufunguo wako mwenyewe wa OpenAI, vinalipwa kupitia akaunti yako ya OpenAI badala ya mikopo ya ujenzi wa Mythex. Ongeza OPENAI_API_KEY kama siri ya mradi kupitia /secrets, mipangilio ya mradi au kadi ya siri ambayo wakala anaonyesha anapohitaji ufunguo, kisha ueleze kipengele kwa kutumia maagizo kama yaliyo hapo juu. Baada ya kubadilisha siri kwenye programu iliyochapishwa, chapisha tena ili ichukue hizo. Kiolezo cha nyaraka Ongeza vipengele vya AI kwa funguo zako za API kina maagizo ya kuanzia, na Siri kwenye mazungumzo inaeleza kadi ya siri. Unalinganisha watoa huduma? Angalia jinsi ya kuunganisha Claude API.

Maswali