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 が 3 つのプロトコル(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 の料金 をご覧ください。1 つの API Key が 3 つのプロトコルで共通して使えます。