SillyTavern に TavernAPI を接続する方法

SillyTavern に TavernAPI を接続するには、SillyTavern の API Connections(API接続)パネルを開き、Chat Completion → Custom (OpenAI-compatible) を選択して https://tavernapi.com/v1 と API キーを貼り付け、「Connect」をクリックしてモデル ID を選びます。調整済みの物語ルールを使いたい場合は、あわせてプリセット JSON をインポートしてください。

カスタムエンドポイント (Base URL)
https://tavernapi.com/v1
API キーの形式
sk-tav-...
  1. ステップ 1:TavernAPI コンソールで API キーを作成する

    メールアドレス、Google、または Discord で TavernAPI コンソールにログインします。メール認証を完了して $0.30 の無料トライアルクレジット(Gemini 4 Argon と Gemini 3.8 Flash で利用可能)を受け取ったら、左メニューの「API keys」タブを開き、「Create API key」をクリックします。表示された sk-tav-... キーは一度しか表示されないため、すぐにコピーして控えてください。

  2. ステップ 2:SillyTavern を Custom (OpenAI-compatible) に設定する

    SillyTavern を開き、画面上部のプラグアイコン(API Connections)をクリックして、以下の通りに設定します:

    • API:Chat Completion
    • Chat Completion Source:Custom (OpenAI-compatible)
    • Custom Endpoint (Base URL):https://tavernapi.com/v1
    • Custom API Key:コピーした sk-tav-... キーを貼り付け
  3. ステップ 3:接続してモデル ID を選択する

    「Connect」をクリックすると、利用可能なモデル一覧が自動的に読み込まれます。「Available Models」のドロップダウンを開き、標準のモデル ID を選択してください。大多数のプレイヤーにまずおすすめの gemini-4-argon、場面の論理性やキャラクター理解が最高峰の claude-opus-5.5 のほか、gemini-3.8-flash、deepseek-v4-pro、claude-sonnet-5.5 から選べます。

  4. ステップ 4:TavernAPI プリセットをインポートする(または自作プリセットを使う)

    サーバーロック型のロールプレイ用プリセットを使う場合は、TavernAPI コンソールの「Presets」タブからプリセット JSON をダウンロードし、SillyTavern 左端のスライダーアイコン(AI Response Configuration)を開いて「Import preset」をクリックします。文字数、出力言語、ユーザーの言動の乗っ取り防止ルールなどの平文エントリは手元で自由にオン・オフや編集ができ、ロックされたコアブロック([[tav:pack/block]])はサーバー側で自動展開されます。手元の自作プリセットを使いたい場合は、そのままお使いのプリセットを選択しておくだけで構いません(通常接続でも自動プロンプトキャッシュは有効になります)。

よくあるエラーコードと対処法

401 Unauthorized

API キーが未入力、入力ミス、または失効しています。

Custom API Key 欄に余分なスペースなしで sk-tav-... キー全体が貼り付けられているか確認するか、コンソールで新しいキーを発行してください。

402 Insufficient Balance

アカウント残高が、そのリクエストの推定最大コストを下回っています。

コンソールで残高をチャージするか、30 日間クレジットパックの購入・引き換えコードの使用を行ってください。また、SillyTavern の「Max Response Length(max_tokens)」が極端に大きく設定されている場合は、数値を下げると仮押さえ額を減らせます。

403 Forbidden (Trial or Locked Preset)

無料トライアルクレジットで対象外のモデル(トライアル対象は gemini-4-argon と gemini-3.8-flash のみ)を呼び出しているか、まだアカウントで解放されていない [[tav:pack/block]] パックが SillyTavern のプリセットに含まれています。

トライアル中はモデルを gemini-4-argon または gemini-3.8-flash に切り替え、有料プリセットパックをオフにしてください。Standard プリセットは初回 $5 以上のチャージで解放され、Pro プリセットは $4.99 での単体購入、$19 / $39 クレジットパックの有効化、または累計 $25 の決済達成で解放されます。

429 Too Many Requests / Upstream Busy

短時間にリクエストを送りすぎたか、ストリーミング開始前に上流ルートが一時的に混雑しています。

数秒待ってからスワイプ(再生成)してください。返信の生成が始まる前に上流でエラーになった場合、残高は一切消費されません。