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:

  1. 打开 API Connections(插头图标)→ Chat Completion
  2. Chat Completion SourceClaude
  3. 勾选 Use a reverse proxy(使用反向代理)。
  4. 填写:

  5. Proxy Server URLhttps://api.qcode.cc/api(中国大陆推荐 https://asia.qcode.cc/api

  6. Proxy Password:你的 QCode API Key(cr_ 开头)
  7. Model 选择 / 填写:claude-opus-4-8claude-sonnet-4-6claude-haiku-4-5 等。
  8. 点击 Connect,连接成功即可在角色卡中对话。

QCode 的 Anthropic 协议前缀是 /api,SillyTavern 会自动拼成 /api/v1/messages,BASE_URL 不要带尾部斜杠

二、用 QCode 的 GPT 模型对话

走 OpenAI 兼容端点:

  1. API ConnectionsChat Completion
  2. Chat Completion SourceCustom (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. Modelgpt-5.5gpt-5.4gpt-5.3-codex 等。
  7. 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 端点的工具直接调用: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 三种协议通用。

相关文档

Cursor 编辑器接入
在 Cursor IDE 中通过自定义 Anthropic / OpenAI Base URL + API Key 接入 QCode.cc,含模型配置、自定义端点限制说明与排错
Zed 编辑器接入
在 Zed 编辑器中通过 Agent Client Protocol (ACP) 或 settings.json 把 QCode.cc 接入,启用 Opus 4.8 / 4.7 1M 上下文 agent panel 与 OpenAI 兼容上游
Claude Desktop 接入
在 Claude 桌面版的开发者模式中把 QCode.cc 配置为第三方推理网关,复用同一份 QCode 配额
🚀
开始使用 QCode — Claude Code & Codex
一份套餐同时加速 Claude Code 和 Codex,亚太低延迟
查看套餐定价 → 注册账号
团队 3 人以上?
企业团队版:独立域名 + 子Key管理 + 封号保障,人均低至 ¥250/月
了解企业版 →