OpenAI API Key: где создать ключ и как подключить Relay
OpenAI API Key нужен для авторизации запросов к API OpenAI. Для работы через Relay создают другой ключ, в кабинете Relay, и указывают адрес https://relay-llm.ru/v1. Его можно передать OpenAI SDK с этим базовым адресом. Ключ Relay не открывает ChatGPT и не оплачивает подписку на него. Ниже разберём создание ключа, первый вызов и проверку ошибок без передачи секрета в браузер.
Коротко
Для Relay нужны собственный ключ, базовый адрес и идентификатор модели.
Все ключи аккаунта тратят общий баланс; отдельный ключ помогает ограничить расходы приложения.
Сохраните секрет при создании: повторно посмотреть его нельзя.
Где получить OpenAI API Key и ключ Relay
Сначала выберите сервис, к которому обращается приложение. API-ключ OpenAI выпускают на платформе OpenAI. Ключ Relay выпускают в Relay. Название библиотеки не определяет получателя запроса: OpenAI SDK отправит его на адрес из baseURL.
Запросы «API-ключ ChatGPT» и «где взять API ChatGPT» часто смешивают доступ к чату с программным доступом. Подписка на чат и ключ для серверных вызовов решают разные задачи. Если нужен именно интерфейс ChatGPT, эта инструкция по Relay API его не заменит.
Для подключения Relay выполните действия по порядку:
Зарегистрируйтесь и подтвердите почту. Подтверждение нужно для создания ключей.
Откройте раздел «API-ключи» и создайте ключ с названием приложения, например
catalog-dev.Сохраните показанный секрет в менеджере секретов или настройках серверного процесса.
Задайте разрешённые модели и лимит расходов, если приложению не нужен весь каталог.
Проверьте баланс. Способы и условия пополнения смотрите на странице цен и в кабинете.
Отдельного кошелька у каждого ключа нет. Дневной, месячный и общий лимиты ограничивают расход из баланса аккаунта. Пополнение не сбрасывает исчерпанный лимит ключа: измените его или дождитесь нового периода, если ограничение периодическое.
Как отправить запрос из Node.js
Пример рассчитан на серверный Node.js с установленным пакетом openai. Сохраните его в файл relay-check.cjs: в CommonJS вызов с await выполняется внутри асинхронной функции. Настройку пакета сверяйте с документацией SDK.
const OpenAI = require('openai')
async function main() {
const client = new OpenAI({
apiKey: 'sk-demo-not-a-real-key',
baseURL: 'https://relay-llm.ru/v1',
maxRetries: 0,
})
const result = await client.chat.completions.create({
model: 'gpt-5.6-sol',
messages: [{ role: 'user', content: 'Ответь одним словом: готово' }],
})
console.log(result.choices[0]?.message.content)
console.log(result.usage)
}
main().catch((error) => {
console.error(error.message)
process.exitCode = 1
})Демонстрационный ключ не работает. В приложении замените значение apiKey на process.env.RELAY_API_KEY и передайте секрет через окружение сервера. Запустите файл командой node relay-check.cjs.
Не дописывайте /chat/completions в baseURL: SDK добавляет маршрут сам. Идентификатор gpt-5.6-sol есть в каталоге моделей; для другого варианта скопируйте его точный идентификатор. Имя модели в интерфейсе может отличаться от значения поля model.
Что проверить, если ключ не работает
При 401 проверьте, получил ли процесс переменную окружения. Терминал и фоновая служба могут запускаться с разными переменными. Затем проверьте состояние ключа в кабинете: отключённый, отозванный или просроченный ключ не авторизует запрос. Сам секрет в лог не выводите.
При 404 прочитайте код ошибки. model_not_found указывает на неизвестный идентификатор модели, not_found может означать неверный путь. Не пытайтесь исправить маршрут перевыпуском ключа. Формат запроса есть в руководстве Chat Completions.
При 402 различайте insufficient_balance и key_limit_exceeded: первому нужна проверка доступного баланса, второму настройка лимита ключа. Для 429 ориентируйтесь на x-should-retry и Retry-After, ограничивайте число повторов. Полный разбор есть в документации ошибок.
После успешного вызова откройте историю запросов. Сопоставьте модель, ключ, токены и стоимость. Сохраните x-request-id из ответа для диагностики; счётчики usage не заменяют сумму списания в кабинете.
Как заменить потерянный или раскрытый секрет
Потерянный ключ нельзя прочитать заново: перевыпустите его. Плановую замену можно провести с доступным в кабинете льготным сроком для старого секрета. При утечке отзовите раскрытый ключ и обновите конфигурацию приложений. Не ограничивайтесь удалением строки из последнего коммита: секрет мог остаться в истории Git или журнале сборки.
Можно ли использовать OpenAI API Key вместо ключа Relay?
Для адреса Relay нужен ключ Relay. Не смешивайте ключ одного сервиса с адресом другого.
Почему после оплаты ChatGPT запросы Relay не работают?
Подписка ChatGPT не пополняет баланс Relay. Проверьте баланс и лимит своего ключа в кабинете Relay.
Подойдёт ли ключ Relay для любого приложения?
Клиент должен позволять изменить адрес API и поддерживать нужный протокол. Проверьте его в разделе интеграций.
Можно ли скрыть ключ в JavaScript на сайте?
Код браузера и его запросы доступны посетителю. Выполняйте вызов на своём сервере и возвращайте браузеру результат.