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: где получить ключ и что настроить
Откройте ключи в кабинете и создайте ключ для своего приложения. Назовите его по назначению, например
qwen-test, чтобы отличать от рабочего сервиса.Скопируйте секрет в хранилище секретов или окружение локального процесса. После создания кабинет показывает маску, а не полный ключ.
Задайте подходящие лимиты расходов. Дневной, месячный и общий пределы ключа отличаются от доступного баланса аккаунта.
Найдите Qwen в каталоге, проверьте статус и протокол. В примерах используется
qwen3.8-max, идентификатор Qwen 3.8 Max.Если для выбранного запроса нужны средства, уточните условия пополнения в кабинете и на странице цен.
Ключ Relay не служит ключом другой платформы Qwen. Если у вас уже есть приложение, меняйте адрес и ключ согласованно. Не оставляйте ключ прежнего сервиса при новом base_url и не передавайте секрет Relay на сторонний адрес.
Как проверить API-ключ Qwen без генерации
Сначала проверьте, принимает ли шлюз ключ. Метод GET /v1/key возвращает сведения о текущем ключе. Этот вызов помогает отделить проблему секрета от ошибки в запросе к модели. Команда использует только демонстрационное значение; настоящий ключ храните вне общей истории команд.
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 задаёт желаемый предел вывода, а не фиксированную стоимость запроса.
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 и неверными параметрами генерации. Сначала проверьте ключ, затем короткий вызов модели.