OpenAI API key: что это за ключ и чем он отличается от ChatGPT

Когда в инструкции написано «вставьте ваш OpenAI API key», новичок обычно думает про пароль от ChatGPT. Это разные вещи. OpenAI API key — это строка символов, которая подтверждает, что запрос в API пришёл от вас, и по которой сервис списывает деньги за использованные токены. Разберём, что она из себя представляет, зачем нужна и как с ней работает шлюз, совместимый с форматом OpenAI.

Что такое API-ключ

API-ключ — секретный идентификатор. Вы вставляете его в заголовок запроса, сервер находит по нему ваш аккаунт, проверяет, что ключ действителен и на балансе есть деньги, выполняет запрос и записывает расход. Логин и пароль при этом не передаются вообще.

У ключей OpenAI есть узнаваемый префикс (они начинаются с sk-), у ключа Zukko — префикс fetch_. Префикс нужен, чтобы вы и сканеры утечек отличали ключ от случайной строки. Настоящий ключ длинный и неугадываемый: подобрать его перебором нельзя, а вот скопировать из открытого репозитория или скриншота можно.

Ключ — это пароль от денег. Любой, у кого он есть, делает запросы за ваш счёт. Правила хранения — в статье безопасное хранение API-ключей↗.

Чем ключ отличается от аккаунта ChatGPT

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

За что платят по ключу

Оплата идёт за токены — кусочки текста, на которые модель разбивает запрос и ответ. Отдельно считаются входные токены (то, что вы отправили) и выходные (то, что модель написала). Цена задана в долларах за 1M токенов.

Пример (цены Zukko на 18 октября 2026, модель gpt-6.1-sol: вход $0.27, выход $1.32 за 1M). Запрос из 1 500 токенов входа и 500 токенов выхода:

1 500 × 0.27 / 1 000 000 + 500 × 1.32 / 1 000 000 = $0.000405 + $0.00066 = $0.001065, около одной десятой цента.

Расчёт для примера; настоящие числа показывает ответ API в поле usage и страница «Использование» в кабинете.

Как выглядит запрос с ключом

Ключ передаётся в заголовке Authorization:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "Что такое API-ключ? Ответь в двух предложениях."}]
  }'

То же самое в Python через официальную библиотеку openai:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key="fetch_ваш_ключ",
)

response = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "Что такое API-ключ?"}],
)
print(response.choices[0].message.content)
print(response.usage)

Библиотека сама подставит Bearer. Описание способов авторизации — в документации↗. Вместо аргументов можно задать переменные OPENAI_API_KEY и OPENAI_BASE_URL: тогда OpenAI() без параметров подхватит их сама, и ключ не окажется в коде.

Как устроен ключ шлюза

Ключ OpenAI-совместимого шлюза работает по тому же принципу, но у него несколько удобных отличий:

• Один ключ, много моделей. По одному ключу fetch_... доступны модели Claude, GPT, Gemini, DeepSeek, Qwen и GLM. Любую можно вызывать и в формате OpenAI, и в формате Anthropic.
• Общий баланс в долларах. Пополнение от $1, оплата СБП, картой MasterCard или криптой.
• Несколько ключей. У каждого есть имя, дневной и месячный лимит в долларах и список разрешённых моделей (allowed_models). Ключ для бота можно ограничить пятью долларами в месяц и одной дешёвой моделью.
• Полный ключ показывается один раз. Создайте его на странице API-ключей↗ и сразу сохраните в менеджере паролей или переменной окружения.

Ключ шлюза нельзя «подставить» вместо ключа на сайте провайдера: он действует только на адресе api.zukko.pro. Ключ OpenAI в свою очередь не откроет шлюз.

Типичные ошибки с ключом

Чаще всего встречается 401: обычно в ключ попал лишний пробел или программа шлёт его не на тот адрес.

Что делать, если ключ утёк

Сразу удалите его в кабинете и создайте новый, затем посмотрите историю расходов за последние часы. Пошаговый разбор — в статье утёк API-ключ↗. Заранее поставьте дневной лимит: тогда ущерб от утечки ограничен.

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

Где взять OpenAI API key?

Официальный ключ выдаёт сам OpenAI в своём кабинете, и условия его получения и оплаты определяет он. Ключ шлюза создаётся в кабинете Zukko↗: доступ из России — через шлюз, оплата СБП, картой MasterCard или криптой.

Бесплатный ли ключ?

Сам ключ ничего не стоит, платят за токены. Какие бесплатные лимиты бывают у официального API, смотрите на сайте провайдера, мы их не знаем. В Zukko нужно пополнить баланс от $1.

Можно ли использовать один ключ в нескольких программах?

Технически да, но лучше завести отдельный ключ на каждую: так видно, кто сколько тратит, и утечку легче локализовать.

Подойдёт ли ключ шлюза для библиотек, которые просят OpenAI API key?

Да, если библиотека позволяет указать base_url (https://api.zukko.pro/v1) и ключ. Если такого поля нет, ищите переменную окружения OPENAI_BASE_URL или настройку «OpenAI-совместимый API».