主要ポイント
- Chat Completionを使用し、ソースはCustom (OpenAI-compatible)、エンドポイントはhttps://api.ornith.top/v1、モデルIDはuncensoredに設定します。
- まずcurlでキーをテストし、キーの問題かSillyTavernの設定の問題かを判別してください。
- チャットに合わせてコンテキストサイズを設定します。モデルは最大100,000トークンをサポートしています。
- グループチャットでは複数のリクエストが同時に発生するため、トライアルキーでは同時実行数が2に制限されます。
開始前に必要なもの
必要なものは3つ:稼働中のSillyTavernインストール、APIキー、エンドポイント情報です。SillyTavernはキャラクターやロールプレイ会話用の自己ホスト型チャットフロントエンドであり、OpenAIチャット形式に従うあらゆるサービスと連携できます。本サイトは合法的な成人向け用途(フィクション、ロールプレイ、成人向けコンパニオンアプリ)のためにそのようなサービスを提供しています。未成年者を含む性的コンテンツは生成せず、設定変更でも変わりません。
これらの値を収集してください:
- ベースURL:
https://api.ornith.top/v1 - モデルID:
uncensored - APIキー:Googleまたはメールアドレスとパスワードでサインイン後、APIキーページで作成します。
新規アカウントは、そのページでワンクリックでトライアルクレジット$0.50を請求できます。カードは不要で、1人1回限りの制限があり、7日間有効です。これはキャラクターカードのテストには十分です。通常のチャット1ターンあたりのコストは1セント未満です(計算は後述)。
まず curl でキーをテスト
SillyTavernをいじる前に、ターミナルから1回リクエストを送信してください。成功すれば、その後の失敗はフロントエンドの設定問題です。失敗すれば、キーかネットワークに問題があります。
curl https://api.ornith.top/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one short sentence."}]
}'
choices配列を含むJSONが返されるはずです。レスポンスヘッダーも確認してください:X-Balance-USDは残高クレジットを示し、X-Request-Idはサポートに連絡する際に引用するIDです。また、GET /v1/modelsでモデル一覧を取得できます:
curl https://api.ornith.top/v1/models \
-H "Authorization: Bearer $API_KEY"
一覧にはSillyTavernで使用するべきモデルIDが表示され、それはuncensoredです。
SillyTavernをステップバイステップで接続
- SillyTavernを開き、上部のプラグアイコンをクリックしてAPI Connectionsを開きます。
- APIドロップダウンでChat Completionを選択します。
- Chat Completion SourceドロップダウンでCustom (OpenAI-compatible)を選択してください。
- Custom Endpoint (Base URL)に
https://api.ornith.top/v1を入力します。/v1までで止めてください。クライアントアプリがパスを自動付加するため、/chat/completionsは追加しないでください。 - API キーをCustom API Keyフィールドに貼り付けてください。
- Model IDに
uncensoredと入力してください。 - 接続 を押します。モデル名付きの緑色のステータスは、ハンドシェイクが成功したことを意味します。
SillyTavernのバージョン間でメニューラベルが少し異なるため、名前が異なる場合は、同じ意味のものを探してください:カスタムOpenAI互換ソース、エンドポイントフィールド、キーフィールド、モデルフィールドです。接続に失敗した場合は、curlテストを繰り返してください。curlからの認証エラーはキーが間違っていることを意味します。curlは成功するが接続に失敗する場合は、通常はURLの誤字(例えば/v1の欠落や末尾のパス)を意味します。
接続が完了したら、任意のキャラクターカードを開いてメッセージを送信します。返信が表示されれば、統合は成功しています。あとは調整です。
ロールプレイに重要な設定
コンテキストウィンドウのサイズ
モデルはプロンプトと返信を合わせて100,000トークンのコンテキストウィンドウを持っています。SillyTavernでは、コンテキストサイズスライダーが各ターンで送信される履歴、キャラクターカード、lorebookテキストの量を制御します。値を大きくするとキャラクターの記憶保持量が増えますが、各ターンで入力トークンに対して課金されるためコストが増加します。良いスタートポイントは16,000〜32,000トークン程度の適度な値で、チャットが長すぎる場合にのみ引き上げます。返信長設定はmax_tokensにマッピングされ、このAPIではオプションです。短い返信を望む場合は値を設定してください。
ストリーミング
Chat Completion設定でストリーミングを有効にします。APIはstream: trueでSSEをサポートしており、テキストは生成されながら表示され、悪い返信を早期に停止できます。使用量はストリームの終了時に報告されます。
サンプリング
Temperature、top_p、停止シーケンス、シード、頻度ペナルティ、存在度ペナルティはモデルに渡されます。クリエイティブなチャットでは、Temperatureを0.8〜1.0、top_pを0.9付近に設定するのが一般的な開始点です。返信が長くなりすぎたり繰り返したりする場合は、Temperatureを少し下げて、小さな頻度ペナルティを追加してください。効果を明確にするため、一度に1つの設定だけ変更してください。
システムプロンプトとキャラクターカード
モデルはコンテンツ拒否なしで応答するようにチューニングされているため、シーンの品質はプロンプトとキャラクターカードの品質に依存します。明確な役割、設定、トーン、およびいくつかの会話例は、サンプリング調整よりも効果的です。成人向けに書く場合は、設定に年齢を明確に明記してください。すべてのキャラクターは成人です。
メッセージ単位の費用計算
料金は前払いクレジットから、入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50で、サブスクリプションはありません。SillyTavernは各ターンでカードと履歴を再送信するため、入力がコストの大部分を占めます。
チャットターンで6,000トークンのコンテキストを送信し、400トークンの返信を受け取ると仮定します:
- 入力:6,000トークン、1Mあたり$0.15で$0.0009。
- 出力:400トークン、1Mあたり$0.50で$0.0002。
- 合計:1ターンあたり$0.0011。
200ターンのセッションには$0.22かかります。$0.50のトライアルクレジットは、約450回のそのようなターンをカバーできます。失敗または拒否されたリクエストは課金されません。クレジットを追加する際、$20から$500までの任意の整数ドル額が使用できます。$50以上で+5%、$100以上で+10%、$200以上で+15%のボーナスが付与されます。カード(Visa、Mastercard、Apple Pay、Google Pay)または暗号資産(TRC20上のUSDT、Base上のUSDC)で支払い可能です。クレジットは期限切れになりません。詳細は料金ページをご覧ください。
よくあるエラーの修正
| 症状 | 考えられる原因 | 修正方法 |
|---|---|---|
| 接続がすぐに失敗する | ベースURLまたはキーが間違っている | 末尾のパスなしでhttps://api.ornith.top/v1を使用し、curlテストを繰り返す |
HTTP 429、コード rate_limited | 1分あたりのリクエスト数が多すぎる | リクエスト速度を落としてください。トライアルキーは1分あたり60件、フルキーは300件まで許可されます |
HTTP 429、コード concurrency | 一度にリクエストが多すぎる | 実行中の返信の終了を待ちます。トライアルキーは同時2件、フルキーは同時8件まで許可されます |
HTTP 429、Retry-After: 5 | 一時的な過負荷 | 5秒後に再試行 |
| リクエストが大きすぎます | 本文が8 MBを超えています | コンテキストウィンドウを小さくするか、ロアブックを短くする |
| コンテキストが長すぎる | プロンプトと返信の合計が100,000トークンを超える | コンテキストサイズまたは返信長を下げる |
グループチャットや追加のバックグラウンド呼び出しを実行する機能で注意すべき点があります:ストリーミングリクエストはストリーミングが終了するまで同時実行数のスロットを保持します。SillyTavernが返信、要約、画像キャプション処理を同時に実行した場合、2スロットのトライアルキーでは3つ目が拒否されます。フルキーでは8まで許可されます。不要な機能を無効にするか、間隔を空けて実行してください。
すべてのパラメータと正確なエラー形式については、APIドキュメントをお読みください。
