OpenAI API key: где взять и что делать, если оплата не проходит

Ключ OpenAI API создают в консоли OpenAI на странице API keys, и сделать это может только владелец аккаунта. Если оплата не проходит, путь два. Первый: решить вопрос с платёжным инструментом на стороне OpenAI, то есть получить карту банка из поддерживаемой страны. Второй: взять ключ у стороннего провайдера, который отдаёт модели OpenAI по совместимому API. Второй путь означает другую сделку с другим сервисом, а не ключ OpenAI, и ниже мы объясняем, чем одно отличается от другого.

Где создаётся ключ OpenAI

По быстрому старту OpenAI порядок такой.

1. Зайдите в консоль на platform.openai.com/api-keys. Эту ссылку быстрый старт даёт под надписью «Create an API Key».
2. Создайте секретный ключ и сразу сохраните. По справке OpenAI полный ключ показывается только при создании. Если вы его потеряли, создают новый и меняют его в приложении.
3. Положите ключ в переменную окружения OPENAI_API_KEY. На macOS и Linux это export OPENAI_API_KEY="ваш_ключ", на Windows setx OPENAI_API_KEY "ваш_ключ". SDK OpenAI читают её сами.

ChatGPT и API это отдельные продукты с раздельным биллингом: подписка ChatGPT и баланс API не связаны, об этом прямо сказано в справке OpenAI. Исключение одно: подписчики Pro (тарифы $100, $200 и $500) и рабочих пространств Business с платными местами могут активировать ежемесячные API-кредиты для связанной организации API, когда план действует не меньше 7 дней. Биллинг при этом остаётся раздельным, Plus под программу не подходит, а доступность, по словам OpenAI, зависит от страны и включённой когорты. Запросы «api ключ chatgpt» и «openai api key» ведут в одно место, на консоль API, а не в настройки чата.

Правила обращения с ключом из той же справки: у каждого участника команды свой ключ (передача ключей запрещена условиями использования), ключ не кладут в браузерный или мобильный код и не коммитят в репозиторий, а новым ключам лучше задавать срок действия и менять их по расписанию.

Как пополнить счёт API

Новые аккаунты API работают на предоплате: вы покупаете кредиты заранее, баланс убывает по мере запросов. В биллинге организации нажимаете Add payment details, указываете сумму: минимум $5, по умолчанию $10. Автопополнение при настройке включено по умолчанию, и его надо выключить, если автоматические списания вам не нужны. Баланс после покупки может обновляться несколько минут.

Что ещё сказано в справке по предоплате:

• Купленные кредиты сгорают через год, продлить срок OpenAI не может. Кредиты невозвратные. Исключения справка перечисляет: ошибка биллинга, неавторизованное списание, сбой сервиса или ошибочное ограничение аккаунта со стороны OpenAI, а ещё случаи, где возврат требуют закон или договор.
• Максимальный баланс зависит от уровня доверия аккаунта, он считается по истории использования и платежей.
• Если на аккаунте есть бесплатные кредиты, списываются они первыми.
• Когда кредиты кончились, API отвечает биллинговой ошибкой с кодом credit_balance_exhausted.

Почему оплата не проходит

Справка OpenAI «Why was my credit card declined?» называет три группы причин. Мы пересказываем её текст на 10 ноября 2026.

Список стран OpenAI собрала на странице «OpenAI API - Supported Countries and Territories». На 10 ноября 2026 в нём 208 позиций. Россия и Беларусь среди них не значатся, Казахстан, Армения, Грузия, Узбекистан, Турция и ОАЭ значатся. Отдельного списка неподдерживаемых стран OpenAI не ведёт: если страны нет в перечне, API там не поддерживается. Страница предупреждает, что обращение к сервисам из страны вне списка может закончиться блокировкой или приостановкой аккаунта.

Поэтому мы не даём инструкций, как подменить страну или карту. Самое надёжное, что остаётся при отказе по региону, это карта банка из поддерживаемой страны. Обсуждать, где такую взять, мы не беремся.

Что такое OpenAI-совместимый ключ

OpenAI-совместимым называют сервис, который принимает запросы в формате API OpenAI: адрес вида /v1/chat/completions, заголовок Authorization: Bearer <ключ>, привычные поля model и messages. Библиотека openai в таком случае работает без правок кода, меняются два значения: base_url и ключ.

Ключи не взаимозаменяемы: sk_cdx_... не откроет api.openai.com, а ключ OpenAI не примет наш адрес. На 10 ноября 2026 в каталоге по GET /v1/models есть gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna и модели изображений gpt-image-2, gpt-image-2-5, gpt-image-2-6. Каталог меняется, актуальный список и цены лежат на странице моделей.

Как подключить ключ шлюза

Регистрация идёт по логину и паролю либо через Google, GitHub или Telegram. Баланс пополняют от $1 картой РФ через YooKassa или Platega, через СБП или криптой (CryptoCloud, CryptoBot, сервис 2328 с USDT, BTC, ETH, TON). Дальше создайте ключ в разделе «API-ключи». Подробности про оба вида ключей разобраны в статье «Как получить API-ключ Claude и куда его вставить».

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.claudexia.tech/v1",
    api_key=os.environ["CLAUDEXIA_API_KEY"],
)

reply = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[{"role": "user", "content": "Чем 401 отличается от 403? Два предложения."}],
)
print(reply.choices[0].message.content)

Для готового приложения достаточно сменить переменные: OPENAI_BASE_URL на https://api.claudexia.tech/v1, ключ и идентификатор модели. Чтобы проверить сам ключ, нужен запрос, который без ключа не проходит. GET /v1/models такую проверку не даёт: 10 ноября 2026 он отдал каталог и без ключа, и с выдуманным. Короткий чат-запрос к дешёвой модели ключ требует:

curl -s -w "\nHTTP %{http_code}\n" https://api.claudexia.tech/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDEXIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-luna", "messages": [{"role": "user", "content": "Ответь одним словом: ок"}]}'

Рабочий ключ получит HTTP 200 и ответ модели. Неверный или пустой ключ получит HTTP 401 и authentication_error: так было в тот же день и без ключа, и с выдуманным. Запрос тарифицируется как обычный: по каталожной цене на ту дату, $0.04 за 1 млн входных и $0.20 за 1 млн выходных токенов у gpt-5.6-luna, он стоит доли цента. Каталог, curl https://api.claudexia.tech/v1/models, по-прежнему удобен, чтобы узнать идентификаторы моделей.

Если клиент ругается на неизвестную модель, чаще всего причина в опечатке в идентификаторе или в адресе без /v1. Как перенести существующий код с OpenAI SDK, описано в руководстве по миграции.

Правила OpenAI для посредников с 20 ноября 2026

OpenAI обновила Usage Policies 21 октября 2026, изменения вступают в силу 20 ноября 2026. В справке об обновлении среди четырёх изменений названо и требование одобрения для посредников, дающих доступ к моделям. В тексте политики это раздел «Providing access to our models»: если вы управляете платформой-посредником или другим сервисом, через который третьи лица напрямую обращаются к моделям OpenAI, нужна предварительная проверка и одобрение OpenAI. Приложение, которое лишь встраивает модели OpenAI в свои функции, под правило само по этому признаку не попадает.

Шлюзы, включая Claudexia, подходят под описание «сервис, через который третьи лица обращаются к моделям OpenAI». Решение по каждому сервису принимает OpenAI. Ни критериев, ни списка одобренных сервисов мы в тексте политики и в справке об обновлении на 10 ноября не нашли. Мы не пересказываем чужой статус и не обещаем, что доступ к моделям OpenAI через какого-либо посредника останется прежним. Если от этого зависит ваш продукт, спросите провайдера напрямую, как он относится к новым правилам, и держите запасной вариант: модели другого семейства в том же каталоге или прямой аккаунт, если ваша страна и банк его допускают.

Перед оплатой откройте каталог и условия провайдера. Модель в списке сегодня не гарантирует, что она будет в нём завтра.

Чего шлюз не заменяет

• Аккаунт и договор с OpenAI. Организации и проекты, уровни доверия и лимиты, счета для бухгалтерии, поддержка OpenAI остаются за аккаунтом OpenAI.
• Всё, чего нет в нашей документации. Там описаны POST /v1/chat/completions, GET /v1/models, генерация изображений и видео, а для Codex формат Responses. Про Realtime, дообучение и Assistants раздел сравнения с OpenAI в нашей документации советует идти к OpenAI напрямую, а про Batch документации у нас нет, поэтому считайте его недоступным, пока не проверите.
• Подписки и чат ChatGPT. Мы не продаём подписки ChatGPT и не даём доступ к веб-чату, только API. Про чат и тарифы есть отдельная статья «ChatGPT в России».
• Требования вашей компании. Если политика безопасности требует прямого договора с вендором модели, посредник не подойдёт, как бы удобно он ни платился.

Что выбрать

Про Codex CLI и ключи есть отдельный разбор: Codex по API-ключу без подписки.

FAQ

Где взять API ключ ChatGPT?

В консоли OpenAI на странице API keys. Подписка ChatGPT и API разделены: ключ создаётся в аккаунте API и оплачивается там же. Подписка для него не нужна, хотя подходящие планы Pro и Business позволяют активировать API-кредиты для связанной организации API.

OpenAI API key бесплатно: бывает ли?

В справке по предоплате бесплатного тарифа нет. Там сказано лишь, что бесплатные кредиты на аккаунте, если они есть, списываются первыми. Есть ли они у вас, видно в разделе биллинга.

Как оплатить OpenAI API из России?

России нет в списке стран, где OpenAI поддерживает API, а карту должен выпустить банк из поддерживаемой страны. Инструкций по подмене страны или карты мы не даём. Альтернатива прямому аккаунту: ключ шлюза, который оплачивается отдельно и работает по другим условиям.

Можно ли купить OpenAI API key?

Ключ создаёт владелец аккаунта в консоли. Справка OpenAI прямо пишет, что передача ключей противоречит условиям использования. Купленный у перекупщика ключ принадлежит чужому аккаунту, его могут отозвать в любой момент.

Чем ключ шлюза отличается от ключа OpenAI?

Его выдаёт другой сервис, он работает только на адресе этого сервиса и оплачивается по условиям этого сервиса. Формат запросов совместим, договор и политики нет.

Подойдёт ли ключ Claudexia к библиотеке openai?

Да, нужны base_url со значением https://api.claudexia.tech/v1 и ключ sk_cdx_.... Модель указывайте по идентификатору из каталога.