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

Qwen API Key: как получить ключ Relay и вызвать модель

Qwen API Key: как получить ключ Relay и вызвать модель

Qwen API Key для работы через Relay создают в кабинете Relay: это собственный ключ шлюза, который даёт доступ к выбранной модели Qwen. Он используется с адресом https://relay-llm.ru/v1, а не с консолью разработчика модели. Чтобы получить первый ответ, создайте ключ, скопируйте ID Qwen из каталога и отправьте короткий запрос. Отдельный аккаунт у разработчика Qwen в этом сценарии не используется.

Коротко

  • Выпускайте ключ в Relay и подключайте его вместе с адресом Relay.

  • Передавайте public ID модели без изменений.

  • Проверяйте авторизацию отдельно от генерации текста.

Qwen API Key: где получить ключ и что настроить

  1. Откройте ключи в кабинете и создайте ключ для своего приложения. Назовите его по назначению, например qwen-test, чтобы отличать от рабочего сервиса.

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

  3. Задайте подходящие лимиты расходов. Дневной, месячный и общий пределы ключа отличаются от доступного баланса аккаунта.

  4. Найдите Qwen в каталоге, проверьте статус и протокол. В примерах используется qwen3.8-max, идентификатор Qwen 3.8 Max.

  5. Если для выбранного запроса нужны средства, уточните условия пополнения в кабинете и на странице цен.

Ключ Relay не служит ключом другой платформы Qwen. Если у вас уже есть приложение, меняйте адрес и ключ согласованно. Не оставляйте ключ прежнего сервиса при новом base_url и не передавайте секрет Relay на сторонний адрес.

Qwen 3.8 Max1,86 $ за 1 млн входных токенов

Как проверить API-ключ Qwen без генерации

Сначала проверьте, принимает ли шлюз ключ. Метод GET /v1/key возвращает сведения о текущем ключе. Этот вызов помогает отделить проблему секрета от ошибки в запросе к модели. Команда использует только демонстрационное значение; настоящий ключ храните вне общей истории команд.

bash
curl --fail-with-body --silent --show-error \
  "https://relay-llm.ru/v1/key" \
  -H "Authorization: Bearer $RELAY_API_KEY"

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

Не пересылайте полный ответ вместе с ключом в общий чат. Для диагностики достаточно статуса, времени и x-request-id. Сам заголовок Authorization в логах маскируйте.

Как вызвать Qwen через OpenAI SDK

Python-пример использует Chat Completions. Установленный SDK получает адрес с /v1; путь /chat/completions добавляет сам. Параметр max_tokens задаёт желаемый предел вывода, а не фиксированную стоимость запроса.

python
from openai import OpenAI

client = OpenAI(
    base_url="https://relay-llm.ru/v1",
    api_key="sk-demo-not-a-real-key",
    timeout=60.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model="qwen3.8-max",
    max_tokens=128,
    messages=[{"role": "user", "content": "Ответь одним словом: готово"}],
)
choice = response.choices[0]
print(choice.message.content)
print("Причина завершения:", choice.finish_reason)

Формат полей смотрите в Chat Completions API. Если переносите пример в Node.js, параметр клиента называется baseURL, а не base_url. Не добавляйте /chat/completions в базовый адрес SDK: иначе клиент соберёт неверный путь.

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

Что делать при ошибке подключения

ОтветПричина для проверкиСледующий шаг
401 invalid_api_keyСекрет или авторизацияПовторите проверку ключа, затем при необходимости перевыпустите его
404 not_foundНеверный путьУкажите базовый адрес SDK с одним /v1
404 model_not_foundНеточный IDСкопируйте идентификатор из каталога
402 key_limit_exceededЛимит ключаПроверьте общий, дневной и месячный пределы
429Частота или параллелизмПрочитайте код ошибки и заголовки повтора

Полный справочник ошибок различает отказы, которые исправляют настройкой, и временные сбои. Не настраивайте бесконечные повторы: неверный ID не станет правильным после паузы. Временный сбой тоже требует ограничения числа попыток.

Как хранить ключ и проверить расход

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

В журнале запросов выберите ключ и модель, затем откройте детали вызова. Там можно сверить токены и сумму. Цена на карточке модели показывает ставку, а журнал показывает расход выполненной операции.

При плановой ротации проверьте новый секрет коротким вызовом, замените его в сервисе и отзовите старый. При утечке сначала отзовите скомпрометированный ключ: удаление файла из Git не лишает доступа тех, кто успел его скопировать.

Qwen API Key из Relay работает в консоли другого провайдера?

Нет. Ключ выпускает и проверяет Relay. Используйте его с адресом Relay; доступ к другой платформе оформляется отдельно.

Как получить API Qwen для своего сайта?

Создайте ключ Relay, выберите модель Qwen и подключите SDK на сервере сайта. Браузер обращается к вашему серверу без секрета Relay.

Зачем проверять ключ отдельно от модели?

Так отказ авторизации не смешивается с недостатком средств, ошибкой ID и неверными параметрами генерации. Сначала проверьте ключ, затем короткий вызов модели.

Получить ключ Relay для Qwen

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

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