Как да интегрирате 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 препоръчват отделни проекти за staging и продукция, така че всеки да има собствени ключове и лимити.
2. Създайте API ключ за проекта. 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, опитвай отново с експоненциално забавяне и jitter до 3 пъти; след това покажи „AI е зает, опитайте отново след минута.“ При всяка друга грешка покажи приятелско съобщение и запази останалата част от страницата в движение.

Грешки и лимити

OpenAI измерва лимитите на заявките по няколко начина, включително заявки в минута и токени в минута, и ще достигнете този, който свърши първи. Когато го превишите, API връща 429 със заглавие Retry-After. Документацията на OpenAI казва да третирате тази стойност като минимум и да добавите малко случайно забавяне, за да не опитват всички клиенти едновременно.

Планирайте и за:

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

Чести грешки

• Ключ във фронтенда или в хранилището. Кодът в браузъра е публичен, а изтекъл ключ може да бъде злоупотребен за минути. Вижте как да пазите API ключовете в безопасност.
• Без лимит на разходите. Цикъл или злоупотребяващ потребител могат бързо да натрупат голяма сметка.
• Без лимити за потребител. Лимитът на доставчика защитава портфейла ви, но не и останалите ви потребители.
• Доверяване на промпта за сигурност. Потребителите могат да напишат „игнорирай предишните инструкции“. Правата принадлежат в сървърния код.
• Изпращане на повече, отколкото е нужно. Целите документи и дългите истории умножават цената. Изпращайте само каквото е нужно за задачата.
• Твърдо кодиран модел. Моделите се обновяват и се извеждат от употреба; направете го настройка.
• Изпращане на лични данни без размисъл. Прочетете условията на OpenAI за използване на данни и изпращайте само необходимото за функцията.

Контролен списък

• Отделни OpenAI проекти (или ключове) за тестване и продукция
• Ключът е съхранен като тайна на сървъра, никога в кода на браузъра или в хранилището
• Зададени известия за разходи и твърд лимит на разходите
• Всички извиквания минават през сървъра ви и проверяват правата на потребителя
• Лимитът на изхода е зададен; името на модела е конфигурируемо
• Лимит на заявките за потребител в приложението
• Обработка на 429 с Retry-After, забавяне и jitter
• Приятелско състояние при грешка; страницата работи и без AI
• Използването на токени се записва за всяка функция
• Тествано с дълги, празни и враждебни входове

Използване на OpenAI API в Mythex

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

Въпроси