OpenAI API-ды қолданбаңызға қалай қосуға болады

OpenAI API-ды қосу үшін OpenAI жобасында API кілтін жасаңыз, оны 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 пакеттері JavaScript/TypeScript (npm) және Python (pip) үшін openai деп аталады.

Модельді таңдау

OpenAI әр түрлі баға мен жылдамдықтағы бірнеше модель ұсынады, және модельдер тізімі жиі өзгереді. Кішірек, арзанырақ модельден бастаңыз, сапасын нақты мысалдарда өлшеңіз және тек қажет болса жоғарырақ көтеріліңіз. Модель атын конфигурация мәні немесе құпия ретінде ұстаңыз, сонда кодты қайта жазбай өзгерте аласыз. Ағымдағы бағалар үшін OpenAI-дың баға бетін тексеріңіз.

Таңдаулар мен компромисстер

AI құрастырушысына берілетін нұсқаулар

Алғашқы мүмкіндік:

Билет бетіне «Қорытындылау» батырмасын қосыңыз. Ол POST /api/summarise серверлік маршрутын шақырсын, ол пайдаланушының кірген екенін тексеріп, билетті жүктесін, содан соң ресми openai SDK және OPENAI_API_KEY құпиясы арқылы OpenAI Responses API-ды шақырсын. Модель атын OPENAI_MODEL құпиясынан оқыңыз. Нұсқаулар: «3 негізгі тармақпен қорытындылаңыз, содан соң қысқа жауап ұсыныңыз. Тапсырыс нөмірлерін ойлап таппаңыз.» Шығыс ұзындығын шектеңіз, жауапты бетке ағынмен беріңіз және кілтті ешқашан браузерге жібермеңіз.

Шектеулер:

Әр пайдаланушыға сағатына 30 AI сұрауынан шек қойыңыз, дерекқорда сақтаңыз. Әр сұрау үшін кіріс және шығыс токендерін пайдаланушы ID-імен және функция атымен тіркеңіз. OpenAI 429 қайтарса, Retry-After тақырыбын ескеріңіз, экспоненциалды кідіртумен және кездейсоқ кідіріспен 3 рет дейін қайталаңыз; содан кейін «AI қазір бос емес, бір минуттан кейін қайталаңыз» деп көрсетіңіз. Басқа кез келген қате үшін ыңғайлы қате көрсетіңіз және беттің қалған бөлігі жұмыс істей берсін.

Қателер мен шектерді өңдеу

OpenAI жылдамдық шектерін бірнеше тәсілмен өлшейді, соның ішінде минутына сұрау және минутына токен, және біріншісі таусылған кезде сіз тоқтайсыз. Бірін асырсаңыз, API Retry-After тақырыбымен 429 қайтарады. OpenAI құжаттары бұл мәнді минималды шек ретінде қабылдауды және клиенттер бәрі бірден қайталамауы үшін кішкене кездейсоқ кідіріс қосуды айтады.

Сондай-ақ мыналарды жоспарлаңыз:

• Ұзақ генерациялар үшін күту уақыты. Ағын көмектеседі, сондай-ақ ақылға қонымды шығыс шегі.
• Провайдер үзілістері. AI мүмкіндігі беттің жұмысын бұзбай, әдемі түрде сәтсіз аяқталуы керек.
• Жаман шығыс. Құрылымдалған шығысты сақтамас бұрын тексеріңіз, және модель шығысы кодыңыздағы тексерусіз сезімтал әрекеттерді іске қоспасын.

Жиі кездесетін қателер

• Кілт фронтендте немесе репозиторийде. Браузер коды ашық, ал ағып кеткен кілтті минут ішінде теріс пайдалануға болады. API кілттерін қалай сақтау керек мақаласын қараңыз.
• Шығын шегі жоқ. Цикл немесе зиянды пайдаланушы үлкен шотты тез жинай алады.
• Пайдаланушы бойынша шектер жоқ. Провайдердің шегі сіздің әмиянды қорғайды, басқа пайдаланушыларыңызды емес.
• Қауіпсіздік үшін сұранысқа сену. Пайдаланушылар «алдыңғы нұсқауларды елемеңіз» деп жаза алады. Рұқсаттар сервер кодында болуы керек.
• Қажеттіден көбін жіберу. Толық құжаттар мен ұзын тарихтар шығынды көбейтеді. Тапсырма қажет нәрсені ғана жіберіңіз.
• Модель атын кодқа қатыру. Модельдер жаңартылып, тоқтатылады; оны параметр ете отырыңыз.
• Жеке деректерді ойланбай жіберу. OpenAI-дың деректерді пайдалану шарттарын оқыңыз және мүмкіндікке қажет нәрсені ғана жіберіңіз.

Тексеру тізімі

• Сынақ пен өндіріс үшін бөлек OpenAI жобалары (немесе кілттер)
• Кілт сервер жағындағы құпия ретінде сақталған, браузер кодында немесе репозиторийде емес
• Шығын туралы ескертулер мен қатаң шығын шегі орнатылған
• Барлық шақыру сіздің серверіңіз арқылы өтеді және пайдаланушы рұқсаттарын тексереді
• Шығыс ұзындығы шектелген; модель атын конфигурациялауға болады
• Қолданбаңызда пайдаланушыға жылдамдық шегі бар
• 429 Retry-After, кідіріс және кездейсоқ кідіріспен өңделеді
• Ыңғайлы қате күйі бар; AI-сыз да бет жұмыс істейді
• Әр функция бойынша токен пайдалануы тіркеледі
• Ұзын, бос және зиянды енгізулермен тексерілген

Mythex-те OpenAI API-ды пайдалану

Mythex-те құрастыратын қолданбалардағы AI мүмкіндіктері сіздің өз OpenAI кілтіңізді пайдаланады, Mythex құрылыс кредиттеріне емес, сіздің OpenAI аккаунтыңызға есептеледі. OPENAI_API_KEY мәнін /secrets арқылы, жоба баптауы арқылы немесе агент кілт қажет болғанда көрсететін құпиялар картасы арқылы жоба құпиясы ретінде қосыңыз, содан соң мүмкіндікті жоғарыдағыдай нұсқаумен сипаттаңыз. Жарияланған қолданбада құпияларды өзгерткеннен кейін оны қайта жариялаңыз, сонда жаңалары қабылданады. Құжаттағы өз API кілттеріңізбен AI мүмкіндіктерін қосу рецептінде бастапқы нұсқау бар, ал чаттағы құпиялар құпиялар картасын түсіндіреді. Провайдерлерді салыстырасыз ба? Claude API-ды қалай қосу керек мақаласын қараңыз.

Сұрақтар