PandaNpc 会存储你配置的提供商连接和模型条目。从服务提供的 API Key、Base URL、协议和模型 ID 开始。添加条目不会创建上游账户，也不会授予模型访问权限。
关于提供商与模型之间的区别，请阅读 管理自定义模型列表。
开始之前
请与你的提供商或自托管服务确认以下内容：
- API 基础地址，而不是提供商的网站地址。
- 身份验证方法以及任何必需的凭据。
- 你打算使用的功能或引擎所支持的 API 协议。
- 你的账户可以调用的确切模型 ID。
- 如果你计划手动输入，请同时确认上下文和输出限制。
将凭据保存在提供商表单中，不要放在提示词、截图或共享笔记中。一个标榜为 OpenAI 兼容的服务，其流式传输、工具调用或图像支持仍可能存在差异。
1. 添加或配置提供商
打开 模型配置。添加一个提供商、配置现有预设，或者当你需要可独立编辑的连接时复制某个预设。
| 字段 | 填写内容 |
|---|---|
| Display Name | 此连接的易识别名称 |
| Provider ID | 提供商配置的标识符 |
| API Key | 服务所需的凭据 |
| Base URL | 所选集成所期望的 API 基础地址 |
| Protocol | 上游 API 实际实现的格式 |
| Secret, Organization, Project | 仅当你的服务明确要求时才填写 |
| Support content array | 服务是否接受结构化消息内容 |
Base URL 的形态取决于协议和发出请求的功能。如果集成已经会追加完整操作路径，则不要自行追加。例如，某个集成会追加 /chat/completions，那么你需要填写对应的基础地址，而不是已以该路径结尾的地址。不要将该示例套用到所有协议。
编辑已存储的凭据时，将 API Key 或 Secret 留空会保留已配置的值。列表中显示的掩码值不是原始密钥，不应粘贴回去作为替换。
2. 添加模型
保存提供商后，选择该提供商并点击 添加模型。
| 字段 | 含义 |
|---|---|
| Display Name | 你在模型列表中使用的名称 |
| Model Value | 确切的上游模型 ID |
| Model Type | 配置表单中适用的类别 |
| Provider | 此条目使用的连接 |
| Context Window | 文档记录的上下文容量（如有指定） |
| Max Tokens | 输出限制（如有指定） |
请使用服务文档或模型列表中的 ID。营销名称不一定是 API 标识符。如果无法验证可选限制，请保持未设置；未设置并不表示已探测到真实限制。使用这些设置的功能可能会应用自己的默认值。
3. 验证配置
在使用这些设置的功能或引擎中：
- 选择新条目并开始测试对话。
- 发送一个简短请求，例如
Reply with: connected。 - 确认响应正常，并尽可能在提供商的使用记录中看到匹配的请求。
- 发送后续消息，检查连续对话是否正常。
- 如果你的工作涉及图像或工具调用，请单独测试。
保存记录并不是连接测试。文本响应并不能证明与所有功能兼容。更改模型条目也不会自动重新配置正在运行的 Claude Code 或 Codex 进程；请参阅 PandaPaw。
故障排除
身份验证失败
检查密钥是否有效、账户是否能访问该模型，以及服务是否需要额外的身份验证字段。通过提供商表单替换已过期的凭据。
找不到端点或模型
同时检查 Base URL 和 Model Value。查看是否存在重复的操作路径、缺失 API 前缀，或你的账户无法使用的模型 ID。不同提供商之间，同一个错误可能有不同原因。
出现网络或浏览器错误
从实际发送请求的设备上检查连接情况。源自浏览器的请求受 CORS 和 HTTPS 限制；另一台计算机上的请求即使成功，也不能证明浏览器路径可用。
无法访问本地模型服务器
localhost 指向发出请求的机器本身。它不会自动指向你的远程 PandaPaw 计算机。在选定本地服务器地址前，请先确认使用相关功能的实际运行位置。
文本正常，但图像、工具或长时间会话失败
检查引擎、API 协议和模型能力的确切组合。使用提供商支持的限额，并验证每种必需的输入类型。增大 Context Window 或更改 Model Type 并不会增加上游能力。
关于平台会员资格与提供商使用之间的区别，请参阅 账户和模型费用。