PandaNpc 會儲存您設定的供應商連線與模型條目。請先取得服務提供者提供的 API Key、Base URL、協定與模型 ID。新增條目並不會建立上游帳戶，也不會賦予模型存取權限。
如需區分供應商與模型，請參閱管理您的自訂模型清單。
開始之前
請與您的供應商或自架服務確認下列事項：
- API 基地位址，而非供應商網站位址。
- 驗證方式及任何必填憑證。
- 您預計使用的功能或引擎所支援的 API 協定。
- 您的帳戶可以呼叫的確切模型 ID。
- 如果您打算手動輸入，請確認上下文長度與輸出限制。
請將憑證存放在供應商表單中，不要放在提示、螢幕擷圖或共享筆記中。標榜與 OpenAI 相容的服務，在串流、工具呼叫或影像支援方面仍可能有所差異。
1. 新增或設定供應商
開啟模型設定。新增供應商、設定既有預設，或當您需要可獨立編輯的連線時複製預設。
| 欄位 | 輸入內容 |
|---|---|
| 顯示名稱 | 此連線的辨識名稱 |
| 供應商 ID | 供應商設定的識別碼 |
| API Key | 服務所需的憑證 |
| Base URL | 所選整合預期的 API 基地位址 |
| 協定 | 上游 API 實際實作的格式 |
| Secret、Organization、Project | 僅填寫服務明確要求的數值 |
| 支援內容陣列 | 服務是否接受結構化訊息內容 |
Base URL 的格式取決於協定以及發出請求的功能。如果整合本身已附加完整操作路徑，請不要再加上。例如，會附加 /chat/completions 的整合需要對應的基地位址，而不是已以此路徑結尾的位址。請勿將此範例套用至所有協定。
編輯已儲存的憑證時，將 API Key 或 Secret 留空會保留原本設定的值。清單中顯示的遮蔽值不是原始金鑰，也不應貼回去做為取代值。
2. 新增模型
儲存供應商、選取該供應商，然後選擇新增模型。
| 欄位 | 意義 |
|---|---|
| 顯示名稱 | 您為模型清單指定的標籤 |
| 模型值 | 確切的上游模型 ID |
| 模型類型 | 設定表單中適用的類別 |
| 供應商 | 此條目使用的連線 |
| 上下文視窗 | 有明文指定時的上下文容量 |
| Max Tokens | 有明文指定時的輸出限制 |
請使用服務文件或模型清單中的 ID。行銷名稱不一定是 API 識別碼。若您無法驗證選擇性限制，請將其留空；留空不代表已偵測到真實限制。使用該設定的功能可能會套用其自身的預設值。
3. 驗證設定
在會使用這些設定的功能或引擎中：
- 選取新條目並開始測試對話。
- 傳送簡短請求，例如
Reply with: connected。 - 確認回應正常，並在可用的情況下，於供應商的使用紀錄中看到對應請求。
- 傳送後續訊息以檢查連續對話。
- 如果您的工作需要，請另外測試影像或工具呼叫。
儲存紀錄並非連線測試。文字回應無法證明與所有功能相容。變更模型條目也不會自動重新設定既有的 Claude Code 或 Codex 程序；請參閱 PandaPaw。
疑難排解
驗證失敗
請檢查金鑰是否有效、帳戶是否能存取模型，以及服務是否要求額外的驗證欄位。請透過供應商表單取代已過期的憑證。
找不到端點或模型
請檢查 Base URL 與模型值。找出重複的操作路徑、缺少的 API 前綴，或您的帳戶無法使用的模型 ID。相同的錯誤在不同供應商之間可能原因不同。
出現網路或瀏覽器錯誤
請從實際發出請求的裝置檢查連線能力。源自瀏覽器的請求會受到 CORS 與 HTTPS 限制；從另一台電腦成功發出請求，並不能證明瀏覽器路徑可用。
無法連線到本機模型伺服器
localhost 指發出請求的機器。它不會自動指向您的遠端 PandaPaw 電腦。請先確認使用該功能的位置，再選擇本機伺服器的位址。
文字正常，但影像、工具或長時間工作階段失敗
請檢查引擎、API 協定與模型能力的確切組合。使用供應商支援的限制，並驗證每種必要的輸入類型。提高上下文視窗或變更模型類型不會新增上游能力。
如需平台成員資格與供應商使用的差異，請參閱帳戶與模型成本。