SillyTavern 接入设置

在 SillyTavern 中用 Claude 反向代理或 OpenAI 兼容自定义端点接入 QCode，含设置项名称、模型支持与图像生成限制（2026）。

需要 API Key？ 前往注册 →·端点与 Base URL →

最后核实：2026-10-20 · 📄 依据官方文档（SillyTavern 1.19.0，2026-09-14 发布；GitHub Releases 页 2026-10-20 仍以 1.19.0 为 Latest）

SillyTavern 接 QCode 走 Chat Completion 的两个入口：选 Claude，在 Reverse Proxy 里填 Proxy Server URL 与 Proxy Password；或选 Custom (OpenAI-compatible)，填 Custom Endpoint (Base URL) 与 API Key，Claude 与 GPT 模型都能对话。图像生成扩展没有「自定义 OpenAI 兼容出图端点」这一项，gpt-image-2 接不进来。

接入速览¶

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

结论先行¶

一、用 QCode 的 Claude 模型对话¶

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

1. 打开 API Connections（插头图标）→ Chat Completion。
2. Chat Completion Source（聊天补全来源）选 Claude。
3. 展开下方的 Reverse Proxy（反向代理）折叠区。它不是勾选框，没有开关——代理地址留空就表示走 SillyTavern 内置的官方地址。

4. 填写两个字段：

5. Proxy Server URL（代理服务器 URL）：https://api.qcode.cc/api/v1（中国大陆推荐 https://asia.qcode.cc/api/v1）

6. Proxy Password（代理密码）：你的 QCode API Key（cr_ 开头）
7. Claude Model 下拉里选 claude-opus-5、claude-sonnet-5、claude-haiku-4-5-20251001 等（4.x 如 claude-sonnet-4-6 仍在售）。
8. 点击 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')。

1.19.0（2026-09-14 发布）的官方发布说明写明，Anthropic 一侧新增支持 Claude Fable 5 与 5.1、Claude Opus 4.8 与 5、Claude Sonnet 5（2026-10-20 核对）。

两点要先知道：

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

二、用 QCode 的 GPT 模型对话¶

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

这里同样只填到 /openai/v1，不要自己加 /chat/completions（SillyTavern 会补）。 同一个 API Key 三种协议都能用，协议由路径决定。详见 接入点与 API 格式。

同一版 1.19.0 的官方发布说明还写明，OpenAI 一侧新增支持 GPT-5.6 系列与 GPT-6 Astra（2026-10-20 核对）。

三、关于 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（官方标题逐字：[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 图像生成。
• 关注 SillyTavern issue #4851 的进展；一旦支持自定义 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 三种协议通用。

企业团队版 →