# 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 Completion / Text Completion 源选择 + API 地址） |
| 官方文档 | [github.com/SillyTavern/SillyTavern](https://github.com/SillyTavern/SillyTavern) |

[SillyTavern](https://github.com/SillyTavern/SillyTavern) 是一个流行的本地 LLM 前端，主打角色扮演与多轮对话，支持接入各类对话模型，并自带图像生成、TTS 等扩展。本文说明如何在 SillyTavern 里使用 QCode.cc 的模型。

## 结论先行

| 能力 | 能否用 QCode | 说明 |
|------|-------------|------|
| **对话（Claude / GPT 模型）** | ✅ 可以 | SillyTavern 支持自定义 Anthropic / OpenAI 兼容端点，填 QCode 的 BASE_URL + API Key 即可 |
| **图像生成（gpt-image-2 出图）** | ❌ 暂不可 | SillyTavern 的图像生成扩展**不支持自定义 OpenAI 兼容出图端点**，无法指向 QCode 的 `gpt-image-2`。详见下文「关于 image-2 出图」 |
| **Gemini 模型** | ⚠️ 未核实 | SillyTavern 的 Google AI Studio / Vertex AI 来源同样支持填代理地址，但我们没有核实它的请求格式是否对得上 QCode 的 Gemini 腿，因此不作推荐 |

## 一、用 QCode 的 Claude 模型对话

SillyTavern 的 Claude 来源自带一个「反向代理（Reverse Proxy）」折叠区，用它就能把请求指向 QCode：

1. 打开 **API Connections**（插头图标）→ **Chat Completion**。
2. **Chat Completion Source**（聊天补全来源）选 **Claude**。
3. 展开下方的 **Reverse Proxy**（反向代理）折叠区。**它不是勾选框，没有开关**——代理地址留空就表示走 SillyTavern 内置的官方地址。
4. 填写两个字段：
   - **Proxy Server URL**（代理服务器 URL）：`https://api.qcode.cc/api/v1`（中国大陆推荐 `https://asia.qcode.cc/api/v1`）
   - **Proxy Password**（代理密码）：你的 QCode API Key（`cr_` 开头）
5. **Claude Model** 下拉里选 `claude-opus-5`、`claude-sonnet-5`、`claude-haiku-4-5` 等（4.x 如 `claude-sonnet-4-6` 仍在售）。
6. 点击 **Connect**（连接）。填了代理地址之后，第一次会弹一个「是否连接到该代理 URL」的确认框，属正常流程。

> 🔴 **代理服务器 URL 必须带 `/v1`**，填到 `https://api.qcode.cc/api/v1` 为止。
> SillyTavern 只在这个地址后面接 `/messages`，**不会替你补 `/v1`**：填 `https://api.qcode.cc/api`
> 会打到 `/api/messages` 而 404。末尾也不要带 `/`（会拼成 `//messages`）。
> 依据：1.19.0 源码 `src/endpoints/backends/chat-completions.js`，Claude 分支是 `fetch(apiUrl + '/messages')`。

两点要先知道：

- **Claude Model 是写死的下拉，不能手输模型 id。** 1.19.0 的列表已含 `claude-opus-5`、`claude-sonnet-5`、`claude-haiku-4-5`、`claude-sonnet-4-6`，与我们在售的 Claude 型号重合；但若我们之后上架的新 Claude 型号不在它的列表里，这里就选不到，只能等 SillyTavern 更新，或改用 [Claude Code](/docs/getting-started/installation)。
- **官方对代理的声明**：使用不是你自己运行的代理有数据隐私风险，且官方写明用代理时不接受任何支持请求。这里指向的是你自己的 QCode 账号与 Key，请知悉后再继续。

## 二、用 QCode 的 GPT 模型对话

走 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**：你的 QCode API Key
4. 在 **Enter a Model ID**（输入模型名）里填 `gpt-5.5`、`gpt-5.4`、`gpt-5.6-terra` 等。
5. **Connect** 即可。

> 这里同样**只填到 `/openai/v1`**，不要自己加 `/chat/completions`（SillyTavern 会补）。
> 同一个 API Key 三种协议都能用，协议由路径决定。详见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)。

## 三、关于 image-2 出图（诚实说明）

很多用户问：**能不能把 QCode 的 `gpt-image-2` 接到 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` 等。其中**只有你本机跑的那几个**（SD Web UI / SD.Next / ComfyUI / stable-diffusion.cpp / DrawThings）有可填 URL 的输入框。
- 它**没有**「自定义 OpenAI 兼容出图端点」这个选项——也就是说，你无法像填聊天端点那样，给图像生成填一个自定义 `base_url` 指向 QCode 的 `/v1/images/generations`。
- 社区已有功能请求 [#4851](https://github.com/SillyTavern/SillyTavern/issues/4851)（官方标题逐字：`[FEATURE_REQUEST] Custom openai compatible image generation enpoint (image generation extension)`，拼写错误是原文自带的），到 2026-09-18 仍是 OPEN 状态、**尚未实现**。

> 特别注意：内置的 OpenAI 图像来源的下拉里**能直接看到** `gpt-image-2` 这个名字，但它的请求地址在源码里写死为 `https://api.openai.com/v1/images/generations`，界面没有给它 base URL 输入框。名字对得上、地址改不了，所以依然接不到 QCode。

### 替代方案

如果你要用 QCode 的 `gpt-image-2` 出图，可以：

- **用 OpenAI 官方 SDK / 任意支持自定义 `images` 端点的工具**直接调用：base `https://api.qcode.cc/qcode-img/v1`，模型 `gpt-image-2`，复用同一把 QCode Key。详见 [gpt-image-2 图像生成](/docs/usage/image-2)。
- 关注 SillyTavern issue #4851 的进展；一旦支持自定义 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 三种协议通用。