JA ▾
APIキーを取得

SillyTavern API設定: OpenAI互換で接続する手順

sillytavern api 設定で迷いやすい接続先、キー、モデル名、コンテキストの値を、確認用のコマンドと一緒に説明します。

更新日

ポイント

  • 接続方式はChat Completionのカスタム(OpenAI互換)を選ぶ
  • URLは https://api.mukenetsuapi.com/v1、モデル名は uncensored
  • コンテキストは100,000まで可能だが、費用と速度のため絞るのが現実的
  • 401は鍵、404はURL、429は同時実行か回数の超過を疑う
舞台の仮面とサーバーのプラグを光るケーブルでつなぐ、SillyTavernのAPI接続のイメージ

先に必要なものを3つ用意する

sillytavern api 設定は、手順自体は短く、つまずきの多くは入力する値の間違いです。先に次の3つを手元に置いてください。

  • APIキー: APIキーの取得ページ で発行します。新規登録後に $0.50 の試用クレジットをワンクリックで受け取れます。
  • ベースURL: https://api.mukenetsuapi.com/v1
  • モデル名: uncensored

SillyTavern は、OpenAI互換のエンドポイントを追加できるフロントエンドです。このAPIはOpenAI互換なので、公式のOpenAIを選ぶ必要はなく、カスタムのエンドポイントとして登録できます。

接続手順

メニューの文言はバージョンで変わることがあります。ここでは一般的な流れを書きます。違う場合は SillyTavern 自身のドキュメントも合わせて見てください。

  1. 上部の「API Connections」(プラグのアイコン)を開く。
  2. API の種類として「Chat Completion」を選ぶ。
  3. ソースの一覧から、OpenAI互換のカスタム接続(Custom)を選ぶ。
  4. エンドポイントのURLに https://api.mukenetsuapi.com/v1 を入れる。末尾に /chat/completions は付けません。
  5. APIキーの欄に、発行したキーを貼る。前後の空白が入らないようにする。
  6. モデル名を uncensored にする。一覧から選べる場合は選び、手入力の場合はそのまま打つ。
  7. 接続ボタンを押し、成功の表示が出るか確認する。

接続前に、ターミナルでキーと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 で同じキーを試す。
404URLが違う末尾が /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の変更。これだけですべて設定完了です。

APIキーを取得