SillyTavern 接入 QCode
在 SillyTavern 中用 QCode.cc 的 Claude / GPT 模型聊天；关于 gpt-image-2 出图能否接入的诚实说明与替代方案
最后核实：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 |
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：
- 打开 API Connections（插头图标）→ Chat Completion。
- Chat Completion Source（聊天补全来源）选 Claude。
- 展开下方的 Reverse Proxy（反向代理）折叠区。它不是勾选框，没有开关——代理地址留空就表示走 SillyTavern 内置的官方地址。
-
填写两个字段：
-
Proxy Server URL（代理服务器 URL）：
https://api.qcode.cc/api/v1（中国大陆推荐https://asia.qcode.cc/api/v1） - Proxy Password（代理密码）：你的 QCode API Key（
cr_开头） - Claude Model 下拉里选
claude-opus-5、claude-sonnet-5、claude-haiku-4-5等（4.x 如claude-sonnet-4-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。 - 官方对代理的声明：使用不是你自己运行的代理有数据隐私风险，且官方写明用代理时不接受任何支持请求。这里指向的是你自己的 QCode 账号与 Key，请知悉后再继续。
二、用 QCode 的 GPT 模型对话¶
走 OpenAI 兼容端点：
- API Connections → Chat Completion。
- Chat Completion Source 选 Custom (OpenAI-compatible)。
-
填写：
-
Custom Endpoint (Base URL)：
https://api.qcode.cc/openai/v1（大陆推荐https://asia.qcode.cc/openai/v1） - API Key：你的 QCode API Key
- 在 Enter a Model ID（输入模型名）里填
gpt-5.5、gpt-5.4、gpt-5.6-terra等。 - Connect 即可。
这里同样只填到
/openai/v1，不要自己加/chat/completions（SillyTavern 会补）。 同一个 API Key 三种协议都能用，协议由路径决定。详见 接入点与 API 格式。
三、关于 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端点的工具直接调用：basehttps://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（亚洲节点，HK/JP 就近接入），不稳时切回 api.qcode.cc（全球路由）。
Q：能查到我的请求记录吗？ A：可以，所有域名的请求都会上报到 probe.qcode.cc，输入 API Key 即可查看。
想要一份套餐同时覆盖 Claude Code、Codex 和这类第三方客户端？看看 QCode.cc 定价，一个 API Key 三种协议通用。