Како да го интегрирате OpenAI API во вашата апликација

За да го интегрирате OpenAI API, креирајте API клуч во OpenAI проект, чувајте го како тајна на серверска страна по име OPENAI_API_KEY и повикајте го API-то од рута на вашиот сопствен сервер користејќи го официјалниот SDK на OpenAI, никогаш од код во прелистувачот. Од септември 2026, почетниот водич на OpenAI го претставува Responses API како почетна точка за нови проекти. Поставете лимит на трошење пред лансирање, ограничете ја должината на одговорите, ограничете колку често секој корисник може да ја повикува функцијата и справувајте се со грешките за ограничување на брзината со повторни обиди.

Овој водич ги опфаќа поставувањето, текот на барањето, упатствата за AI градител и грешките што ги протекуваат клучевите или трошат пари. Деталите за OpenAI се од нивната официјална документација од септември 2026. За општите концепти (токени, контекстуални прозорци, цени), прво прочитајте како да ги користите LLM API-ја.

Што можете да изградите со него

• Чет-асистент во вашата апликација (како да изградите апликација со AI чет-бот)
• Копчиња „Резимирај“, „Преправи“ или „Напиши одговор“
• Извлекување структурирани податоци од слободен текст: претворање е-пошта во нарачка, означување на поддршки барања
• Пребарување и одговарање на прашања над вашата сопствена содржина
• Генерирање слики, говор и други медиумски функции, во зависност од достапните модели

Повеќе идеи има во како да додадете AI функции во вашата апликација.

Поставување на вашата OpenAI сметка

1. Креирајте сметка и проект на OpenAI платформата. Најдобрите практики за производство на OpenAI препорачуваат посебни проекти за стејџинг и производство, за секој да има свои клучеви и лимити.
2. Креирајте клуч за проектот. OpenAI препорачува поставување датум на истекување и редовно менување на клучевите.
3. Поставете известувања за трошење и строг лимит на трошење на страницата со лимити. Водичот на OpenAI вели дека известувањата ве информираат кога употребата ќе премине одреден износ, а строгиот лимит наметнува месечна граница.
4. Додајте наплата. Документацијата за лимити на брзина на OpenAI ги опишува нивоата на употреба: вашите лимити автоматски растат како трошите повеќе со текот на времето.

Тек на барањето

Прелистувач  ->  ваша серверска рута  ->  OpenAI API
             <-  (стриман) одговор   <-

1. Корисникот кликнува копче или испраќа порака.
2. Прелистувачот го повикува вашата рута, на пример POST /api/summarise.
3. Вашиот сервер проверува дали корисникот е најавен и смее да ја користи функцијата.
4. Серверот го гради барањето: упатства, влезот на корисникот и сите податоци од вашата база што ги треба задачата.
5. Повикува OpenAI со клучот од околината. SDK-овите на OpenAI автоматски го читаат OPENAI_API_KEY.
6. Го стримува или го враќа одговорот и ја бележи употребата на токени.

Официјалните SDK пакети на OpenAI се викаат 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 и обиди се повторно со експоненцијално доцнење и случајно отстапување до 3 пати; потоа прикажи „AI е зафатен, обидете се после една минута.“ За секоја друга грешка прикажи пријателска порака и остави ја остатокот од страницата да работи.

Справување со грешки и лимити

OpenAI ги мери лимитите на брзина на повеќе начини, вклучително барања во минута и токени во минута, и го достигнувате оној што прв ќе се исцрпи. Кога ќе го надминете некој, API-то враќа 429 со заглавие Retry-After. Документацијата на OpenAI вели дека оваа вредност треба да ја сметате за минимум и да додадете мало случајно доцнење за клиентите да не се обидуваат сите заедно.

Исто така подгответе се за:

• Тајмаути кај долги генерирања. Стриминг помага, како и разумна граница на излезот.
• Прекини кај провајдерот. AI функцијата треба да откаже достоинствено без да ја расипе страницата.
• Лош излез. Валидирајте го структурираниот излез пред да го зачувате и не дозволувајте излезот од моделот да предизвика чувствителни дејства без проверка во вашиот код.

Чести грешки

• Клуч во фронтендот или во репозиториумот. Кодот во прелистувачот е јавен, а протекен клуч може да се злоупотреби во рок од минути. Видете како да ги чувате API клучевите безбедни.
• Нема лимит на трошење. Јамка или злоупотребувачки корисник може брзо да направи голема сметка.
• Нема лимити по корисник. Лимитот на провајдерот ја штити вашата паричка, не другите корисници.
• Потпирање на упатството за безбедност. Корисниците можат да напишат „занемари ги претходните упатства“. Дозволите припаѓаат во серверскиот код.
• Испраќање повеќе отколку што е потребно. Целите документи и долгите истории ги множат трошоците. Испратете само што ја треба задачата.
• Фиксирање на името на моделот во кодот. Моделите се ажурираат и се повлекуваат; направете го поставка.
• Испраќање лични податоци без размислување. Прочитајте ги условите за користење на податоци на OpenAI и испратете само што ја треба функцијата.

Листа за проверка

• Посебни OpenAI проекти (или клучеви) за тестирање и производство
• Клучот е зачуван како тајна на серверска страна, никогаш во кодот на прелистувачот или репозиториумот
• Поставени известувања за трошење и строг лимит на трошење
• Сите повици минуваат преку вашиот сервер и проверуваат дозволи на корисникот
• Должината на излезот е ограничена; името на моделот е конфигурабилно
• Лимит на брзина по корисник во вашата апликација
• Справување со 429 со Retry-After, доцнење и случајно отстапување
• Пријателска состојба на грешка; страницата работи без AI
• Употребата на токени се бележи по функција
• Тестирано со долги, празни и непријателски влезови

Користење на OpenAI API во Mythex

AI функциите во апликациите што ги градите на Mythex користат ваш сопствен OpenAI клуч, наплатен на вашата OpenAI сметка, а не на кредитите за градење на Mythex. Додајте OPENAI_API_KEY како тајна на проектот преку /secrets, поставките на проектот или картичката за тајни што ја прикажува агентот кога му треба клуч, па опишете ја функцијата со упатство слично на горните. Откако ќе промените тајни на објавена апликација, објавете ја повторно за да ги земе. Рецептот во документацијата Додајте AI функции со ваши сопствени API клучеви има почетно упатство, а Тајни во чет ја објаснува картичката за тајни. Споредувате провајдери? Видете како да го интегрирате Claude API.

Прашања