RU ▾
Получить API-ключ

uncensoredqwen.comГайд

API-ключ Qwen для VS Code: настройка пользовательского эндпоинта

Для использования API-ключа Qwen для VS Code не нужен специфичный плагин от Alibaba. Любое расширение, поддерживающее OpenAI-совместимого провайдера, принимает три значения: базовый URL, ключ и имя модели. В этом руководстве указаны точные значения и проверки, позволяющие избежать типичных ошибок.

Обновлено

Изометрическая панель редактора кода с золотым ключом, вставленным в сокет эндпоинта, подключенного к серверу

Что нужно подготовить перед открытием VS Code

API-ключ Qwen для VS Code — это просто API-ключ плюс правильные настройки эндпоинта в расширении. Сначала соберите эти три значения:

  • Базовый URL: https://api.uncensoredqwen.com/v1
  • Идентификатор модели: uncensored
  • API-ключ: создан на странице API-ключ после регистрации через Google или по электронной почте и паролю

Новые аккаунты могут получить $0,50 пробного баланса в один клик на этой странице. Карта не нужна, лимит — один на человека, срок действия — 7 дней. Этого достаточно, чтобы протестировать настройку редактора в течение нескольких дней реальной разработки.

Примечание по названию: сервис представляет собой размещённую модель с открытыми весами, запущенную независимым провайдером. Это не официальный API Alibaba и не роутер к другим поставщикам. В вашем редакторе он будет отображаться под тем именем, которое вы ему присвоите.

Сначала протестируйте ключ с помощью curl

Прежде чем менять настройки редактора, убедитесь, что ключ и URL работают по отдельности. Если это не сработает, ни одно расширение не заработает, и вы поймёте, что проблема в ключе, а не в плагине.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Список JSON, содержащий uncensored, означает, что аутентификация работает. Затем отправьте один реальный запрос на генерацию:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

Заголовки ответа включают X-Balance-USD, что позволяет быстро проверить оставшийся баланс, не выходя из терминала.

Добавление провайдера в расширение VS Code

Несколько расширений VS Code для помощи в программировании могут работать с любым сервером, совместимым с OpenAI. Метки немного различаются в разных инструментах, но поля сопоставляются одно к одному. Ищите выбор провайдера с названием вроде «OpenAI Compatible», «OpenAI» с пользовательским базовым URL или «Custom endpoint».

Поле расширенияЗначение для ввода
ПровайдерOpenAI-совместимый (или OpenAI с пользовательским базовым URL)
Базовый URL / Базовый URL APIhttps://api.uncensoredqwen.com/v1
API-ключКлюч из вашего аккаунта
ID моделиuncensored

Расширения, читающие JSON-конфиг, обычно ожидают структуру такого вида. Имена ключей могут отличаться, поэтому проверьте документацию вашего расширения и скорректируйте имена полей:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Не фиксируйте этот файл. Если ваши настройки находятся в репозитории, используйте хранилище секретов расширения или переменную окружения, а также добавьте путь к конфигу в .gitignore.

После сохранения откройте панель чата расширения и отправьте короткое сообщение, например «Объясни эту функцию», с открытым файлом. Потоковый ответ означает, что настройка завершена.

Исправление распространённых ошибок конфигурации

Большинство сбоев при настройке сводятся к нескольким опечаткам. Пройдитесь по этому списку в указанном порядке.

URL имеет неверную структуру

Базовый URL заканчивается на /v1. Расширения сами добавляют /chat/completions. Если вы вставите полный путь, вы получите ошибку 404, потому что клиент запросит /v1/chat/completions/chat/completions. Лишний слэш в конце обычно не влияет на результат, но отсутствие /v1 — критично.

Имя модели указано неверно

Некоторые расширения предварительно заполняют выпадающий список именами моделей из другого сервиса. Замените его на uncensored точно, строчными буквами. Если поле — выпадающий список без возможности ввода своего значения, ищите опцию «другая модель» или «иное».

Ключ содержит лишние символы

Копирование с веб-страницы может добавить пробел или перевод строки в конце. Вставьте текст в редактор без форматирования, удалите лишние символы и вставьте снова. Ответ 401 почти всегда указывает на это или на ключ от другого аккаунта.

Расширение всё ещё обращается к серверу по умолчанию

Если ваш баланс не меняется после запросов чата, редактор может использовать встроенного провайдера. Убедитесь, что активный профиль модели — тот, который вы редактировали, и перезагрузите окно после изменения настроек.

Запросы завершаются ошибкой 429

Это лимит запросов, описанный в следующем разделе. Тело ошибки содержит код, указывающий, какой именно лимит вы исчерпали.

Проверка того, что запросы действительно достигают API

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

  1. Следите за балансом. Выполните вызов /v1/models или короткий запрос на генерацию из терминала, запишите заголовок X-Balance-USD, отправьте три сообщения в чате редактора, затем повторите вызов в терминале. Число должно уменьшиться на небольшую величину. То же значение доступно через GET /v1/balance.
  2. Попросите то, что стандартная настройка может отклонить или обработать иначе. Небольшой безвредный тест — запросить ответ ровно из пяти слов. Если ответ следует инструкции и приходит потоком, соединение работает нормально.

Если баланс не меняется, откройте панель вывода расширения или консоль разработчика. Большинство расширений логируют URL запроса и HTTP-статус, и неверный хост будет виден сразу. Исправьте базовый URL, перезагрузите окно и попробуйте снова.

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

Автодополнение, чат и ограничения частоты запросов

Чат щадяще относится к лимитам: один запрос на сообщение. Встроенное автодополнение работает иначе. Многие расширения отправляют запрос после короткой паузы в наборе текста, что может привести к десяткам вызовов в минуту во время работы.

Знайте цифры. Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных и 60 запросов в минуту. При превышении API отвечает HTTP 429 с кодом rate_limited (слишком много в минуту) или concurrency (слишком много одновременно). При временной перегрузке вы также получаете 429 с заголовком Retry-After: 5. Потоковая генерация удерживает слот параллельности до конца потока, поэтому медленные потоки занимают ресурс дольше.

Практические настройки, которые помогут:

  • Используйте сервис для чата, редактирования и объяснений, а для пробного ключа отключите автодополнение по вкладке или увеличьте задержку срабатывания.
  • Уменьшите максимальное количество выходных токенов для автодополнения до нескольких десятков. Короткие автодополнения выполняются быстро и освобождают слот.
  • Избегайте запуска нескольких окон редактора с одним ключом во время пробного периода.

Неудачные или отклонённые запросы не тарифицируются, поэтому ошибки обходятся вам только во времени.

Стоимость сессии программирования

Промпты для кода требуют много входных данных, так как расширения прикрепляют содержимое файлов. Тарификация: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Рассмотрим один диалоговый ход, который отправляет 6 000 токенов кода и контекста и получает 800 токенов обратно:

  • Ввод: 6000 x $0,15 / 1 000 000 = $0,0009
  • Вывод: 800 × $0,50 / 1 000 000 = $0,0004
  • Итого: $0,0013 за ход

При 100 таких ходах за рабочий день это $0,13. Пробный баланс $0,50 покрывает примерно 380 таких ходов ($0,50 / $0,0013 ≈ 385). Баланс предоплаченный, не сгорает, пополнения осуществляются целыми суммами от $20 до $500, с бонусом 5% от $50, 10% от $100 и 15% от $200. См. страницу с ценами для выбора способа оплаты.

Окно контекста составляет 100 000 токенов, включая промпт и ответ модели. Если расширение индексирует весь ваш репозиторий в каждый промпт, крупные запросы будут стоить дороже и приближаться к этому пределу. Сужайте контекст до файлов, которые вам действительно нужны.

Конфиденциальность и дополнительные сведения

Промпты не используются для обучения. Тем не менее, исходный код часто содержит секреты, поэтому храните файлы .env и учетные данные вне файлов, которые вы прикрепляете к чату. Большинство расширений позволяют исключить пути из контекста.

Модель работает только с текстом. Она отвечает на вопросы по программированию, пишет функции, объясняет ошибки и поддерживает вызов функций и JSON-режим, но не генерирует изображения, аудио или видео. По полям запросов и примерам, выходящим за рамки этой страницы, см. документацию API. Если после описанных проверок ошибка всё ещё возникает, в статье о типичных ошибках при использовании API Qwen приведены другие шаблоны ошибок и способы их исправления.

Вопросы и ответы

Где взять API-ключ Qwen для VS Code?

Зарегистрируйтесь на сайте, откройте страницу API-ключей и создайте ключ. Там же можно получить пробный баланс $0,50 в один клик, без привязки карты.

Какой базовый URL нужно ввести в расширении?

Используйте https://api.uncensoredqwen.com/v1 и не добавляйте /chat/completions. Идентификатор модели — uncensored.

Почему расширение возвращает 401?

Обычно ключ неверный, содержит лишний пробел или принадлежит другому аккаунту. Скопируйте его заново и проверьте с помощью curl-запроса к /v1/models.

Можно ли использовать его для автодополнения в табах?

Он работает через настройки автодополнения, совместимые с OpenAI, но частые запросы могут превысить лимит пробной версии — 60 в минуту. Полный ключ позволяет 300 запросов в минуту.

Ваш ключ — всего в одной форме

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это полная настройка.

Получить API-ключ