К содержимому
Блог

OpenAI API Key: где создать ключ и как подключить Relay

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 выполните действия по порядку:

  1. Зарегистрируйтесь и подтвердите почту. Подтверждение нужно для создания ключей.

  2. Откройте раздел «API-ключи» и создайте ключ с названием приложения, например catalog-dev.

  3. Сохраните показанный секрет в менеджере секретов или настройках серверного процесса.

  4. Задайте разрешённые модели и лимит расходов, если приложению не нужен весь каталог.

  5. Проверьте баланс. Способы и условия пополнения смотрите на странице цен и в кабинете.

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

Как отправить запрос из Node.js

Пример рассчитан на серверный Node.js с установленным пакетом openai. Сохраните его в файл relay-check.cjs: в CommonJS вызов с await выполняется внутри асинхронной функции. Настройку пакета сверяйте с документацией SDK.

javascript
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.

GPT-5.6 Sol0,24 $ за 1 млн входных токенов

Не дописывайте /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 на сайте?

Код браузера и его запросы доступны посетителю. Выполняйте вызов на своём сервере и возвращайте браузеру результат.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.