JA ▾
API キーを取得

Janitor AI 用 OpenRouter 代替え:セットアップガイド

カスタム OpenAI 互換 API を受け付けるキャラクターチャットフロントエンドは、URL、キー、モデル名の 3 つの値を使用してこのエンドポイントと通信できます。以下に正確なセットアップ、初期システムプロンプト、計画に必要な制限を示します。

更新日:

発光するチャットバブルとマスク、ケーブルで接続された小型サーバーキューブ

主要ポイント

  1. ベース URL https://api.openrouterapi.cc/v1、キー、モデル ID uncensored を入力します。
  2. まず curl でテストし、問題がキーにあるのかクライアントにあるのかを確認してください。
  3. 30,000トークンのロールプレイ履歴の場合、1回の返信コストは約$0.0047、100回の返信で約$0.47になります。
  4. このモデルはテキスト専用で、100,000 トークンのコンテキストウィンドウを持っています。

無料トライアルクレジットで始める

メールアドレスとパスワードだけで、キーがすぐ画面に表示されます。

API キーを取得

入力する必要があるもの

Janitor AI や類似のキャラクターチャットアプリの OpenRouter 代替えを使用する場合、セットアップは OpenAI 互換プロバイダーと同じです。クライアントでカスタムまたはプロキシ API を追加する場所を見つけてください。異なるアプリでは「プロキシ」「カスタム OpenAI エンドポイント」「API URL」などと呼ばれますが、以下の 3 つのフィールドは常に同じです。

フィールド内容
API URL / ベース URLhttps://api.openrouterapi.cc/v1
API キーアカウントから取得したキーは、Authorization: Bearerとして送信されます。
モデル名uncensored

一部のクライアントはベースURLではなく完全なエンドポイントを必要とします。ベースURLを保存するとエラーや404が発生する場合は、https://api.openrouterapi.cc/v1/chat/completionsを試してください。サポートされているメソッドは2つあり、POST /v1/chat/completionsとGET /v1/modelsです。モデル一覧を取得するクライアントは後者を呼び出し、uncensoredを確認できます。

まだキーをお持ちでない場合は、Google またはメールアドレスとパスワードでサインアップし、API キーの手順に従ってください。新規アカウントではワンクリックで $0.50 の試用クレジットを取得でき、最初のテストセッションには十分です。

アプリのせいにする前に接続をテスト

ロールプレイフロントエンドは生のエラーテキストを隠します。ターミナルから 1 回リクエストを実行し、キーとモデルが機能することを確認してください。プレースホルダーをご自身のキーに置き換えてください。

curl https://api.openrouterapi.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer."},
      {"role": "user", "content": "The reactor is humming wrong again."}
    ],
    "temperature": 0.9,
    "max_tokens": 200
  }'

返信が返ってきた場合、エンドポイントとキーは正常であり、問題はアプリの設定にあります。失敗した場合、エラーボディに理由が記載されます。X-Request-Idレスポンスヘッダーからリクエスト ID を保持してください。これは サポートに連絡する際に役立ちます。

初期システムプロンプト

フロントエンドのキャラクターカードは通常、システムメッセージになります。アプリの機能やロジックがどうであれ、モデルは以下のようなテキストを受信します。このモデルは、法的な成人利用に対してコンテンツ拒否なしで回答するようにチューニングされているため、プロンプトでモデルと議論する必要はありません。声、境界線、形式を明確にすれば十分です。

あなたは貨物船カローウェイの首席技師、マラ・ヴォスです。

声:ドライで実用的、ストレス下ですぐにジョークを言う。

三人称過去形で、2〜4 段落の短い文章で記述する。

ユーザーのキャラクターの発言や行動を決して行わないでください。

継続性を保つ:怪我、修理、誰が何を知っているかを追跡する。

物語に没頭する。すべてのキャラクターは成人です。

長時間のセッションでは 2 つの習慣が改善に役立ちます。まず、システムプロンプトを短く保つことです。なぜなら、それはすべてのターンで再送信されるからです。次に、重要なルールをプロンプトの途中ではなく最後に配置してください。チャットの履歴が長くなっても、ルールが目立つようにするためです。アプリに「著者の注釈」や最新メッセージの近くに挿入されるリマインダーを追加できる場合は、スタイルルールにそれを使用してください。

このサービスとプロンプトで固定されているルールは1つあります。それは未成年者が関与する性的コンテンツの禁止です。これをキャラクターカードに書き込むことで、自分自身のカードもクリーンに保つことができます。

通常機能する設定

これらは保証付きの設定ではなく、開始点です。一度に 1 つずつ変更し、いくつかの返信を比較してください。

  • Temperature 0.8〜1.0 で生き生きとした対話を実現します。キャラクターが逸脱したり自己矛盾したりする場合は、0.6程度まで下げてください。
  • top_p 0.9 から 0.95:クライアントで表示される場合。これはそのまま渡されます。
  • 頻度ペナルティと存在ペナルティ 0.2 から 0.5:返信でフレーズの繰り返しが始まった場合。大きな値は文章を奇妙にするため、低く保ってください。
  • max_tokens はオプションです。エッセイではなく段落長の返信にしたい場合は、300 から 600 に設定してください。
  • ストリーミングをオンにする:返信は書かれながら表示され、最終チャンクには使用状況が含まれるため、クライアントでトークン数を表示できます。
  • seed はそのまま渡されるため、同じロール(生成インスタンス)で2つのプロンプトバージョンを比較したい場合に便利です。

ストリーミングには知っておくべき副作用が 1 つあります。ストリーミングリクエストは、ストリーミングが終了するまで同時実行数の枠を保持します。フルキーでは同時に 8 リクエスト、1 分あたり 300 リクエストまで許可されます。試用キーでは同時に 2 リクエスト、1 分あたり 60 リクエストまでです。

コンテキスト、メモリ、長時間のチャットの費用

コンテキストウィンドウは 100,000 トークンで、プロンプトと補完の合計です。これは非常に多くのストーリーを意味します:何万語もの履歴が収まる可能性があります。コストはそれに比例して増加します。なぜなら、履歴全体が毎回送信されるからです。以下に長時間セッションの計算例を示します。

履歴が 30,000 トークンに成長し、返信が 300 トークンであると仮定します。入力:30,000 x $0.15 / 1M = $0.0045。出力:300 x $0.50 / 1M = $0.00015。1 回の返信で $0.00465 かかります。そのサイズの 100 回の返信で $0.465、つまり約 47 セントになります。

短い履歴の方が安上がりで、しばしば効果的です。モデルは非常に長いプロンプトの中間部には注意を払わないため、古いイベントのクリーンな要約と最後の12メッセージのみを組み合わせると、30,000 の生トークンよりも一貫して読みやすくなります。多くのフロントエンドには要約または「メモリ」機能があります。チャットが数千トークンを過ぎたらそれを使用してください。

価格は入力 1M トークンあたり $0.15、出力 1M トークンあたり $0.50 です。失敗または拒否されたリクエストは課金されず、クレジットは期限切れになりません。トップアップ額、ボーナス、カードや暗号資産を含む支払い方法については、料金ページをご覧ください。

数週間にわたるキャラクターの一貫性を維持する

長時間のキャラクターは逸脱することがあります。主な解決策は記録管理であり、適切に行えばトークンコストは非常に少なくなります。

変更されない事実の固定ブロックを保持してください:名前、性格、話し方の癖、人間関係。また、定期的に手動で更新する 2 番目のブロックも保持してください:現在の状況、進行中のプロットスレッド、約束されたこと。これら 2 つをシステムプロンプトまたはクライアントのメモリフィールドに貼り付け、それぞれを約 500 トークン以下に保ってください。合計で最大 1,000 トークンとなり、入力レートで 1 回の返信あたり $0.00015 かかります。

その後、ライブチャットには最近のやり取りのみを持たせます。シーンが終了したら、2〜3 文の要約を 2 番目のブロックに書き込み、古いメッセージをクリアしてください。キャラクターは鋭さを保ち、返信は読みやすくなり、1 回の返信あたりのコストはセッションごとに上昇するのではなく、1 セントの 10 分の 1 程度に留まります。

1 つのチャットで複数のキャラクターを操作する場合は、誰がいつ話すかを明確にしてください。「ユーザーが別のキャラクターを要求しない限り、マラのセリフのみを書く」といった行は、モデルがすべてのキャラクターを同時に叙述するのを防ぎ、返信を短く安く保つのに役立ちます。

429 エラーと奇妙な返信のトラブルシューティング

ロールプレイアプリは、誤ってレート制限に引っかかることがよくあります。ブラウザのタブが2つ開いている、「再生成」ボタンを2回押す、複数のキャラクターが同時に返信するグループチャットなどです。APIはHTTP 429とこれらの原因のいずれかを返します。

  1. エラーコード concurrency。 キーの制限を超えた同時リクエストが発生しています。余分なタブを閉じ、ストリームの終了を待つか、キャラクターの並列返信をオフにしてください。ストリームは終了するまで枠を占有することを覚えておいてください。
  2. エラーコード rate_limited。 1分あたりのリクエストが多すぎます。速度を落としてください。人が入力する場合は1分あたり300件に達することはほとんどありませんが、自動化されたスワイプループでは、トライアルキーで1分あたり60件に達する可能性があります。
  3. Retry-After: 5 ヘッダー付きの429。 サービスが一時的に過負荷状態です。5秒待ってから再度送信してください。

返信が途中で切れる場合は、クライアントのmax_tokens設定を確認してください。キャラクターがあなたの代わりに話している場合は、システムプロンプトのルールを強化し、温度を下げてください。アプリでモデルが見つからないと言われる場合は、モデルフィールドが正確にuncensored(小文字)であることを確認してください。

これが適している場合と適していない場合

エンドポイントを選択できるクライアントで、フラットなトークン単価の単一モデルを求めている場合、これは置き換えとして機能します。チャット中に複数のモデルを切り替えたい場合は、ルーターの置き換えにはなりません。公式のモデルベンダーではなく、独立したプロバイダーからの単一モデルが提供されます。

このモデルはテキストのみです。キャラクターアート、音声、動画は生成されず、埋め込みも利用できません。クライアントでそれらに依存しているものは、別のサービスが必要です。プロンプトはトレーニングに使用されず、クイックスタートはdocsにあります。

質問と回答

Janitor AIスタイルの設定でどのモデル名を入力すればよいですか?

モデルフィールドには小文字の uncensored を入力します。URL には https://api.openrouterapi.cc/v1 を、キーには自分のキーを使用してください。

チャット中に429エラーが発生するのはなぜですか?

同時に開いているリクエストが多すぎる(同時実行数)か、1分あたりのリクエストが多すぎます(レート制限)。余分なタブを閉じ、ストリーミングが終了するまで待ちます。トライアルキーでは同時に2件まで許可されています。

このモデルはキャラクターの画像を生成できますか?

いいえ。画像、音声、動画の生成がないテキスト専用モデルです。

ロールプレイセッションの料金はどのくらいですか?

30,000トークンの履歴と300トークンの返信の場合、1回の返信には約$0.0047かかり、100回の返信には約47セントかかります。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得