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

OpenAI API открывает доступ к моделям семейства GPT из вашего собственного кода: вы отправляете текстовый запрос — получаете ответ модели, который можно встроить в сайт, чат-бот, скрипт обработки данных или внутренний сервис. В отличие от веб-версии ChatGPT, здесь всё происходит программно, а платите вы только за фактически использованные токены. В этом гайде разберём по шагам, как завести аккаунт, получить ключ, пополнить баланс и сделать первый рабочий запрос — на curl, Python и Node.js. Предварительный опыт работы с API не требуется.

Что такое OpenAI API и зачем он нужен

API (Application Programming Interface) — это интерфейс, через который одна программа обращается к другой. В случае OpenAI ваш код отправляет HTTP-запрос на серверы компании, передаёт текст (промпт) и параметры, а в ответ получает сгенерированный моделью текст в формате JSON. Токен — это условная единица текста: примерно 3–4 символа русского текста или около 0,75 английского слова. Тарификация идёт за токены на входе (ваш запрос) и на выходе (ответ модели).

Типичные задачи, которые решают через API: генерация и рерайт текстов, суммаризация документов, извлечение данных из писем и заявок, классификация обращений, чат-боты поддержки, перевод, помощь в написании кода. Всё, что вы делаете руками в ChatGPT, через API можно поставить на поток и встроить в свой продукт.

Шаг 1. Регистрация и получение ключа

Создаём аккаунт и проект

Зайдите на platform.openai.com и зарегистрируйтесь (или войдите, если аккаунт ChatGPT уже есть — учётная запись общая). Платформа для разработчиков — это отдельный раздел от чат-интерфейса: здесь находятся ключи, биллинг, лимиты и логи запросов. Внутри аккаунта можно создать несколько проектов — это удобно, чтобы разделять ключи и бюджеты между разными сервисами или клиентами.

Пополняем баланс

Важный момент, который часто удивляет новичков: бесплатных пробных кредитов у OpenAI сейчас, как правило, нет — модель работает по принципу pay-as-you-go (платите по мере использования). Чтобы ключ заработал, в разделе Billing нужно привязать карту и пополнить баланс (минимальная сумма пополнения — порядка 5 долларов). Без положительного баланса запросы будут возвращать ошибку о превышении квоты, даже если ключ создан корректно.

Тут же стоит сразу задать лимит расходов (usage limit): это защитит от неожиданного счёта, если в коде окажется ошибка и он отправит тысячи запросов в цикле. Установите комфортный месячный потолок и порог для уведомлений на почту.

Создаём API-ключ

Перейдите на страницу API keys и нажмите «Create new secret key». Ключ выглядит как длинная строка вида sk-... и показывается только один раз — скопируйте и сохраните его сразу в надёжное место (менеджер паролей или переменные окружения). Если потеряли — старый удаляют и создают новый. Привяжите ключ к конкретному проекту, чтобы отслеживать расходы отдельно.

Шаг 2. Первый запрос

Все запросы идут на базовый адрес https://api.openai.com/v1, а ключ передаётся в заголовке Authorization: Bearer ВАШ_КЛЮЧ. Ниже — минимальный рабочий пример на трёх языках. Модель gpt-5.6 здесь взята как актуальный флагман на середину 2026 года; названия моделей меняются, поэтому сверяйтесь с актуальным списком в документации.

curl

Самый быстрый способ убедиться, что ключ работает — отправить запрос прямо из терминала:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "input": "Объясни, что такое API, одним предложением."
  }'

Здесь $OPENAI_API_KEY — переменная окружения, в которую заранее записан ключ (в Linux/macOS: export OPENAI_API_KEY="sk-..."). Так ключ не попадёт в историю команд и в код.

Python

Установите официальную библиотеку: pip install openai. Дальше несколько строк:

from openai import OpenAI

client = OpenAI()  # ключ берётся из переменной OPENAI_API_KEY

response = client.responses.create(
    model="gpt-5.6",
    input="Объясни, что такое API, одним предложением."
)

print(response.output_text)

Библиотека сама подставит ключ из переменной окружения — прописывать его в коде не нужно и небезопасно.

Node.js

Установите пакет: npm install openai. Пример на JavaScript:

import OpenAI from "openai";

const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-5.6",
  input: "Объясни, что такое API, одним предложением."
});

console.log(response.output_text);

Если в ответ пришёл осмысленный текст — поздравляем, интеграция работает. Дальше остаётся подставлять свои промпты и параметры.

Responses API или Chat Completions — что выбрать

Сейчас у OpenAI два основных способа общаться с моделями. Исторически первым был Chat Completions (эндпоинт /v1/chat/completions) — он передаёт диалог как массив сообщений с ролями system, user, assistant. Этот формат стал фактическим стандартом индустрии, его понимают многие сторонние сервисы, и он продолжает полноценно поддерживаться.

Более новый Responses API (эндпоинт /v1/responses) OpenAI позиционирует как рекомендуемый для новых проектов. Он проще устроен для одиночных запросов, лучше приспособлен под рассуждающие (reasoning) модели, мультимодальность и агентные сценарии с вызовом инструментов. Практическое правило: если начинаете с нуля — берите Responses API; если у вас уже работает код на Chat Completions — переписывать его не обязательно, он никуда не денется.

Какую модель выбрать

OpenAI предлагает несколько уровней моделей, чтобы вы балансировали между качеством, скоростью и ценой. На середину 2026 года актуальное флагманское семейство — линейка GPT-5.6, а цены указываются за 1 млн токенов:

• GPT-5.6 Sol (алиас gpt-5.6) — флагман для сложных задач, кода и глубоких рассуждений. Ориентир по цене: около $2,5 за вход и $15 за выход.
• GPT-5.6 Terra — сбалансированный вариант «цена/качество» для большинства повседневных задач. Примерно $1,25 и $7,5.
• GPT-5.6 Luna — бюджетная модель для высоконагруженных и простых сценариев. Около $0,5 и $3.

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

Сколько это стоит и как не переплатить

Оплата идёт за токены: складываются токены запроса и ответа. Короткий вопрос-ответ обходится в доли цента, но при массовой обработке суммы набегают. Несколько приёмов экономии:

• Не отправляйте лишний контекст. Чем короче промпт и чем точнее ограничен объём ответа (параметр максимальной длины), тем дешевле.
• Используйте кэширование ввода: повторяющаяся часть промпта (например, длинная инструкция) тарифицируется со скидкой.
• Для несрочных пакетных задач есть Batch API — обработка со скидкой примерно вдвое в обмен на отложенный результат.
• Берите модель под задачу: гонять флагман на простой классификации — переплата.

Следите за расходами в разделе Usage: там видно потребление по дням, моделям и проектам.

Безопасность ключа

API-ключ — это фактически доступ к вашему кошельку, поэтому обращайтесь с ним как с паролем. Никогда не вставляйте ключ прямо в код фронтенда или в публичный репозиторий: боты сканируют GitHub и находят утёкшие ключи за минуты. Храните ключ в переменных окружения или в защищённом хранилище секретов, а все запросы к OpenAI отправляйте с сервера (бэкенда), а не из браузера пользователя. Если ключ всё же засветился — немедленно удалите его в панели и создайте новый. Для разных сервисов заводите отдельные ключи и лимиты, чтобы компрометация одного не затронула остальные.

Частые ошибки новичка

Ошибка 429 / insufficient_quota почти всегда означает не «слишком много запросов», а нулевой баланс — пополните счёт. Ошибка 401 — неверный или уже удалённый ключ, либо опечатка в заголовке. Если ответ приходит обрезанным — увеличьте лимит длины вывода. И помните про идемпотентность и повторные попытки: сетевые сбои случаются, поэтому оборачивайте вызовы в разумную обработку ошибок с повтором.

Что дальше

Вы получили ключ, пополнили баланс и сделали первый запрос — базовая интеграция готова. Дальше стоит освоить системные инструкции для задания роли модели, потоковую передачу ответа (streaming) для чат-интерфейсов, вызов инструментов (function/tool calling) и структурированный вывод в JSON. Если работаете с другими провайдерами, полезно сравнить подходы: у нас есть похожие разборы по Claude API и Gemini API — принципы получения ключа и первого запроса везде схожи, отличаются детали. А чтобы подключить модель к своим данным и сервисам без ручного кодинга каждой интеграции, посмотрите обзор MCP-серверов.