Qwen API key: как получить ключ в Alibaba Cloud или через шлюз

Qwen — семейство моделей Alibaba, и вопрос «где взять API qwen» упирается в выбор: оформить ключ в Alibaba Cloud Model Studio или подключиться через шлюз с единым ключом. Ниже оба пути: как получить ключ у Alibaba, на что там легко споткнуться, и как за пять минут вызвать Qwen 3.8 через Zukko, если регистрация у Alibaba вам не подходит.

Qwen API key: как получить ключ в Model Studio

Описание ниже опирается на страницу «Obtain an API key» из документации Alibaba Cloud Model Studio, обновлённую 11 октября 2026. Интерфейс консоли меняется, поэтому сверяйтесь с актуальной версией документации.

1. Зарегистрируйтесь в Alibaba Cloud и войдите в консоль Model Studio. Перед активацией сервиса платформа просит заполнить данные аккаунта, а требования к ним и способы оплаты смотрите у самой Alibaba Cloud.
2. Откройте страницу API Key и выберите регион в правом верхнем углу. У каждого региона свои ключи, свой адрес API и свой список моделей.
3. Нажмите Create API Key. В диалоге выбирается рабочее пространство (документация советует оставить пространство по умолчанию), описание и права. Вариант All разрешает вызывать любые модели, вариант Custom позволяет ограничить список моделей и разрешённые IP-адреса.
4. Сразу скопируйте ключ. Полный ключ показывают один раз, после закрытия окна посмотреть его нельзя; потерянный ключ приходится сбрасывать.

Дальше документация советует не вшивать ключ в код, а положить его в переменную окружения DASHSCOPE_API_KEY:

export DASHSCOPE_API_KEY="ваш_ключ"

Ловушка с регионами

Ключ из одного региона не работает на адресе другого. По документации, вызов эндпоинта американского региона ключом, созданным в китайском, возвращает HTTP 401 с кодом invalid_api_key. Если вы видите эту ошибку при заведомо правильном ключе, первым делом проверьте, что регион ключа и регион адреса совпадают.

Какой base_url указывать

Для OpenAI-совместимого режима Alibaba даёт адрес вида https://<WorkspaceId>.<регион>.maas.aliyuncs.com/compatible-mode/v1, где вместо <WorkspaceId> нужен идентификатор вашего рабочего пространства со страницы его настроек. В документации сказано, что адрес заканчивается на /compatible-mode/v1 и не включает /chat/completions. Старые общие домены на dashscope Alibaba предлагает заменить на адреса с идентификатором пространства, поэтому не копируйте адреса из старых туториалов: берите их из страницы региона в вашей консоли.

Когда проще взять ключ шлюза

Путь через Alibaba подходит, если вам нужен только Qwen и вас устраивает регистрация в их облаке. Если же вы хотите пробовать разные модели и не заводить аккаунт у каждого поставщика, удобнее единый ключ шлюза. Zukko даёт один ключ fetch_... и один баланс в долларах для Claude, GPT, Gemini, DeepSeek, Qwen и GLM. Zukko доступен из России: баланс пополняется по СБП, картой MasterCard или криптовалютой.

Ключ Zukko за три шага

1. Войдите в кабинет и откройте раздел ключей↗. Пополните баланс от $1.
2. Создайте ключ. Полный ключ показывается один раз, сохраните его в менеджере секретов. При создании можно задать дневной и месячный лимит в долларах и список разрешённых моделей: для эксперимента разрешите только Qwen.
3. Вызывайте модель. Идентификаторы Qwen в Zukko на 18 октября 2026: qwen3.8-max и qwen3.8-flash. Актуальный список — GET https://api.zukko.pro/v1/models.

Пример на Python с официальным OpenAI SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zukko.pro/v1",
    api_key="fetch_ваш_ключ",
)

response = client.chat.completions.create(
    model="qwen3.8-flash",
    messages=[{"role": "user", "content": "Объясни разницу между процессом и потоком"}],
)
print(response.choices[0].message.content)

То же самое через curl:

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-flash","messages":[{"role":"user","content":"Привет"}]}'

Обратите внимание: адрес оканчивается на /v1, а имя модели пишется как в списке /v1/models, без префиксов вроде openai/ или qwen/. Подробнее о заголовках и ошибках — в разделе об авторизации↗, а общий старт описан в быстром старте↗.

Сколько стоит Qwen через шлюз

Цены Zukko на 18 октября 2026, $ за 1M токенов (вход / выход), и официальные цены из той же таблицы:

Пример расчёта: запрос с 1 млн токенов входа и 200 тыс. токенов выхода на qwen3.8-flash стоит 1 × 0.038 + 0.2 × 0.075 = $0.053 у Zukko и 1 × 0.15 + 0.2 × 0.47 = $0.244 по официальной цене. Для qwen3.8-max те же объёмы дают 0.088 + 0.2 × 0.238 = около $0.136 против 2 + 0.2 × 6 = $3.2. Цены меняются, актуальный список всегда в /v1/models и на странице «Модели» в кабинете. Какая из двух моделей справится с вашей задачей, проверьте на своих данных: сравнивайте цену, контекст (у обеих 1M) и результат.

Как не потерять ключ

• Не коммитьте ключ в репозиторий и не присылайте его в чатах. Читайте из переменной окружения.
• Заводите отдельный ключ на каждый проект с дневным лимитом: утечка тогда ограничена суммой лимита. Подробнее о привычках — в статье о безопасности API-ключей↗.
• Если ключ засветился, отзовите его и выпустите новый. Это работает и у Alibaba (там есть сброс и удаление ключа), и в кабинете Zukko.

Чтобы пощупать Qwen без лишних регистраций, создайте ключ в кабинете и повторите пример выше. Если вам нужен именно Qwen Code, посмотрите отдельную инструкцию↗.

Частые вопросы

Где взять API Qwen, если нужен только один запрос для проверки?

Самый короткий путь — ключ шлюза: пополнение от $1 и вызов qwen3.8-flash по примеру выше. У Alibaba потребуется регистрация в облаке и выбор региона.

Почему ключ Alibaba отвечает 401 при правильной копии?

Чаще всего ключ создан в одном регионе, а запрос идёт на адрес другого. Создайте ключ в консоли того региона, адрес которого используете.

Нужно ли указывать префикс перед именем модели?

В Zukko нет: передавайте qwen3.8-flash или qwen3.8-max как в /v1/models. Префиксы нужны только некоторым клиентам со своей схемой именования, например при подключении через сторонние обёртки, и это описано в их документации.

Можно ли ограничить ключ только моделями Qwen?

Да. В кабинете Zukko у ключа есть список разрешённых моделей и лимиты. Запрос к другой модели вернёт 403 model_not_allowed_for_key.