PandaNpc は、設定したプロバイダ接続とモデルエントリを保存します。まず、サービスから提供された API キー、ベース URL、プロトコル、モデル ID を使用します。エントリを追加しても、アップストリームアカウントが作成されたり、モデルアクセスが許可されたりするわけではありません。
プロバイダとモデルの違いについては、カスタムモデルリストの管理 を参照してください。
始める前に
プロバイダまたは自己ホスト型サービスで以下の項目を確認してください。
- API のベースアドレス（プロバイダのウェブサイトのアドレスではありません）
- 認証方法と必要な認証情報
- 使用予定の機能またはエンジンがサポートする API プロトコル
- アカウントが呼び出せる正確なモデル ID
- 手動で入力する予定がある場合は、コンテキストと出力の制限
認証情報はプロバイダフォームに保管し、プロンプト、スクリーンショット、共有メモには入れないでください。OpenAI 互換と宣伝されているサービスでも、ストリーミング、ツール呼び出し、画像サポートが異なる場合があります。
1. プロバイダを追加または設定する
モデル設定 を開きます。プロバイダを追加するか、既存のプリセットを設定するか、独立して編集可能な接続が必要な場合はプリセットをコピーします。
| フィールド | 入力する内容 |
|---|---|
| 表示名 | この接続のわかりやすい名前 |
| プロバイダ ID | プロバイダ設定の識別子 |
| API キー | サービスで必要な認証情報 |
| ベース URL | 選択した統合が想定する API ベースアドレス |
| プロトコル | アップストリーム API が実際に実装している形式 |
| シークレット、Organization、Project | サービスが明示的に要求する値のみ |
| コンテンツ配列のサポート | サービスが構造化メッセージコンテンツを受け入れるかどうか |
ベース URL の形式は、プロトコルとリクエストを送信する機能によって異なります。統合がすでにパスを追加する場合、完全な操作パスを追加しないでください。たとえば、/chat/completions を追加する統合では、そのパスで終わるアドレスではなく、対応するベースアドレスが必要です。この例をすべてのプロトコルに当てはめないでください。
保存済みの認証情報を編集する場合、API キーまたはシークレットを空白のままにすると、設定済みの値が保持されます。リストに表示されるマスクされた値は元のキーではないため、置き換えとして貼り戻さないでください。
2. モデルを追加する
プロバイダを保存し、それを選択して モデルの追加 を選びます。
| フィールド | 意味 |
|---|---|
| 表示名 | モデルリスト内でのラベル |
| モデル値 | 正確なアップストリームモデル ID |
| モデルタイプ | 設定フォーム内の該当カテゴリ |
| プロバイダ | このエントリが使用する接続 |
| コンテキストウィンドウ | 指定されている場合のドキュメント上のコンテキスト容量 |
| 最大トークン数 | 指定されている場合の出力制限 |
サービスのドキュメントまたはモデルリストに記載されている ID を使用してください。マーケティング名は必ずしも API 識別子ではありません。検証できない場合は、任意の制限を未設定のままにしてください。未設定は実際の制限が検出されたことを意味しません。利用する機能が独自のデフォルトを適用する場合があります。
3. 設定を検証する
これらの設定を使用する機能またはエンジンで、次の操作を行います。
- 新しいエントリを選択し、テスト会話を開始します。
Reply with: connectedのような短いリクエストを送信します。- 正常な応答と、利用可能な場合は、プロバイダの使用記録に一致するリクエストを確認します。
- フォローアップを送信して、会話が継続することを確認します。
- 作業で必要であれば、画像またはツール呼び出しを別途テストします。
レコードを保存しても接続テストにはなりません。テキスト応答があっても、すべての機能との互換性が確認されたわけではありません。モデルエントリを変更しても、既存の Claude Code または Codex プロセスが自動的に再設定されるわけではありません。PandaPaw を参照してください。
トラブルシューティング
認証に失敗する
キーが有効か、アカウントがモデルにアクセスできるか、サービスが追加の認証フィールドを必要とするかを確認してください。期限切れの認証情報は、プロバイダフォームから置き換えます。
エンドポイントまたはモデルが見つからない
ベース URL とモデル値の両方を確認してください。操作パスの重複、API プレフィックスの欠落、アカウントで利用できないモデル ID がないか確認します。同じエラーでもプロバイダによって原因が異なる場合があります。
ネットワークまたはブラウザのエラーが表示される
実際にリクエストを送信するデバイスからの接続を確認してください。ブラウザ発信のリクエストは CORS と HTTPS の制限を受けます。別のコンピュータからのリクエストが成功しても、ブラウザ経由が機能することを証明するものではありません。
ローカルモデルサーバーに到達できない
localhost はリクエストを送信するマシンを指します。リモートの PandaPaw コンピュータを自動的に指すわけではありません。利用する機能がどこで実行されるかを確認してから、ローカルサーバーのアドレスを選択してください。
テキストは動作するが、画像、ツール、長時間のセッションが失敗する
エンジン、API プロトコル、モデル機能の正確な組み合わせを確認してください。プロバイダがサポートする制限を使用し、必要な各入力タイプを検証します。コンテキストウィンドウを増やしたり、モデルタイプを変更したりしても、アップストリームの機能が追加されるわけではありません。
プラットフォームのメンバーシップとプロバイダの利用の違いについては、アカウントとモデルコスト を参照してください。