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

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

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

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. Отметьте Use a reverse proxy (использовать обратный прокси).

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

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

6. Proxy Password: ваш API Key от QCode (начинается с cr_)
7. Model: выберите / введите claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5 и т. д.
8. Нажмите Connect; после подключения можно общаться в карточках персонажей.

Префикс протокола Anthropic в QCode — /api, и SillyTavern автоматически собирает его в /api/v1/messages. BASE_URL не должен заканчиваться слешем.

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. Model: введите gpt-5.5, gpt-5.4, gpt-5.3-codex и т. д.
7. Нажмите Connect.

Один и тот же API Key работает со всеми тремя протоколами (Anthropic / OpenAI / Gemini); протокол определяется путём. Подробнее см. Эндпоинты и форматы API.

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

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

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

• Генерация изображений в SillyTavern (расширение Stable Diffusion) поддерживает только фиксированный набор бэкендов: ComfyUI, Stable Diffusion WebUI (AUTOMATIC1111 / Forge), NovelAI, Stability AI, OpenAI (DALL·E), Pollinations и т. д.
• В нём нет опции «пользовательский эндпоинт изображений, совместимый с OpenAI» — то есть нельзя, как для чата, задать генерации изображений пользовательский base_url, указывающий на /v1/images/generations от QCode.
• В сообществе уже есть запрос на функцию #4851 («Add custom openai compatible endpoint for the image generation extension»), но он ещё не реализован.

Встроенный источник изображений «OpenAI» жёстко привязан к DALL·E на api.openai.com, и его base URL изменить нельзя, поэтому через него тоже не получится подключиться к gpt-image-2.

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

Если вы хотите использовать 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 (гонконгский узел, низкая задержка поблизости); если он нестабилен, переключитесь на api.qcode.cc (глобальная маршрутизация).

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

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