SillyTavern 接入 QCode
在 SillyTavern 中用 QCode.cc 的 Claude / GPT 模型聊天;关于 gpt-image-2 出图能否接入的诚实说明与替代方案
SillyTavern 接入 QCode¶
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 出图」 |
一、用 QCode 的 Claude 模型对话¶
SillyTavern 的 Claude 接入自带「反向代理(Reverse Proxy)」选项,正好用来指向 QCode:
- 打开 API Connections(插头图标)→ Chat Completion。
- Chat Completion Source 选 Claude。
- 勾选 Use a reverse proxy(使用反向代理)。
-
填写:
-
Proxy Server URL:
https://api.qcode.cc/api(中国大陆推荐https://asia.qcode.cc/api) - Proxy Password:你的 QCode API Key(
cr_开头) - Model 选择 / 填写:
claude-opus-4-8、claude-sonnet-4-6、claude-haiku-4-5等。 - 点击 Connect,连接成功即可在角色卡中对话。
QCode 的 Anthropic 协议前缀是
/api,SillyTavern 会自动拼成/api/v1/messages,BASE_URL 不要带尾部斜杠。
二、用 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
- Model 填
gpt-5.5、gpt-5.4、gpt-5.3-codex等。 - Connect 即可。
同一个 API Key 三种协议通用(Anthropic / OpenAI / Gemini),协议由路径决定。详见 接入点与 API 格式。
三、关于 image-2 出图(诚实说明)¶
很多用户问:能不能把 QCode 的 gpt-image-2 接到 SillyTavern 里做角色立绘 / 配图?
目前不行。 原因:
- SillyTavern 的图像生成(Stable Diffusion 扩展)只支持一组固定后端:ComfyUI、Stable Diffusion WebUI(AUTOMATIC1111 / Forge)、NovelAI、Stability AI、OpenAI(DALL·E)、Pollinations 等。
- 它没有「自定义 OpenAI 兼容出图端点」这个选项——也就是说,你无法像填聊天端点那样,给图像生成填一个自定义
base_url指向 QCode 的/v1/images/generations。 - 社区已有功能请求 #4851("Add custom openai compatible endpoint for the image generation extension"),但尚未实现。
它内置的「OpenAI」图像来源固定走
api.openai.com的 DALL·E,不能改 base URL,所以也无法借道接入gpt-image-2。
替代方案¶
如果你要用 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(香港节点,就近低延迟),不稳时切 api.qcode.cc(全球路由)。
Q:能查到我的请求记录吗? A:可以,所有域名的请求都会上报到 probe.qcode.cc,输入 API Key 即可查看。
想要一份套餐同时覆盖 Claude Code、Codex 和这类第三方客户端?看看 QCode.cc 定价,一个 API Key 三种协议通用。