API-ключ Qwen Code в 2026 году: создание, подключение и стоимость
MarkdownКак получить API-ключ для Qwen Code в России: где создать ключ, настроить подключение и оценить расходы на модели Qwen по тарифам провайдера.
Читать статью полностью
Вы устанавливаете Qwen Code, запускаете его в терминале, а при первом запросе программа просит ключ. После этого начинается поиск: по запросу «купить API-ключ для Qwen Code» встречаются предложения купить подписку или готовый доступ. В этой статье объясняется, что представляет собой ключ, где его создать и как рассчитывается стоимость работы.
Ключ не продаётся как отдельный товар. Это строка доступа, которую пользователь бесплатно создаёт в личном кабинете провайдера модели. Платить может потребоваться позже, при пополнении баланса, — условия на этом этапе устанавливает провайдер. Ниже описано, где создать ключ, как подключить его к Qwen Code и из чего складываются расходы.
Внимание
Это справочный материал о публично доступных правилах. В нём не приводятся названия посреднических сервисов, предлагающих проводить оплату в обход ограничений, или способы обхода ограничений. Цены указаны по страницам провайдеров на начало сентября 2026 года. Они могут меняться, поэтому актуальные значения следует проверять на сайте провайдера.
Документация Ailoot — справочные материалы о работе с сервисом.
Что такое API-ключ для Qwen Code?
Главное
API-ключ для Qwen Code — персональная строка доступа, с помощью которой провайдер определяет, от кого поступил запрос к модели, и учитывает расход. Сам Qwen Code — бесплатный агент с открытым исходным кодом; собственной модели в нём нет. Для получения ответов он обращается к внешнему провайдеру и передаёт ему ваш ключ. Поэтому получить ключ означает зарегистрироваться у провайдера и создать строку доступа в личном кабинете. Передайте значение ключа через окружение запускающего терминала; в настройках укажите имя читаемой переменной. Доступ проверьте отдельным запросом модели.
Qwen Code — терминальный ИИ-агент с открытым исходным кодом, который помогает писать код по заданным задачам. Его можно бесплатно установить через npm. Встроенной нейросети у него нет: вычисления выполняет модель на серверах провайдера.
Для обращения к модели Qwen Code требуется ключ доступа. Провайдер выдаёт пользователю длинную строку, похожую на пароль. Агент прикладывает её к запросу, провайдер распознаёт владельца, возвращает ответ и списывает стоимость с его баланса.
Это помогает разобраться в распространённом заблуждении: ключ не нужно искать как товар на маркетплейсе. Пользователь регистрирует аккаунт у провайдера, создаёт ключ и получает строку бесплатно. Запрос «купить API-ключ» обычно означает поиск провайдера и способа оплаты последующего использования; далее рассмотрены оба вопроса.
Чем API-ключ отличается от подписки и прежнего бесплатного входа?
Главное
Qwen Code поддерживает несколько способов аутентификации и оплаты. Прежний бесплатный Qwen OAuth прекращён 15 апреля 2026 года. Alibaba Coding Plan использует подписку и отдельный endpoint, а стандартный API-ключ Model Studio — оплату по фактическому расходу. В текущих клиентах могут быть и другие платформы и планы. Это руководство описывает стандартный ключ Model Studio: регион, endpoint, модель и платёжный план должны соответствовать друг другу.
В Qwen Code команда /auth показывает способы входа, поддерживаемые установленной версией. Выберите платформу, выпустившую ключ, и её платёжный план. Ниже объясняются прежний бесплатный вход, Coding Plan и стандартный API-ключ из этого руководства; это не исчерпывающий перечень текущего меню.
Первый — бесплатная авторизация через аккаунт Qwen (Qwen OAuth). Раньше она предоставляла доступ к модели без ключа, однако этот вариант закрыт.
Бесплатный тариф Qwen OAuth прекращён с 15 апреля 2026 года. Ранее сохранённые токены ещё могут некоторое время работать, но новые запросы будут отклоняться.
Второй вариант — Coding Plan от Alibaba ModelStudio. Это подписка с фиксированным ежемесячным платежом, недельной квотой запросов и отдельным адресом подключения.
Третий — API-ключ у провайдера модели. Фиксированной абонентской платы здесь нет: пользователь пополняет баланс и оплачивает фактическое использование по счётчику токенов. Такой вариант удобен при нерегулярной работе с агентом. Далее речь пойдёт именно о нём.
Где создать API-ключ для Qwen Code?
Главное
Qwen Code подключается к нескольким провайдерам и протоколам. Для прямого доступа к Alibaba Model Studio выберите регион в консоли до создания ключа. Ключ, базовый URL API, workspace и доступная модель должны относиться к одному региону. Международный адрес консоли или английский интерфейс сами по себе не определяют регион API.
Qwen Code поддерживает несколько протоколов, поэтому ключ можно получить у разных провайдеров. В официальной документации перечислены варианты подключения.
Поддерживаются протоколы OpenAI, Anthropic, Gemini и Qwen. Можно подключать сторонних провайдеров или локальные модели и переключаться между ними во время работы.
Ниже описан вариант прямого подключения.
Для прямого подключения откройте консоль Alibaba Model Studio, выберите нужный регион и создайте ключ на странице управления API-ключами. Сохраните регион и имя workspace с настройками; само значение ключа в общие заметки не копируйте.
| Регион ключа | Стандартный OpenAI-compatible base URL | Что проверить |
|---|---|---|
| Китай (Пекин) | DASHSCOPE_BASE_URL | Пекинский ключ и модель, доступную в регионе |
| Сингапур | DASHSCOPE_BASE_URL | Сингапурский ключ и модель, доступную в регионе |
| США (Вирджиния), включая Global или US deployment scope | Скопируйте API Host выбранного US workspace и используйте его документированный OpenAI-compatible base URL | Ключ US workspace, deployment scope и список моделей; не переносите адрес Пекина или Сингапура |
Региональное руководство рекомендует выделенные домены workspace для production. Скопируйте настоящий API Host из Workspace Management и следуйте руководству по base URL; не придумывайте ID workspace. Общие DashScope endpoints и выделенные адреса workspace — разные варианты доступа. Coding Plan и Token Plan также используют свои endpoints и ключи. Скопируйте полный OpenAI-совместимый Base URL из консоли выбранного регионального workspace в DASHSCOPE_BASE_URL. В JSON поле baseUrl опущено; перед запуском адрес задаётся через OPENAI_BASE_URL. Используйте реальные значения из консоли, а не буквальный шаблон ID workspace.
Есть также бесплатный способ работы без ключа: запустить модель Qwen на собственном компьютере через Ollama и подключить к ней Qwen Code как к локальному серверу. Для этого нужен достаточно мощный компьютер и отдельная настройка. Запуск агента локально описан в материале о работе с Qwen Code в терминале.
Как подключить API-ключ к Qwen Code?
Главное
В ~/.qwen/settings.json задайте протокол, региональный base URL, ID модели и envKey — имя переменной окружения с ключом. Секретное значение в JSON не записывайте. Запускайте Qwen Code из терминала, где задана переменная; проверьте подключение и отправьте короткий запрос. /model показывает настроенные варианты, но само по себе не доказывает доступ к провайдеру.
Сохраните копию существующих настроек и объедините подключение ниже с ~/.qwen/settings.json, не перезаписывая остальные провайдеры и предпочтения. Пример следует документации Qwen Code по аутентификации с передачей URL рабочего пространства через OPENAI_BASE_URL, чтением API-ключа из переменной окружения, указанной в envKey, и без открытого блока env. qwen3-coder-plus взят из официального примера; сначала проверьте его доступность в своём регионе и аккаунте либо используйте реальный региональный ID из консоли в обоих местах.
Скопируйте полный OpenAI-совместимый Base URL из консоли выбранного регионального workspace в DASHSCOPE_BASE_URL. В JSON поле baseUrl опущено; перед запуском адрес задаётся через OPENAI_BASE_URL. Используйте реальные значения из консоли, а не буквальный шаблон ID workspace.
{
"modelProviders": {
"openai": [
{
"id": "qwen3-coder-plus",
"name": "qwen3-coder-plus",
"envKey": "DASHSCOPE_API_KEY"
}
]
},
"security": { "auth": { "selectedType": "openai" } },
"model": { "name": "qwen3-coder-plus" }
}
openai выбирает совместимый протокол. envKey — имя читаемой переменной, а не значение ключа. model.name должен совпадать с id. Поля описаны в справочнике провайдеров моделей.
На macOS или Linux откройте Bash, введите ключ в скрытом приглашении и запустите Qwen Code из этого же терминала:
read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
printf '\n'
if [[ -n "$DASHSCOPE_API_KEY" ]]; then
export DASHSCOPE_API_KEY
export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
qwen
else
printf '%s\n' 'STOP: API key is empty.' >&2
fi
fi
В Windows используйте PowerShell:
$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen
Эти команды не помещают буквальный секрет в JSON и историю команд; работающий процесс всё равно получает его через окружение. Не печатайте ключ, не коммитьте и не вставляйте в промпт. При переходе удалите старую запись env с секретом из настроек. В новом терминале переменную нужно задать снова.
В Qwen Code проверьте аутентификацию через /doctor и выбранную модель через /model. В пустой безопасной тестовой папке отправьте: «Ответь словом connected. Не читай и не меняй файлы и не запускай команды». Успешный ответ проверяет один запрос к модели и может тарифицироваться. Наличие модели в /model подтверждает только локальные настройки.
При ошибке сохраните редактированный текст и ID запроса, если он передан. Отдельно проверьте аутентификацию, доступность модели и оплату: платформу выпуска ключа, регион/workspace, стандартный или плановый endpoint, ID модели и баланс/квоту в той же консоли. Ошибка 401 может означать несовпадение ключа, endpoint или плана; это не доказательство неисправности провайдера. После неудачной проверки остановитесь и исправьте документированное несоответствие до повтора. Здесь приведён пример по документации; платный запрос для руководства не выполнялся.
Сколько стоит использование API-ключа и от чего зависит расход?
Главное
При использовании API-ключа оплата рассчитывается по фактическому расходу: у каждой модели своя цена за входные и выходные токены, фиксированного месячного платежа нет. Итоговая сумма зависит от объёма текста, который агент читает и создаёт. Чем больше файлов он обрабатывает и чем длиннее ответы, тем выше расход. Цены меняются, поэтому актуальные тарифы нужно проверять у провайдера.
В отличие от подписки, при оплате по API-ключу ежемесячная сумма заранее не фиксирована. Стоимость зависит от объёма текста, который модель обработала; этот объём измеряется в токенах. Токен — небольшая единица текста, обычно несколько символов. Для каждой модели установлена отдельная цена за миллион входных и выходных токенов. Выходные токены обычно обходятся дороже входных.
Миллион токенов может показаться большим объёмом, но при работе с крупным проектом он расходуется быстрее, чем ожидается: агент может читать файлы целиком при каждом запросе.
Практически расход определяется количеством текста, переданного модели. Длинные файлы и продолжительные сессии увеличивают его, особенно если код приходится перечитывать. Число задач само по себе менее показательно. Подробный разбор расчёта стоимости и причин незаметного расхода приведён в материале о расходе токенов через API.
Почему платежи могут отклоняться?
Главное
Для использования ключа с оплатой по расходу необходимо пополнить баланс. Если платёжная система отклоняет карту из-за банка-эмитента, смена электронной почты, языка интерфейса или настроек профиля не меняет условия, установленные для карты.
Важно учитывать, на каком именно этапе возникает проблема.
Ключ можно создать, но без средств на балансе запросы с оплатой по расходу не выполнятся: провайдер отклонит их из-за недостатка средств.
Если платёж отклонён по причине, связанной с банком, выпустившим карту, смена электронной почты, языка интерфейса или настроек профиля не устраняет это ограничение. Подобный механизм рассмотрен на примере иностранной карты для Claude.
Окончательное решение о проведении платежа принимает платёжный шлюз. Он может отклонить операцию по своим причинам, поэтому гарантировать её прохождение нельзя.
С чего начать?
Главное
Выберите платформу и способ оплаты: прежний бесплатный Qwen OAuth закрыт, Coding Plan использует подписку, а стандартный Model Studio — оплату по расходу. Создайте ключ в нужном регионе, настройте подключение без значения секрета и передайте ключ через окружение запускающего терминала. Выпуск ключа и оплата запросов — отдельные шаги. Проверяйте баланс и доступность выбранной модели.
Краткий порядок действий:
- Разберитесь в способах входа. Бесплатный аккаунт Qwen закрыт с апреля 2026 года. Coding Plan — подписка с фиксированной месячной оплатой, API-ключ — оплата по фактическому расходу. Далее речь идёт о ключе.
- Создайте аккаунт у провайдера. Для прямого доступа к моделям Qwen можно воспользоваться Alibaba.
- Выпустите ключ доступа в личном кабинете провайдера. Создание ключа бесплатно и не требует карты.
- Объедините региональное подключение с
~/.qwen/settings.jsonбез значения секрета. ЗадайтеDASHSCOPE_API_KEYв запускающем терминале, проверьте модель и один короткий ответ, как показано выше. - Для оплаты использования потребуется карта, которую принимает платёжный шлюз провайдера. Условия пополнения задаёт шлюз; создание ключа и оплата запросов — отдельные этапы.
Также выберите модель с учётом задач и бюджета. Qwen3-Coder-Plus подойдёт для сложных задач, а более лёгкая Flash — если важно сократить расход. Различия между Qwen Code и другими терминальными агентами рассмотрены в статье о Qwen Code как альтернативе Claude Code.
Источники
- Qwen Code — репозиторий на GitHub — исходный код агента, установка, поддерживаемые протоколы и подключение провайдеров
- Qwen Code — документация по аутентификации — способы входа, прекращение бесплатного OAuth 15.04.2026 и настройка ключа в settings.json
- Alibaba Cloud ModelStudio — консоль — международный кабинет для создания ключа доступа к моделям Qwen
Дополнительные материалы — на Ailoot.
Подробнее
Вопросы и ответы
Равен ли выпуск API-ключа покупке доступа к моделям?
Нет. Выдача строки доступа и пополнение расходного баланса — разные шаги. По ключу поставщик определяет и учитывает запросы. Наличие ключа не подтверждает доступный баланс или квоту.
Что должно совпадать в настройке поставщика Qwen Code?
Протокол, базовый URL, переменная окружения с ключом и идентификатор модели должны относиться к одному подключению. В примере model.name совпадает с id записи modelProviders. Настоящий ключ не включайте в общие копии настроек.