Как настроить OpenAI API: получить ключ и сделать первый запрос

После выполнения этой инструкции вы получите рабочий API-ключ OpenAI, сохраните его в переменной окружения OPENAI_API_KEY и отправите первый запрос через Responses API с выводом результата в терминал.

• ⏱️ Время: точное время в официальных источниках не указано; длительность зависит от доступа к аккаунту, настройки переменной окружения и установки SDK.
• 🎯 Сложность: начальный.
• 💰 Стоимость: зависит от модели и объёма использования; перед запуском проверьте актуальные условия на официальной странице pricing.
• 🛠️ Что потребуется: аккаунт OpenAI, доступ из поддерживаемой страны или территории, терминал, Python и официальный SDK OpenAI.
• 📌 Актуальность: quickstart OpenAI API, справка по ключам, рекомендации по безопасности ключей, supported countries и pricing по состоянию на 2026-08-17. Точный номер SDK и точное имя модели для первого запроса сверяйте на текущей официальной странице quickstart.

Если вам нужен только первый рабочий вызов API, маршрут здесь короткий: проверить регион, создать ключ, вынести его из кода, подготовить тестовый скрипт и убедиться, что терминал печатает response.output_text.

Редакционное ограничение: в supplied sources для этой статьи не зафиксированы один постоянный номер SDK, одна постоянная команда установки и одно неизменное имя модели в quickstart. OpenAI отдельно предупреждает, что примеры и релизные детали могут меняться. Поэтому ниже я показываю воспроизводимую последовательность действий, а имя модели и актуальную команду установки вы должны взять с текущей официальной страницы quickstart или из официального SDK-репозитория перед запуском.

Пошаговая настройка

1. Проверьте, что OpenAI API доступен в вашей стране или территории.

   OpenAI указывает, что API работает только в supported countries and territories, а доступ из неподдерживаемых локаций может быть заблокирован или приостановлен. Перед созданием ключа откройте официальный список и убедитесь, что ваша страна или территория там есть.

   Ожидаемый результат: вы понимаете, что можете использовать API из своей локации без регионального ограничения.

2. Создайте новый ключ на странице API keys.

   Откройте страницу управления ключами OpenAI: https://platform.openai.com/api-keys. Создайте новый секретный ключ и сразу скопируйте его в безопасное место. OpenAI прямо указывает, что полный секрет показывается только один раз при создании; если вы его потеряете, посмотреть тот же секрет ещё раз нельзя — придётся создать новый ключ на замену.

   Ожидаемый результат: у вас есть скопированный секретный ключ, сохранённый вне чата, заметок общего доступа и исходного кода.

3. Сохраните ключ в переменной окружения OPENAI_API_KEY.

   OpenAI рекомендует хранить ключ в переменной окружения с точным именем OPENAI_API_KEY. Не коммитьте ключ в репозиторий и не вставляйте его в клиентский код, который выполняется в браузере или другом публичном окружении. На этом шаге используйте системный способ вашей ОС для создания или обновления переменной окружения.

   Ожидаемый результат: ключ хранится вне исходников и готов для чтения SDK через OPENAI_API_KEY.

4. Проверьте, что переменная окружения действительно доступна в терминале.

   Проверка из официальной рекомендации по безопасности выглядит так:

   # macOS / Linux
   echo $OPENAI_API_KEY
   
   # Windows
   echo %OPENAI_API_KEY%

   Если терминал возвращает пустое значение, переменная ещё не настроена в текущей сессии или настроена не там. Если вывод непустой, SDK сможет прочитать ключ из окружения.

   Ожидаемый результат: команда печатает непустое значение переменной.

5. Установите официальный SDK OpenAI для Python.

   Текущий официальный quickstart предлагает путь через официальный SDK и первый вызов client.responses.create(...). Для Python берите актуальную команду установки и требования к runtime с одной из официальных страниц: Developer quickstart или openai/openai-python. Я не фиксирую команду в тексте статьи, потому что в supplied sources она не закреплена как неизменная, а README может обновляться.

   Ожидаемый результат: официальный Python SDK установлен без ошибок и доступен в вашем окружении.

6. Создайте тестовый Python-файл с первым запросом через Responses API.

   Создайте локальный файл и вставьте в него минимальный пример. В поле model подставьте текущее имя модели ровно с той страницы quickstart, которую вы открыли перед запуском. Это важно, потому что официальное примерное имя модели может меняться.

   from openai import OpenAI
   
   client = OpenAI()
   
   response = client.responses.create(
       model='УКАЖИТЕ_ТЕКУЩУЮ_МОДЕЛЬ_ИЗ_QUICKSTART',
       input='Reply with the single word OK.'
   )
   
   print(response.output_text)

   Если вы работаете не с Python, а с JavaScript/TypeScript, используйте текущий официальный пример из quickstart или репозитория openai/openai-node. Логика та же: SDK берёт OPENAI_API_KEY из окружения, запрос отправляется через Responses API, а в терминал печатается response.output_text.

   Ожидаемый результат: у вас есть готовый тестовый файл с вызовом client.responses.create(...).

7. Запустите файл и проверьте вывод в терминале.

   Запустите тестовый файл обычным способом вашего Python-окружения. Успешный результат проверки для текущего quickstart — в терминале печатается значение response.output_text. Для приведённого примера это должен быть короткий текстовый ответ, а не ошибка чтения переменной или ошибка авторизации.

   Ожидаемый результат: в терминале выводится ответ модели, значит ключ прочитан, SDK работает и первый запрос к Responses API выполнен.

Как проверить, что всё работает

• Проверка 1: команда echo $OPENAI_API_KEY на macOS/Linux или echo %OPENAI_API_KEY% на Windows возвращает непустое значение.
• Проверка 2: тестовый скрипт завершается без ошибки авторизации и печатает содержимое response.output_text в терминале.
• Проверка 3: ключ не хранится в исходниках, не закоммичен в репозиторий и не используется в клиентском коде.
• Проверка 4: имя модели в коде совпадает с текущим примером на официальной странице quickstart, а не взято из старой статьи или старого скриншота.

Частые ошибки и исправления

• ❌ Ошибка: переменная OPENAI_API_KEY пустая при проверке через echo.
  ✅ Решение: сохраните ключ именно в переменной окружения с точным именем OPENAI_API_KEY и заново проверьте её в той сессии терминала, из которой запускаете скрипт.
• ❌ Ошибка: вы потеряли секретный ключ после создания.
  ✅ Решение: не пытайтесь «найти» полный старый секрет — OpenAI пишет, что он показывается только один раз. Создайте новый ключ и замените старый там, где он использовался.
• ❌ Ошибка: запрос не проходит из-за регионального ограничения.
  ✅ Решение: сверяйте свою страну или территорию с официальным списком supported countries. OpenAI предупреждает, что доступ из неподдерживаемых локаций может быть заблокирован или приостановлен.
• ❌ Ошибка: вы взяли имя модели из старого примера, и текущий quickstart выглядит иначе.
  ✅ Решение: откройте актуальный quickstart, скопируйте текущее имя модели оттуда и при необходимости проверьте release notes.
• ❌ Ошибка: ключ попал в браузерный код или репозиторий.
  ✅ Решение: удалите ключ из клиентской части и истории хранения, выпустите новый и дальше храните его только на серверной стороне или в локальном окружении разработки.

Безопасность и ограничения

• OpenAI рекомендует хранить ключ только в OPENAI_API_KEY или другом безопасном серверном механизме, а не в открытом коде.
• Полный секретный ключ показывается только один раз при создании. Потеряли — создайте новый.
• Доступность API зависит от страны или территории. Перед развёртыванием команды и сервисов перепроверьте supported countries.
• Стоимость зависит от модели и использования. В этой статье нет фиксированной цены, потому что официальный pricing меняется и зависит от выбранной модели.
• Точная команда установки SDK и точное имя модели в quickstart могут измениться. Перед первым запуском сверяйтесь с текущими официальными страницами quickstart, SDK-репозитория и release notes.

Практический вердикт: для первого рабочего запроса вам достаточно маршрута «ключ → OPENAI_API_KEY → SDK → тестовый вызов Responses API». Для продакшена этого мало: дальше обычно нужны контроль ошибок, лимиты и безопасная серверная интеграция.

Что делать дальше

• Если после первого запроса вы хотите встроить вызов в проект, переходите к инструкции Как интегрировать OpenAI API в приложение (Python/JS).
• Чтобы не упереться в перегрузку и ограничения по трафику, настройте rate limiting для API.
• Если сервис критичен для бизнеса, заранее продумайте fallback при сбое API.
• Если вам нужен не общий обзор, а базовое понимание термина, посмотрите короткое объяснение что такое API в контексте ИИ-сервисов.

Источники

• Developer quickstart | OpenAI API
• Where do I find my OpenAI API Key? | OpenAI Help Center
• Best Practices for API Key Safety | OpenAI Help Center
• OpenAI API supported countries and territories | OpenAI Help Center
• OpenAI API pricing
• OpenAI Release Notes
• GitHub: openai/openai-python
• GitHub: openai/openai-node
• GitHub: openai/openai-openapi

Вопросы и ответы

Можно ли хранить OpenAI API key прямо в коде?

Нет. OpenAI рекомендует хранить ключ в переменной окружения OPENAI_API_KEY, не коммитить его в репозиторий и не раскрывать в клиентском коде.

Можно ли восстановить уже созданный секретный ключ, если вы его не сохранили?

Нет. OpenAI пишет, что полный секрет показывается только один раз в момент создания. Если ключ потерян, создайте новый и замените старый там, где он использовался.

Как быстро проверить, что переменная окружения настроена правильно?

На macOS/Linux выполните echo $OPENAI_API_KEY, на Windows — echo %OPENAI_API_KEY%. Если вывод пустой, переменная не настроена или недоступна в текущей сессии терминала.

Почему я должен перепроверять имя модели перед первым запросом?

Потому что OpenAI отдельно ведёт quickstart и release notes, а примерные имена моделей и детали первого запуска могут меняться. Самый безопасный путь — брать имя модели с текущей официальной страницы quickstart непосредственно перед запуском.

Нужно ли проверять pricing даже перед первым тестом?

Да. OpenAI указывает, что pricing зависит от модели и использования. В этой статье цена не фиксируется, поэтому перед любым реальным трафиком откройте официальную страницу pricing и проверьте текущие условия.