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

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

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (свой Anthropic-совместимый адрес API) · GPT ✅ · китайские модели ✅ (OpenAI-совместимые) · Gemini ⚠️ не проверено |
| Протокол и Base URL | Anthropic: `https://api.qcode.cc/api/v1` (ST дописывает только `/messages` — `/v1` здесь обязателен) · OpenAI: `https://api.qcode.cc/openai/v1` |
| Где настраивается | панель подключения API в приложении (выбор источника Chat/Text Completion + адрес) |
| Официальная документация | [github.com/SillyTavern/SillyTavern](https://github.com/SillyTavern/SillyTavern) |

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

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

| Возможность | Работает с QCode? | Примечания |
|------|-------------|------|
| **Чат (модели Claude / GPT)** | ✅ Да | SillyTavern поддерживает пользовательские эндпоинты, совместимые с Anthropic / OpenAI; достаточно указать BASE_URL + API Key от QCode |
| **Генерация изображений (gpt-image-2)** | ❌ Пока нет | Расширение генерации изображений в SillyTavern **не поддерживает пользовательский эндпоинт изображений, совместимый с OpenAI**, поэтому его нельзя направить на `gpt-image-2` от QCode. См. раздел «О генерации image-2» ниже |
| **Модели Gemini** | ⚠️ Не проверено | Источники Google AI Studio / Vertex AI в SillyTavern тоже принимают пользовательский URL прокси, но мы не проверяли, совпадает ли формат их запросов с эндпоинтом QCode для Gemini, поэтому не рекомендуем |

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

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

1. Откройте **API Connections** (значок вилки) → **Chat Completion**.
2. Установите **Chat Completion Source** в **Claude**.
3. Разверните блок **Reverse Proxy** ниже. **Это не чекбокс и не переключатель** — если оставить адрес прокси пустым, SillyTavern использует встроенный официальный адрес.
4. Заполните два поля:
   - **Proxy Server URL**: `https://api.qcode.cc/api/v1` (в материковом Китае предпочтительно `https://asia.qcode.cc/api/v1`)
   - **Proxy Password**: ваш API Key от QCode (начинается с `cr_`)
5. В выпадающем списке **Claude Model** выберите `claude-opus-5`, `claude-sonnet-5`, `claude-haiku-4-5` и т. д. (4.x, например `claude-sonnet-4-6`, по-прежнему в продаже).
6. Нажмите **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](/docs/getting-started/installation).
- **Что говорит официальная документация о прокси:** использование прокси, который вы не развернули сами, — риск для приватности, а запросы в поддержку от пользователей прокси официально отклоняются. Здесь вы указываете на свой собственный аккаунт и ключ QCode — учитывайте это.

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

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

1. **API Connections** → **Chat Completion**.
2. Установите **Chat Completion Source** в **Custom (OpenAI-compatible)**.
3. Заполните:
   - **Custom Endpoint (Base URL)**: `https://api.qcode.cc/openai/v1` (в материковом Китае предпочтительно `https://asia.qcode.cc/openai/v1`)
   - **API Key**: ваш API Key от QCode
4. Введите `gpt-6-sol`, `gpt-6-luna`, `gpt-5.6-terra` и т. д. в поле **Enter a Model ID**.
5. Нажмите **Connect**.

> Здесь то же правило: **указывайте только `/openai/v1`** и не добавляйте `/chat/completions` сами (SillyTavern допишет).
> Один и тот же API Key работает во всех протоколах; протокол определяется путём. Подробнее см. [Эндпоинты и форматы API](/docs/getting-started/endpoints-and-api-paths).

## 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](https://github.com/SillyTavern/SillyTavern/issues/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](/docs/usage/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](https://probe.qcode.cc); введите ваш API Key, чтобы их увидеть.

---

> Хотите один тариф, который сразу покрывает Claude Code, Codex и подобные сторонние клиенты? Загляните в [Цены QCode.cc](https://qcode.cc/pricing) — один API Key работает со всеми тремя протоколами.