SillyTavern API設定: OpenAI互換で接続する手順
sillytavern api 設定で迷いやすい接続先、キー、モデル名、コンテキストの値を、確認用のコマンドと一緒に説明します。
更新日
ポイント
- 接続方式はChat Completionのカスタム(OpenAI互換)を選ぶ
- URLは https://api.mukenetsuapi.com/v1、モデル名は uncensored
- コンテキストは100,000まで可能だが、費用と速度のため絞るのが現実的
- 401は鍵、404はURL、429は同時実行か回数の超過を疑う

先に必要なものを3つ用意する
sillytavern api 設定は、手順自体は短く、つまずきの多くは入力する値の間違いです。先に次の3つを手元に置いてください。
- APIキー: APIキーの取得ページ で発行します。新規登録後に $0.50 の試用クレジットをワンクリックで受け取れます。
- ベースURL:
https://api.mukenetsuapi.com/v1 - モデル名:
uncensored
SillyTavern は、OpenAI互換のエンドポイントを追加できるフロントエンドです。このAPIはOpenAI互換なので、公式のOpenAIを選ぶ必要はなく、カスタムのエンドポイントとして登録できます。
接続手順
メニューの文言はバージョンで変わることがあります。ここでは一般的な流れを書きます。違う場合は SillyTavern 自身のドキュメントも合わせて見てください。
- 上部の「API Connections」(プラグのアイコン)を開く。
- API の種類として「Chat Completion」を選ぶ。
- ソースの一覧から、OpenAI互換のカスタム接続(Custom)を選ぶ。
- エンドポイントのURLに
https://api.mukenetsuapi.com/v1を入れる。末尾に/chat/completionsは付けません。 - APIキーの欄に、発行したキーを貼る。前後の空白が入らないようにする。
- モデル名を
uncensoredにする。一覧から選べる場合は選び、手入力の場合はそのまま打つ。 - 接続ボタンを押し、成功の表示が出るか確認する。
接続前に、ターミナルでキーとURLが正しいか確かめておくと、原因の切り分けが楽です。
curl https://api.mukenetsuapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "messages": [{"role": "user", "content": "こんにちは"}], "max_tokens": 50}'応答が返れば、キー、URL、モデル名は正しいです。この状態で SillyTavern が失敗するなら、アプリ側の入力を疑えます。
コンテキストと応答の長さを決める
このAPIの文脈は、プロンプトと出力を合わせて100,000トークンまで使えます。ただし、SillyTavern のコンテキストサイズを最大にするのはおすすめしません。毎回、キャラクター設定、世界観、履歴を送り直すため、値が大きいほど1回あたりの入力が増えるからです。
費用の計算例
コンテキストを 16,000 トークンまで使い、返答が 300 トークンの場合、1メッセージあたりの費用は次のとおりです。
- 入力: 16,000 ÷ 1,000,000 × $0.15 = $0.0024
- 出力: 300 ÷ 1,000,000 × $0.50 = $0.00015
- 合計: $0.00255
100メッセージで $0.255 です。コンテキストを 8,000 に半分にすれば、入力側は約半分になります。単価の詳細は 料金ページ を見てください。
目安
長い物語や多人数のシーンでなければ、まず 8,000 から 16,000 あたりで始め、キャラが過去の出来事を忘れると感じたら増やす、という順序が現実的です。応答の最大長は、1回の返答として読みたい長さに合わせます。max_tokens は省略可能ですが、長すぎる返答を避けたいときは SillyTavern 側で上限を決めておくと安心です。
サンプリング設定の考え方
temperature、top_p、stop、seed、各種ペナルティは、APIにそのまま渡されます。SillyTavern のプリセットで調整できます。
- 同じ言い回しが続く: frequency や presence のペナルティを少し上げる。
- 返答が散漫: temperature を下げる。
- 単調: temperature を少し上げる。
- 比較したい: seed を固定して、1つずつ値を変える。
プリセットの項目名は SillyTavern のバージョンで違います。設定が反映されない場合は、使っている接続方式がその項目に対応しているか、SillyTavern のドキュメントで確認してください。
よくあるエラーと対処
| 症状 | 原因の候補 | 対処 |
|---|---|---|
| 401 | キーが違う、空白が混ざった | キーを貼り直し、curl で同じキーを試す。 |
| 404 | URLが違う | 末尾が /v1 で止まっているか確認する。 |
| モデルが見つからない | モデル名の綴り | uncensored と小文字で入れる。 |
429(concurrency) | 同時リクエストが多すぎる | スワイプの連打やグループチャットの同時生成を減らす。 |
429(rate_limited) | 毎分の回数超過 | 少し待つ。 |
429(Retry-After: 5 付き) | 一時的な混雑 | 5秒待って再試行する。 |
フルキーの上限は同時8、毎分300、試用キーは同時2、毎分60です。ストリーミングの返答は、終わるまで同時接続の枠を1つ使います。試用キーでグループチャットを動かすと、すぐに枠が埋まります。
残高が足りているかは、次のコマンドで確認できます。
curl https://api.mukenetsuapi.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"レスポンスヘッダーの X-Balance-USD からも読めます。モデル一覧の確認は GET /v1/models です。
curl https://api.mukenetsuapi.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"利用上の注意
このAPIはテキスト専用です。SillyTavern の画像生成や音声の機能を使う場合は、別のサービスが必要になります。内容は、合法な成人向け利用の範囲で、小説、ロールプレイ、コンパニオンアプリのようなフィクションを想定しています。未成年者が関わる性的な内容は、どの設定でも書かせられません。プロンプトはモデルの学習には使われません。
より詳しいパラメーターは ドキュメント に、支払いはUSDT(TRC20)またはUSDC(Base)で $20 から $500 の整数額です。
その他のガイド
よくある質問
SillyTavernで使うモデル名は何ですか。
uncensored です。小文字で、そのまま入力してください。
URLの末尾に /chat/completions は必要ですか。
不要です。ベースURLは /v1 までで、残りのパスはアプリ側が付け足します。
試用キーで足りますか。
接続の確認や短い会話には十分です。ただし試用キーは同時2、毎分60に制限され、有効期間は7日間なので、グループチャットを使うなら通常のキーにチャージしてください。
画像も生成できますか。
できません。このAPIはテキスト専用で、画像、音声、動画の生成には対応していません。
コンテキストはいくつにすればいいですか。
最大は100,000トークンですが、まず 8,000 から 16,000 あたりで試すのが現実的です。大きいほど毎回の入力が増えて費用がかさみます。
APIキーはフォーム1つで入手可能
アカウント作成、キーのコピー、ベースURLの変更。これだけですべて設定完了です。