OpenAI API — это программный доступ к моделям OpenAI: ключ из dashboard, переменная OPENAI_API_KEY, официальный SDK (pip install openai) и вызов Responses или Chat Completions. Фокус-ключ: openai api. Канон: Developer quickstart и Python library reference. Соседи: LiteLLM, ChatGPT agents, ИИ-автоматизация.
Ниже — первый маршрут новичка: ключ → SDK → один рабочий вызов. Конкретные model id и цены в ₽ не фиксируем — берите из кабинета и биллинга на дату запуска.
Два API текста: сравнение
| API | SDK-метод | Статус в доке | Когда брать | Совместимость |
|---|---|---|---|---|
| Responses | client.responses.create |
primary для новых проектов | свежий код, агенты, platform features | нативный OpenAI |
| Chat Completions | client.chat.completions.create |
поддерживается indefinite | привычный messages[], тулзы экосистемы | широкая (шлюзы, фреймворки) |
| Через LiteLLM | completion() / Proxy |
отдельный gateway | мульти-провайдер | OpenAI-формат ответа |
| Только ChatGPT UI | нет | продукт, не API | ручные задачи без кода | — |
Источник: platform.openai.com/docs/quickstart (OPENAI_API_KEY; pip/npm install openai; Responses primary) и developers.openai.com Python reference (Chat Completions supported indefinitely). Сверка: 2026-10-07. Model id и $ → кабинет, не ₽ в статье.
Первый вызов на Python
- Создайте API key в dashboard OpenAI Platform и экспортируйте:
export OPENAI_API_KEY=…. - Установите SDK:
pip install openai(Python 3.9+ по reference библиотеки). - Для нового кода используйте Responses; для совместимости со старыми примерами — Chat Completions.
- Подставьте актуальный model id из Models / текущего Quickstart — не из скриншота годичной давности.
export OPENAI_API_KEY="your_api_key_here"
pip install openai
from openai import OpenAI
client = OpenAI()
# Responses API (рекомендация quickstart для новых проектов)
response = client.responses.create(
model="YOUR_MODEL_ID", # id из dashboard / актуальной доки
input="Напиши одно предложение-чеклист для первого API-вызова",
)
print(response.output_text)
# Chat Completions (поддерживается indefinite)
completion = client.chat.completions.create(
model="YOUR_MODEL_ID",
messages=[
{"role": "developer", "content": "Отвечай кратко."},
{"role": "user", "content": "Как проверить тип объекта в Python?"},
],
)
print(completion.choices[0].message.content)Ключ не храните в репозитории: .env + python-dotenv или секреты CI. На Windows для user env используют setx OPENAI_API_KEY … (см. quickstart).
Типичные ошибки
- Путать ChatGPT Plus и оплату API: это разные продукты и биллинг.
- Коммитить ключ в git или вставлять в публичный фронтенд.
- Жёстко прописывать устаревший model id и ловить 404/model_not_found.
- Считать, что Chat Completions «уже умер» — дока явно держит его как поддерживаемый путь.
- Фиксировать рублевый прайс токенов в статье — смотрите официальный pricing и курс/посредника у себя.
FAQ: OpenAI API
Что такое OpenAI API простыми словами?
OpenAI API — HTTP/SDK-интерфейс к моделям OpenAI для текста, зрения и агентных сценариев. Ключ берёте в dashboard, кладёте в OPENAI_API_KEY, вызываете через официальный SDK (pip install openai). Канон: platform.openai.com/docs/quickstart.
Responses API или Chat Completions — что брать?
Для новых проектов документация рекомендует Responses API (client.responses.create). Chat Completions (client.chat.completions.create) поддерживается без срока отключения и остаётся стандартом совместимости с множеством инструментов.
Как сделать первый вызов на Python?
export OPENAI_API_KEY=…, затем pip install openai, создать OpenAI() и вызвать responses.create или chat.completions.create с model id из кабинета. Не коммитьте ключ в git — держите в env/.env.
Где взять актуальный model id?
В Models / dashboard и в актуальном Quickstart на platform.openai.com. Id линеек меняются; не копируйте устаревшие имена из старых туториалов без сверки.
Чем OpenAI API отличается от чата ChatGPT?
ChatGPT — продукт для людей в UI. API — программный доступ для вашего кода, биллинг по usage, свои system/developer инструкции и интеграции. Workspace agents в ChatGPT — отдельная тема (см. соседний лонгрид).
Нужен ли LiteLLM, если я уже на OpenAI API?
Не обязательно. LiteLLM полезен, когда появятся второй провайдер, локальный Ollama или единый gateway для команды. Один скрипт на одном OpenAI — достаточно официального SDK.
Вывод
OpenAI API — ключ в env, официальный SDK, Responses для нового кода и Chat Completions для совместимости. Старт: один вызов с актуальным model id. Когда нужна система обучения под интеграции — форматы на странице обучения.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и LiteLLM.