Як інтегрувати 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. Створіть ключ 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 через офіційний SDK openai із секретом 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.

Запитання