Оглавление
API-ключ OpenAI — это секретный токен для аутентификации запросов к https://api.openai.com. Создается в личном кабинете и используется в HTTP-заголовке Authorization: Bearer
Быстрый старт: 5 шагов
- Зарегистрируйтесь на платформе. Откройте https://platform.openai.com/ и создайте аккаунт или войдите в существующий.
Стартовый экран в OpenAI Platform, идем в дешборд
- Найдите секцию API Keys. После входа откройте меню слева и выберите пункт «API keys».
Переходим к управлению API-ключами
- Сгенерируйте новый ключ. Кликните Create new secret key, дайте понятное имя (например,
production-api) и создайте ключ.
Нажимаем кнопку создания и указываем имя ключа
- Сохраните ключ в надежном месте. После генерации ключ отображается один раз — немедленно скопируйте его. Храните в менеджере секретов или как env-переменную (
OPENAI_API_KEY).
Обязательно сохраните ключ — повторно увидеть его будет невозможно
- Безопасность превыше всего. Никогда не размещайте ключ в открытых репозиториях, клиентском коде и не передавайте третьим лицам.
Затем настройте биллинг. Понятно, что сам по себе ключ от OPEN AI бесплатный, но, чтобы его использовать нужно пополнить баланс. Откройте Billing и добавьте платежный метод или пополните счет. Списания идут по фактическому использованию; актуальные цены — на странице тарифов.
Добавляем средства на счет через удобный платежный метод
Пример тестового вызова OpenAI API
Протестируйте API. Рекомендуется использовать единый Responses API вместо /chat/completions. Ниже — минимальный пример на /v1/responses.
Установите переменную окружения с ключом (bash/zsh)
export OPENAI_API_KEY="sk-..."Отправьте запрос через curl:
curl -sS https://api.openai.com/v1/responses \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OPENAI_API_KEY" \ --data-raw '{"model":"gpt-4o-mini","input":"Hello!"}'В ответе найдите текст модели — удобно читать агрегированное поле output_text (в SDK) или content[0].text внутри массива output в «сырых» данных.
OpenAI Platform
- Код 401 — проблема с аутентификацией: проверьте ключ/заголовок.
- Код 429 — превышены лимиты или недостаточно средств.
- Храните ключ на сервере, не в браузерном коде.
Убеждаемся в работоспособности API-ключа
Ключевые понятия
| Термин | Простое объяснение |
|---|---|
| API-ключ | Уникальный токен для авторизации в сервисах OpenAI (создаётся в разделе API Keys). |
| Bearer | Передача токена в заголовке Authorization: Bearer <KEY>. |
| base_url | Основной REST-адрес: https://api.openai.com/v1; для Realtime — WebSocket wss:// (не HTTP). |
| Модели | Актуальные: GPT-4.1, GPT-4o / 4o-mini, серия о-моделей (o3, o1 и др.). Проверяйте свежий список и цены в Pricing. |
Как это работает
- Регистрация → ключ. После регистрации генерируется уникальный токен, показываемый один раз.
- Безопасное хранение. Токен хранится в защищённом хранилище с ограниченным доступом.
- HTTP-запрос. Приложение отправляет HTTPS-запрос с Bearer-токеном на
api.openai.com. - Обработка. Сервер валидирует токен, выполняет запрос и возвращает JSON.
- Лимиты. Система отслеживает RPM/TPM; при превышении вернёт 429.
Схема работы: Приложение → Bearer-токен → OpenAI API → Обработка моделью → JSON-результат → Списание средств.
Сильные и слабые стороны
| Аспект | Что хорошо | Что ограничивает |
|---|---|---|
| Получение ключа | Быстрая генерация в несколько кликов. | Однократный показ — нужна дисциплина хранения. |
| Совместимость | Единый Responses API покрывает новые возможности. | Нужно следить за изменениями API и моделей. |
| Производительность | Современные модели; у ряда — контекст до 128K (например, GPT-4o-mini), у GPT-4.1 — до 1M. | Лимиты скорости и затраты зависят от нагрузки. |
| Биллинг | Usage-based тарификация; можно пополнять счёт и задавать лимиты. | Нужно мониторить расходы и квоты. |
Типичные ошибки и как избежать
- Утечка ключа в код. Используйте переменные окружения и менеджеры секретов.
- Некорректный URL API. Всегда указывайте полный путь
https://api.openai.com/v1. - Утрата доступа к ключу. Регулярно ротируйте; разделяйте ключи по окружениям.
- Игнорирование ограничений. Обрабатывайте 429 с экспоненциальной паузой.
- Устаревшая информация о ценах. Сверяйтесь с официальным Pricing.
Дальше по теме
- Quickstart Guide — первые шаги и примеры кода.
- Authentication Docs — детали Bearer-аутентификации.
- Pricing Overview — сравнение моделей и стоимости.
- Rate Limits Documentation — подробности об ограничениях.
- Status Page — мониторинг доступности сервисов.
Источники
- OpenAI Quickstart Documentation — официальное руководство по началу работы.
- Authentication Reference — полная документация по аутентификации.
- OpenAI Pricing Page — актуальная информация о стоимости.
- Rate Limiting Guide — руководство по работе с ограничениями.
- API Keys Dashboard — интерфейс управления ключами.
- Billing Management — панель управления платежами.
Оставить комментарий