Ինչպես ինտեգրել OpenAI API-ն ձեր հավելվածում

OpenAI API-ն ինտեգրելու համար ստեղծեք API բանալի OpenAI նախագծում, պահեք այն որպես սերվերային գաղտնիք OPENAI_API_KEY անունով և կանչեք API-ն ձեր սերվերի երթուղուց՝ OpenAI-ի պաշտոնական SDK-ով, երբեք ոչ բրաուզերի կոդից։ 2026 թվականի սեպտեմբերի դրությամբ OpenAI-ի արագ մեկնարկը Responses API-ն է ներկայացնում որպես նոր նախագծերի սկզբնակետ։ Մինչև գործարկելը սահմանեք ծախսերի սահման, սահմանափակեք պատասխանի երկարությունը, սահմանափակեք, թե որքան հաճախ կարող է յուրաքանչյուր օգտատեր կանչել գործառույթը, և մշակեք սահմանաչափի սխալները կրկնակի փորձերով։

Այս ուղեցույցը ներառում է տեղադրումը, հարցման հոսքը, հուշումներ AI կառուցողի համար և այն սխալները, որոնք արտահոսեցնում են բանալիներ կամ ծախսում գումար։ OpenAI-ի տվյալները վերցված են նրա պաշտոնական փաստաթղթերից՝ 2026 թվականի սեպտեմբերի դրությամբ։ Ընդհանուր հասկացությունների համար (տոկեններ, համատեքստի պատուհաններ, գներ) նախ կարդացեք ինչպես օգտագործել LLM API-ները։

Ինչ կարող եք կառուցել դրանով

• Զրուցող օգնական ձեր հավելվածի ներսում (ինչպես կառուցել AI չաթբոթ հավելված)
• «Ամփոփիր սա», «վերագրիր սա» կամ «գրիր պատասխան» կոճակներ
• Կառուցվածքային տվյալների արդյունահանում ազատ տեքստից. էլփոստը վերածել պատվերի, պիտակավորել աջակցության տոմսերը
• Որոնում և հարցերին պատասխանել ձեր սեփական բովանդակությունից
• Պատկերների գեներացում, խոսք և այլ մեդիա գործառույթներ՝ կախված հասանելի մոդելներից

Ավելի շատ գաղափարներ կան ինչպես ավելացնել AI գործառույթներ ձեր հավելվածին ուղեցույցում։

OpenAI հաշիվը կարգավորելը

1. Ստեղծեք հաշիվ և նախագիծ OpenAI պլատֆորմում։ OpenAI-ի արտադրական լավագույն փորձը խորհուրդ է տալիս առանձին նախագծեր փորձարկման և արտադրության համար, որպեսզի յուրաքանչյուրն ունենա իր բանալիները և սահմանաչափերը։
2. Ստեղծեք նախագծի API բանալի։ OpenAI-ը խորհուրդ է տալիս սահմանել լրանալու ամսաթիվ և պարբերաբար թարմացնել բանալիները։
3. Սահմանեք ծախսերի ծանուցումներ և կոշտ սահման սահմանաչափերի էջում։ OpenAI-ի ուղեցույցը ասում է, որ ծանուցումները տեղեկացնում են, երբ օգտագործումը անցնում է գումարը, իսկ կոշտ սահմանը կիրառում է ամսական սահման։
4. Ավելացրեք վճարում։ OpenAI-ի սահմանաչափերի փաստաթղթերը նկարագրում են օգտագործման մակարդակներ․ ձեր սահմանաչափերը ավտոմատ բարձրանում են, երբ ավելի շատ եք ծախսում ժամանակի ընթացքում։

Հարցման հոսքը

Բրաուզեր  ->  ձեր սերվերի երթուղի  ->  OpenAI API
          <-  (հոսքով) պատասխան     <-

1. Օգտատերը սեղմում է կոճակ կամ ուղարկում հաղորդագրություն։
2. Բրաուզերը կանչում է ձեր երթուղին, օրինակ՝ POST /api/summarise։
3. Ձեր սերվերը ստուգում է, որ օգտատերը մուտք է գործել և թույլատրված է գործառույթը։
4. Սերվերը կառուցում է հարցումը՝ հրահանգներ, օգտատիրոջ մուտքը և ցանկացած տվյալ ձեր տվյալների բազայից, որ պահանջում է խնդիրը։
5. Այն կանչում է OpenAI-ին՝ միջավայրից բանալիով։ OpenAI-ի SDK-ները ավտոմատ կարդում են OPENAI_API_KEY-ը։
6. Այն հոսքով կամ ամբողջությամբ վերադարձնում է պատասխանը և գրանցում տոկենների օգտագործումը։

OpenAI-ի պաշտոնական SDK փաթեթները կոչվում են openai և՛ JavaScript/TypeScript (npm), և՛ Python (pip) համար։

Մոդել ընտրելը

OpenAI-ը առաջարկում է մի քանի մոդել տարբեր գներով և արագություններով, և շարքը հաճախ փոխվում է։ Սկսեք ավելի փոքր, էժան մոդելով, չափեք որակը իրական օրինակների վրա և անցեք ավելի բարձր միայն, եթե պետք է։ Պահեք մոդելի անունը կոնֆիգուրացիայի արժեքում կամ գաղտնիքում, որպեսզի կարողանաք փոխել այն՝ առանց կոդը վերագրելու։ Ընթացիկ գների համար ստուգեք OpenAI-ի գների էջը։

Տարբերակներ և փոխզիջումներ

Հուշումներ AI կառուցողին տալու համար

Առաջին գործառույթ․

Ավելացրեք «Ամփոփել» կոճակ տոմսի էջում։ Այն կանչում է սերվերի երթուղի POST /api/summarise, որը ստուգում է, որ օգտատերը մուտք է գործել, բեռնում է տոմսը և կանչում է OpenAI Responses API-ն պաշտոնական openai SDK-ով և գաղտնիք OPENAI_API_KEY-ով։ Կարդացեք մոդելի անունը գաղտնիք OPENAI_MODEL-ից։ Հրահանգներ․ «Ամփոփեք 3 կետով, ապա առաջարկեք կարճ պատասխան։ Մի հորինեք պատվերի համարներ»։ Սահմանափակեք ելքի երկարությունը, հոսքով ուղարկեք պատասխանը էջին և երբեք մի ուղարկեք բանալին բրաուզերին։

Պաշտպանիչ միջոցներ․

Սահմանեք յուրաքանչյուր օգտատիրոջ համար ժամում 30 AI հարցում, պահված տվյալների բազայում։ Գրանցեք մուտքային և ելքային տոկենները յուրաքանչյուր հարցումի համար օգտատիրոջ ID-ով և գործառույթի անունով։ Եթե OpenAI-ը վերադարձնում է 429, հարգեք Retry-After վերնագիրը և կրկին փորձեք էքսպոնենցիալ հետաձգմամբ և jitter-ով մինչև 3 անգամ․ դրանից հետո ցույց տվեք «AI-ն զբաղված է, փորձեք մեկ րոպեից»։ Ցանկացած այլ ձախողման դեպքում ցույց տվեք հարմար սխալ և թողեք մնացած էջը աշխատող։

Սխալների և սահմանաչափերի մշակում

OpenAI-ը չափում է սահմանաչափերը մի քանի եղանակով, այդ թվում՝ հարցումներ րոպեում և տոկեններ րոպեում, և հասնում եք այն սահմանին, որը նախ սպառվում է։ Երբ գերազանցում եք որևէ մեկը, API-ն վերադարձնում է 429 Retry-After վերնագրով։ OpenAI-ի փաստաթղթերը ասում են, որ այդ արժեքը դիտարկեք որպես նվազագույն և ավելացրեք փոքր պատահական հապաղում, որպեսզի հաճախորդները միաժամանակ չփորձեն նորից։

Նաև պատրաստվեք․

• Ժամանակի սահմաններ երկար գեներացիաների համար։ Հոսքը օգնում է, ինչպես և ողջամիտ ելքի սահմանը։
• Մատակարարի խափանումներ։ AI գործառույթը պետք է հաջողությամբ ձախողվի՝ առանց կոտրելու էջը։
• Վատ ելք։ Վավերացրեք կառուցվածքային ելքը պահպանելուց առաջ և թույլ մի տվեք մոդելի ելքին ձեռնարկել զգայուն գործողություններ առանց ձեր կոդի ստուգման։

Սովորական սխալներ

• Բանալին բրաուզերի կոդում կամ ռեպոզիտորիայում։ Բրաուզերի կոդը հանրային է, և արտահոսած բանալին կարող է չարաշահվել րոպեների ընթացքում։ Տե՛ս ինչպես պահել API բանալիները անվտանգ։
• Առանց ծախսերի սահմանի։ Ցիկլը կամ չարաշահող օգտատերը կարող է արագ մեծ հաշիվ ստեղծել։
• Առանց օգտատիրոջ սահմանաչափերի։ Մատակարարի սահմանաչափը պաշտպանում է ձեր դրամապանակը, ոչ թե ձեր մյուս օգտատերերին։
• Անվտանգության համար հուշմանը վստահել։ Օգտատերերը կարող են գրել «անտեսիր նախորդ հրահանգները»։ Թույլտվությունները պատկանում են սերվերի կոդին։
• Ավելին ուղարկել, քան պետք է։ Ամբողջական փաստաթղթերը և երկար պատմությունները բազմապատկում են արժեքը։ Ուղարկեք միայն այն, ինչ պահանջում է խնդիրը։
• Մոդելի անունը կոդում ամրացնել։ Մոդելները թարմացվում և հանվում են․ դարձրեք այն կարգավորում։
• Անվտանգ չվերաբերվել անձնական տվյալներին։ Կարդացեք OpenAI-ի տվյալների օգտագործման պայմանները և ուղարկեք միայն այն, ինչ գործառույթին է պետք։

Ստուգաթերթ

• Առանձին OpenAI նախագծեր (կամ բանալիներ) փորձարկման և արտադրության համար
• Բանալին պահված է որպես սերվերային գաղտնիք, երբեք բրաուզերի կոդում կամ ռեպոզիտորիայում
• Ծախսերի ծանուցումներ և կոշտ ծախսերի սահման սահմանված են
• Բոլոր կանչերը անցնում են ձեր սերվերով և ստուգում օգտատիրոջ թույլտվությունները
• Ելքի երկարությունը սահմանափակված է․ մոդելի անունը կոնֆիգուրացվելի է
• Մեկ օգտատիրոջ սահմանաչափ ձեր հավելվածում
• 429 մշակում Retry-After-ով, հետաձգմամբ և jitter-ով
• Ընկալելի սխալի վիճակ․ էջը աշխատում է առանց AI-ի
• Տոկենների օգտագործումը գրանցված է յուրաքանչյուր գործառույթի համար
• Փորձարկված երկար, դատարկ և թշնամական մուտքերով

OpenAI API-ի օգտագործումը Mythex-ում

Mythex-ի վրա կառուցած հավելվածներում AI գործառույթները օգտագործում են ձեր սեփական OpenAI բանալին, որը վճարվում է ձեր OpenAI հաշվից, ոչ թե Mythex-ի կառուցման կրեդիտներից։ Ավելացրեք OPENAI_API_KEY-ը որպես նախագծի գաղտնիք /secrets-ի, նախագծի կարգավորումների կամ գործակալի ցուցադրած գաղտնիքների քարտի միջոցով, ապա նկարագրեք գործառույթը վերը նշվածների նման հուշումով։ Գաղտնիքները փոխելուց հետո նորից հրապարակեք կենդանի հավելվածը, որպեսզի այն դրանք ընդունի։ Mythex-ի փաստաթղթերի Ավելացրեք AI գործառույթներ ձեր սեփական API բանալիներով բաղադրատոմսը ունի սկզբնական հուշում, իսկ Գաղտնիքները չաթում-ը բացատրում է գաղտնիքների քարտը։ Մատակարարներ համեմատու՞մ եք։ Տե՛ս ինչպես ինտեգրել Claude API-ն։

Հարցեր