Подключение SillyTavern к QCode

Как общаться с моделями Claude / GPT от QCode.cc в SillyTavern; честное объяснение, можно ли подключить генерацию изображений gpt-image-2, и альтернативы

Последняя проверка: 2026-09-18 · 📄 По официальной документации (SillyTavern 1.19.0 (выпуск 2026-09-14))

Кратко¶

SillyTavern — это популярный локальный фронтенд для LLM, ориентированный на ролевые игры и многоходовые диалоги. Он поддерживает подключение различных диалоговых моделей и поставляется с расширениями для генерации изображений, TTS и др. В этой статье объясняется, как использовать модели QCode.cc в SillyTavern.

Сначала вывод¶

1. Чат с моделями Claude от QCode¶

В источнике Claude внутри SillyTavern есть сворачиваемый блок «Reverse Proxy» (обратный прокси) — именно его и направляют на QCode:

1. Откройте API Connections (значок вилки) → Chat Completion.
2. Установите Chat Completion Source в Claude.
3. Разверните блок Reverse Proxy ниже. Это не чекбокс и не переключатель — если оставить адрес прокси пустым, SillyTavern использует встроенный официальный адрес.

4. Заполните два поля:

5. Proxy Server URL: https://api.qcode.cc/api/v1 (в материковом Китае предпочтительно https://asia.qcode.cc/api/v1)

6. Proxy Password: ваш API Key от QCode (начинается с cr_)
7. В выпадающем списке Claude Model выберите claude-opus-5, claude-sonnet-5, claude-haiku-4-5 и т. д. (4.x, например claude-sonnet-4-6, по-прежнему в продаже).
8. Нажмите Connect. Поскольку адрес прокси заполнен, при первом нажатии появится диалог подтверждения «подключиться к этому URL прокси?» — это нормальный шаг.

🔴 В адресе прокси обязателен /v1: указывайте https://api.qcode.cc/api/v1 и на этом останавливайтесь. SillyTavern дописывает после него только /messages и не добавляет /v1 сам: https://api.qcode.cc/api уйдёт в /api/messages и даст 404. Конечный слеш тоже не нужен (получится //messages). Основание: исходный код SillyTavern 1.19.0, src/endpoints/backends/chat-completions.js, ветка Claude делает fetch(apiUrl + '/messages').

Два момента, которые стоит знать заранее:

• Список моделей Claude фиксирован, вписать свой ID модели нельзя. В списке 1.19.0 уже есть claude-opus-5, claude-sonnet-5, claude-haiku-4-5 и claude-sonnet-4-6 — они пересекаются с продаваемыми нами моделями Claude. Если мы позже добавим новую модель Claude, которой нет в списке SillyTavern, выбрать её здесь не выйдет: придётся ждать обновления SillyTavern или использовать Claude Code.
• Что говорит официальная документация о прокси: использование прокси, который вы не развернули сами, — риск для приватности, а запросы в поддержку от пользователей прокси официально отклоняются. Здесь вы указываете на свой собственный аккаунт и ключ QCode — учитывайте это.

2. Чат с моделями GPT от QCode¶

Используйте эндпоинт, совместимый с OpenAI:

1. API Connections → Chat Completion.
2. Установите Chat Completion Source в Custom (OpenAI-compatible).

3. Заполните:

4. Custom Endpoint (Base URL): https://api.qcode.cc/openai/v1 (в материковом Китае предпочтительно https://asia.qcode.cc/openai/v1)

5. API Key: ваш API Key от QCode
6. Введите gpt-6-sol, gpt-6-luna, gpt-5.6-terra и т. д. в поле Enter a Model ID.
7. Нажмите Connect.

Здесь то же правило: указывайте только /openai/v1 и не добавляйте /chat/completions сами (SillyTavern допишет). Один и тот же API Key работает во всех протоколах; протокол определяется путём. Подробнее см. Эндпоинты и форматы API.

3. О генерации image-2 (честное объяснение)¶

Многие пользователи спрашивают: можно ли подключить gpt-image-2 от QCode к SillyTavern для портретов персонажей / иллюстраций?

Пока нет. Почему:

• Генерация изображений в SillyTavern (расширение Stable Diffusion) поддерживает только фиксированный набор бэкендов: в списке 1.19.0 их 24, дословно — ComfyUI, Stable Diffusion Web UI (AUTOMATIC1111), SD.Next (vladmandic), stable-diffusion.cpp server, DrawThings HTTP API, NovelAI Diffusion, Stability AI, OpenAI, OpenRouter, TogetherAI, Pollinations, Z.AI и другие. Поле для URL есть только у тех, что вы запускаете сами (SD Web UI / SD.Next / ComfyUI / stable-diffusion.cpp / DrawThings).
• В нём нет опции «пользовательский эндпоинт изображений, совместимый с OpenAI» — то есть нельзя, как для чата, задать генерации изображений пользовательский base_url, указывающий на /v1/images/generations от QCode.
• В сообществе уже есть запрос на функцию #4851 (официальное название дословно: [FEATURE_REQUEST] Custom openai compatible image generation enpoint (image generation extension) — опечатка принадлежит авторам). По состоянию на 2026-09-18 он открыт и не реализован.

Важная деталь: в списке моделей встроенного источника OpenAI для изображений виднеется gpt-image-2, поэтому кажется, что имя совпадает. Но адрес запроса зашит в исходном коде в api.openai.com/v1/images/generations, и поля для base URL там нет — имя совпадает, адрес изменить нельзя, до QCode запрос не дойдёт.

Альтернативы¶

Если вы хотите использовать gpt-image-2 от QCode, можно:

• Использовать официальный OpenAI SDK / любой инструмент, поддерживающий пользовательский эндпоинт images, чтобы вызывать его напрямую: base https://api.qcode.cc/qcode-img/v1, модель gpt-image-2, повторно используя тот же ключ QCode. Подробнее см. Генерация изображений gpt-image-2.
• Следите за прогрессом по issue #4851 в SillyTavern; как только появится поддержка пользовательского эндпоинта изображений, совместимого с OpenAI, вы сможете указать эндпоинт изображений QCode так же, как для «чата» на этой странице.

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

Q: Подключение возвращает 401 / 403? A: Проверьте, правильно ли указан API Key и не истёк ли он. Claude использует поле «Proxy Password», а совместимый с OpenAI — поле «API Key»; не перепутайте, куда вводить.

Q: Нестабильная сеть в материковом Китае? A: Смените домен BASE_URL на asia.qcode.cc (азиатский узел, поблизости от HK/JP); если он нестабилен, переключитесь на api.qcode.cc (глобальная маршрутизация).

Q: Можно ли посмотреть записи моих запросов? A: Да. Запросы по всем доменам отправляются на probe.qcode.cc; введите ваш API Key, чтобы их увидеть.

Хотите один тариф, который сразу покрывает Claude Code, Codex и подобные сторонние клиенты? Загляните в Цены QCode.cc — один API Key работает со всеми тремя протоколами.