SillyTavern

SillyTavern では、SpicyAPI を 2 通りの方法で使えます。1 つ目は通常のチャット接続で、SillyTavern が Custom (OpenAI-compatible) ソース経由で、メッセージを SpicyAPI のチャットモデルに送ります。2 つ目は SpicyAPI 拡張機能で、/spicy-img と /spicy-video のコマンドと Animate ボタンを追加し、チャットを離れずに画像や短い動画を作れるようにします。

どちらか一方だけでも使えます。どちらも SpicyAPI のほかの機能と同じアカウント・残高・料金を使い、支払うのは実行した分だけです。拡張機能は無料のオープンソース（MIT）で、github.com/spicyapi-ai/sillytavern-spicyapi で公開しています。

始める前に

• SillyTavern 1.19.0 以降。 このページの手順は 2026-10-06 に 1.19.0 で確認しました。ほかのバージョンではメニューの表記が変わっている場合があります。
• SillyTavern を動かすマシンの git。 拡張機能を使う場合だけ必要です。SillyTavern は拡張機能のダウンロードに git を使います。
• API キー。 キーは sk-spicy- で始まります。キーに設定できる制限は認証を、アカウントがまだない場合はアカウントの準備を参照してください。
• 残高。 リクエストはすべて、前払いの米ドル残高から支払われます。課金を参照してください。

SillyTavern のチャットを SpicyAPI につなぐ

チャットのリクエストを送るのはブラウザーではなく SillyTavern のサーバーなので、手元でほかに設定することはありません。

チャットモデルを選ぶ

チャットモデルの ID は /chat で終わります。Available Models のドロップダウンには SpicyAPI の全モデル一覧が入るため、画像・動画・音声のモデルも表示されますが、それらではチャットできません。チャットモデルは先頭に並ぶので、リストの一番上から選ぶか、/chat で終わる ID を Enter a Model ID に入力または貼り付けてください。

すべてのチャットモデルと、それぞれが受け付ける内容を確認するには、サイトのチャットモデルを見るか、キーを付けて GET https://api.spicyapi.ai/v1/models を呼び出します（モデルを参照）。チャットモデルの各エントリには context_length、max_output_tokens、supported_parameters があります。

ロールプレイ向けには、ロールプレイのリーダーボードが、キャラクターの一貫性と表現の自由度でチャットモデルを順位づけしています。無制限のモデルもあればコンテンツをフィルタリングするモデルもあり、カタログには各モデルのポリシー区分が表示されます。

おすすめの設定

選んだモデルが対応していないサンプリング設定（temperature、top P、frequency penalty、presence penalty など）は、拒否されずに無視されます。無視した設定は、SpicyAPI がレスポンスヘッダー X-Spicy-Ignored-Params に一覧で返します。SillyTavern のスライダーはそのままで構いません。

Reasoning Effort

SillyTavern の Reasoning Effort ドロップダウンの値は、SpicyAPI のモデルには送られません。設定したい場合は自分で追加します。対象は、supported_parameters に reasoning_effort があるモデルだけです。

1. Connect ボタンの下にある Additional Parameters をクリックします。
2. Include Body Parameters に、たとえば次の 1 行を追加します。

reasoning_effort: low

指定できる値はモデルごとに異なります。モデルが用意していないレベルを指定すると、そのモデルにある最も近いレベルに変更され（レスポンスヘッダー X-Spicy-Adjusted-Params に名前が入ります）、推論レベルのないモデルではこの行は無視されます。まず、モデル一覧でそのモデルのエントリを確認してください。回答が空だったり途中で切れたりする場合は、Response (tokens) を増やすか、effort を下げてください。

チャット内の画像

Send inline media をオンにすると、SillyTavern はチャット内の画像を、以降のすべてのリクエストに添付します。画像を読めないモデルは 400 でリクエストを拒否し、画像がチャットに残っている限り、その後のメッセージもすべて失敗します。テキスト専用モデルでは Send inline media をオフにするか、画像を含むメッセージを非表示にしてください。

チャット内の動画は、モデルには送信されません。

モデルが拒否する設定

モデルが対応していない場合に、引き続き拒否される設定がいくつかあります。回答の微調整ではなく、回答そのものを変えてしまうためです。1 回の生成あたりの Multiple swipes が 1 を超える設定（n）、Logit Bias プリセット、Request token probabilities です。これらのいずれかを名指しするメッセージでリクエストが失敗した場合は、その設定をオフにしてください。エラーメッセージにフィールド名が出ます。

Custom Stopping Strings はどのモデルでも使えます。stop シーケンスのないモデル（たとえば Grok 系）では無視され、設定した数より少ない数しか受け付けないモデルでは、先頭から順に残されます。どちらになったかは、レスポンスヘッダー X-Spicy-Ignored-Params と X-Spicy-Adjusted-Params に出ます。スライダーの値がモデルの範囲を超えた場合（たとえば上限が 1 のモデルで temperature を 1.5 にした場合）も、同じように上限まで下げられます。

SpicyAPI 拡張機能

この拡張機能は、チャットの中から画像や短い動画を作ります。一度インストールしてキーを追加し、モデルを選べば使えます。

コマンド

コマンドに追加できる名前付き引数は次のとおりです。

• model=<id> は、今回の実行だけモデルを指定します。model= のあとに Tab キーを押すと一覧が出ます。
• edit=true は、プロンプトを入力済みでもプロンプトエディターを開きます。
• quiet=true は、結果を投稿せずに保存してそのパスを返します。Quick Replies や STscript 向けです。
• avatar=true または avatar=false（画像のみ）は、「キャラクターのアバターを使う」設定を上書きします。

/spicy-img a lighthouse on a cliff at dusk, wide shot
/spicy-video waves rolling onto a beach at sunrise
/spicy-video image=last slow push-in, hair moving in the wind

チャット入力欄の隣にある魔法の杖のメニューには、SpicyAPI picture、SpicyAPI video、SpicyAPI: animate last picture があります。

Animate

チャット内のすべての画像には、操作ボタンの中にフィルムのアイコンがあります。画像の付いたメッセージでは、... メニューにも同じアイコンがあります。これを押すと、画像から動画への変換用に選んだモデルでその画像を動画クリップにし、同じメッセージにクリップを追加します。

プロンプト

プロンプトを指定しない場合は、接続中のチャットモデルが現在の場面からプロンプトを書きます。Let me read and edit the prompt before generating がオン（既定）の場合は、モデル、正確な料金、書かれたプロンプトを表示するウィンドウが開きます。そのまま待つことも、自分で入力することも、Write from the scene をもう一度押すこともできます。この拡張機能にはプロンプト、プリセット、スタイルは含まれておらず、言葉はあなたかチャットモデルから出てきます。

参照画像を受け付けるモデルでは、キャラクターのアバターを使うことで、画像がそのキャラクターらしく仕上がります。

AI に画像を見せてもらう

既定ではオフです。SpicyAPI パネルの Let the AI show pictures をオンにしたうえで、チャットモデルが画像を求める方法を選びます。どちらか一方でも、両方でも使えます。

自動の画像には、後述の実行ごとの上限とは別に、専用の上限があります。

• チャットごとに数回の返信につき画像は最大 1 枚です（既定は 3 回）。拒否されたリクエストや失敗したリクエストでも、待機期間が始まります。
• このブラウザーでの自動画像の 1 日の上限です（既定は $0.50）。
• 確認金額を超える場合は、Ask me first（既定。説明文と料金を表示します）か Skip the picture のどちらかになります。

自動の実行で作られるのは画像だけで、動画は作られません。また、画像は他の結果と同様に AI からは見えません。ツールがオンの間は、その定義がすべてのチャットリクエストに付いて送信されるため、チャット API でトークンを少し消費します。詳しい動作は拡張機能の README を参照してください。

料金と上限

拡張機能は、実行のたびに SpicyAPI に見積もりを問い合わせ、米ドルで表示します。見積もりは無料です。

パネルには、このブラウザーのセッションで使った金額も表示されます。どこでも有効な厳格な上限が必要な場合は、キー自体に 1 日の支出上限を設定してください。認証を参照してください。

Stop waiting を押したりページを閉じたりしても、実行は SpicyAPI 上で続き、成功すれば課金されます。あとで /spicy-task <task id> で受け取れます。失敗した実行には課金されません。ただし、拒否されたリクエストにも課金されると、そのモデルのページに明記されている一部のモデルは例外です。課金を参照してください。

キーとファイルの保存先

• キーは、SillyTavern を動かすマシン上の SillyTavern の設定ファイル（data/<user>/settings.json の extension_settings.spicyapi）に、平文で保存されます。ほかの SillyTavern 拡張機能からも読み取れます。Connect chat を使うと、キーは Custom エンドポイントのキーとして、SillyTavern のシークレットファイルにも保存されます。そのため、支出上限を付けた専用キーを用意しておく価値があります。
• 結果はダウンロードされ、SillyTavern の画像フォルダー（data/<user>/user/images/<character>/spicyapi_<task id>.png または .mp4）に保存されたうえで、チャットに添付されます。新しい結果は既定で AI から見えない状態になるため、画像を読めないモデルに次のチャットリクエストで画像が送られることはありません。この動作を変えるには、Let the AI see generated pictures and videos をオンにします。
• 手元のマシンから外に出る情報は、プロンプト、モデルの設定、参照画像で、api.spicyapi.ai に送られます。チャットモデルがプロンプトを書く場合は、ほかのメッセージと同様に、チャットのコンテキストが SillyTavern の接続先のチャット API に送られます。
• SpicyAPI は、生成されたファイルを限られた期間だけ保持します。保持期間を参照してください。

生成の途中でチャットを切り替えた場合、結果は保存されますがチャットには追加されず、拡張機能が保存先を知らせます。

接続経路

既定では、拡張機能はブラウザーから https://api.spicyapi.ai に直接アクセスします。ネットワークやブラウザーがこれをブロックする場合は、パネルの Connection を開き、Auto（まず直接接続を試し、だめなら SillyTavern の CORS プロキシにフォールバック）または Through SillyTavern's CORS proxy を選びます。

プロキシは既定でオフです。オンにするには、SillyTavern の config.yaml で enableCorsProxy: true を設定する（または --corsProxy を付けて SillyTavern を起動する）ことを行い、再起動します。SillyTavern の基本認証（basicAuthMode）とは併用できません。基本認証は API キー付きのリクエストを拒否するためです。その場合は直接の経路を使ってください。

トラブルシューティング

SpicyAPI のエラーの末尾には、request_id またはタスク ID が付きます。サポートに連絡するときにそれを伝えれば、リクエストを正確に特定できます。エラーコードの意味はエラーで説明しています。