OpenAI API Key: регистрация, оплата и вызовы (2026)

Многие, впервые работая с OpenAI API, застревают на трёх шагах: не знают, где создать ключ, как пополнить счёт и какой Base URL указать после получения ключа. Ниже полный путь через ZSQH AI Gateway с примерами вызовов на Python, Node.js и curl.

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

1. Регистрация в ZSQH

Откройте ZSQH AI Gateway, нажмите регистрацию, подтвердите почту и войдите.

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

API-ключи: создание и удаление ключей.
Кошелёк / Пополнение: проверка баланса и пополнение.
Журнал расходов: модель, токены и стоимость каждого вызова.

2. Создание API-ключа

Перейдите на страницу «API-ключи» и нажмите «Создать»:

Имя: укажите назначение, например openai-api-test или production-backend.
Лимит: сначала задайте невысокий предел, скорректируйте после проверки.
Срок действия: для тестового ключа можно указать 7 или 30 дней.
Сохраните и скопируйте ключ. Обычно он начинается с sk- и полностью показывается только один раз.

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

3. Пополнение

На странице «Кошелёк» выберите способ пополнения и завершите оплату по инструкции. После зачисления баланс появится в консоли.

Если вы только тестируете, пополните небольшую сумму. Цены моделей сильно различаются; смотрите страницу цены на модели. Рекомендуется сначала проверить работу на недорогой модели, а затем переключиться на основную.

4. Как заполнить Base URL

Адрес OpenAI-совместимого интерфейса ZSQH:

https://ai.zhongshangqihang.com/v1

Обратите внимание:

В OpenAI SDK, Cursor, Chatbox, LobeChat, Dify и других OpenAI-совместимых инструментах обычно указывается https://ai.zhongshangqihang.com/v1.
Если инструмент просит «API Base», «Base URL» или «Endpoint», указывайте этот же адрес.
Не пропускайте /v1 и не дописывайте в конце /chat/completions — клиент добавляет путь сам.

5. Проверка через curl

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

export OPENAI_API_KEY="sk-ваш-ключ"
export OPENAI_BASE_URL="https://ai.zhongshangqihang.com/v1"

Затем выполните вызов:

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {"role": "user", "content": "Объясни в одном предложении, что такое API-шлюз"}
    ]
  }'

Если в ответе JSON есть choices, значит ключ и Base URL настроены верно. Имя модели смотрите на странице цены на модели; при неверном имени обычно возвращается model not found.

6. Вызов из Python

Установите OpenAI SDK:

pip install openai

Пример:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5",
    messages=[
        {"role": "system", "content": "Ты краткий технический помощник."},
        {"role": "user", "content": "Объясни, что такое токен"},
    ],
)

print(response.choices[0].message.content)

7. Вызов из Node.js

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://ai.zhongshangqihang.com/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Напиши JavaScript-функцию debounce" }],
});

console.log(response.choices[0].message.content);

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

Ошибка	Причина	Что делать
`401 Unauthorized`	Неверный или удалённый ключ, отсутствует Bearer	Скопируйте ключ заново, проверьте заголовки
`404 Not Found`	В Base URL нет `/v1` или путь продублирован	Укажите адрес только до `/v1`
`model not found`	Неверное имя модели или нет доступа	Скопируйте имя со страницы цен
`insufficient quota`	Недостаточно средств	Пополните баланс и повторите
`429`	Превышен параллелизм или частота	Снизьте нагрузку, повторите позже
Пустой ответ	Параметр или модель не поддерживает запрос	Проверьте формат `messages` и возможности модели

9. Безопасность и расходы

Один ключ на человека: в команде нельзя использовать общий ключ, иначе проблему не локализовать.
Задавайте лимиты: тестовому ключу — низкий, производственному — по бюджету.
Не встраивайте ключ во фронтенд: ключ в браузере обязательно будет виден; вызовы из интерфейса должны идти через ваш сервер.
В производстве используйте переменные окружения и менеджер секретов: не храните ключ в коде или Dockerfile.
Регулярно меняйте ключи: важные ключи рекомендуется обновлять раз в 90 дней.
Смотрите журнал расходов: разделяйте по моделям, проектам и участникам, находите аномалии.

10. Чем API отличается от ChatGPT Plus

Параметр	ChatGPT Plus	OpenAI API
Способ использования	Чат в веб-версии или приложении	Программные вызовы
Биллинг	Фиксированная подписка	По расходу токенов
Для кого	Личное повседневное использование	Разработчики, продукты, команды
Квоты	Ограничения тарифа	Пополняемый баланс
Интеграция в продукт	Нет	Да

Если вам нужен только чат для себя, подписка проще. Если модель нужно встроить в продукт, скрипт, агент или инструмент, API подходит лучше.

Частые вопросы

Можно ли увидеть ключ после создания?

Обычно полное значение показывается только при создании. Если не сохранили — придётся удалить ключ и создать новый.

Можно ли одним ключом вызывать несколько моделей?

Да. Ключ — это учётные данные, модель указывается в параметрах запроса. Доступные модели смотрите на странице цен.

Почему вызов прошёл, а баланс не изменился?

Возможна задержка либо использование бесплатной квоты или кэша. Ориентируйтесь на журнал расходов и счёт.

Можно ли передать ключ коллеге?

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

Что дальше

Если аккаунта ещё нет, зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ и выполните первый запрос через curl. После успешной проверки выберите основную модель на странице цены на модели.