Как подключить OpenAI API к вашему приложению

Чтобы подключить OpenAI API, создайте ключ API в проекте OpenAI, сохраните его как секрет на сервере с именем OPENAI_API_KEY и вызывайте API из маршрута на вашем сервере с помощью официального SDK OpenAI — никогда из кода браузера. По состоянию на сентябрь 2026 года в официальном quickstart OpenAI Responses API предлагается как отправная точка для новых проектов. Установите лимит расходов до запуска, ограничьте длину ответов, ограничьте частоту вызовов функции для каждого пользователя и обрабатывайте ошибки лимита запросов повторными попытками.

Это руководство охватывает настройку, порядок запросов, промпты для ИИ-конструктора и ошибки, которые приводят к утечке ключей или лишним тратам. Сведения об OpenAI взяты из официальной документации по состоянию на сентябрь 2026 года. Для общих понятий (токены, контекстные окна, цены) сначала прочитайте как использовать LLM API.

Что с ним можно сделать

• Чат-ассистент внутри приложения (как создать приложение-чатбот)
• Кнопки «Резюмировать», «Переписать» или «Составить ответ»
• Извлечение структурированных данных из свободного текста: превращение письма в заказ, разметка обращений в поддержку
• Поиск и ответы на вопросы по вашему собственному контенту
• Генерация изображений, речь и другие медиафункции — в зависимости от доступных моделей

Другие идеи — в статье как добавить функции ИИ в приложение.

Настройка аккаунта 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.

Варианты и компромиссы

Промпты для ИИ-конструктора

Первая функция:

Добавьте кнопку «Резюмировать» на странице обращения. Она вызывает серверный маршрут POST /api/summarise, который проверяет, что пользователь вошёл в систему, загружает обращение и вызывает Responses API OpenAI через официальный SDK openai и секрет OPENAI_API_KEY. Название модели читайте из секрета OPENAI_MODEL. Инструкции: «Сделай резюме в 3 пунктах, затем предложи короткий ответ. Не придумывай номера заказов». Ограничьте длину вывода, выводите ответ на страницу потоком и никогда не отправляйте ключ в браузер.

Ограничения:

Ограничьте каждого пользователя 30 запросами к ИИ в час, данные храните в базе. Записывайте входные и выходные токены для каждого запроса вместе с ID пользователя и названием функции. Если OpenAI возвращает 429, учитывайте заголовок Retry-After, повторяйте запрос с экспоненциальной задержкой и случайным джиттером до 3 раз; после этого показывайте «ИИ сейчас занят, попробуйте через минуту». Для любой другой ошибки показывайте понятное сообщение и сохраняйте работоспособность остальной страницы.

Обработка ошибок и лимитов

OpenAI измеряет лимиты запросов по-разному, включая запросы в минуту и токены в минуту, и упираетесь в тот, который закончится первым. При превышении API возвращает 429 с заголовком Retry-After. В документации OpenAI сказано, что это значение — минимум, и к нему нужно добавить небольшую случайную задержку, чтобы клиенты не повторяли запросы все разом.

Также заранее продумайте:

• Тайм-ауты при долгой генерации. Потоковая передача помогает, как и разумное ограничение длины вывода.
• Сбои провайдера. Функция ИИ должна корректно отказывать, не ломая страницу.
• Некачественный вывод. Проверяйте структурированный вывод перед сохранением и не позволяйте выводу модели запускать чувствительные действия без проверки в вашем коде.

Частые ошибки

• Ключ во фронтенде или в репозитории. Код браузера публичен, и утёкший ключ можно использовать за минуты. См. как защитить ключи API.
• Нет лимита расходов. Цикл или злоупотребляющий пользователь могут быстро набежать на большой счёт.
• Нет лимитов на пользователя. Лимит провайдера защищает ваш кошелёк, но не других ваших пользователей.
• Доверие промпту как защите. Пользователи могут написать «игнорируй предыдущие инструкции». Права доступа должны быть в серверном коде.
• Отправка лишнего. Целые документы и длинная история умножают стоимость. Отправляйте только то, что нужно задаче.
• Жёстко прописанное название модели. Модели обновляются и выводятся из эксплуатации; сделайте его настройкой.
• Отправка личных данных без раздумий. Прочитайте условия использования данных OpenAI и отправляйте только то, что нужно функции.

Чек-лист

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

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

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

Вопросы