API Key 和 Base URL 怎么填：以 DeepSeek 等服务商为例
选定服务来源后就是填凭据。这一步的字段几乎所有服务商都一样，看懂一两家就全通了。流程与字段说明整理自官方通用配置文档。
通用字段
| 字段 | 含义 | 填写建议 |
|---|---|---|
| API Key | 服务商签发的访问令牌 | 直接粘贴完整密钥，前后不要带空格、引号或换行 |
| Base URL | 服务商接口的根地址 | 服务商文档要求时才改，否则保留默认值 |
| 模型 | 实际使用的模型 ID | 优先从列表选；列表加载不出来再手动照抄服务商文档里的 ID |
以国产服务商为例的最短路径
以 DeepSeek 这类「OpenAI 兼容」接口为例（官方文档示例口径）：
- 去服务商开放平台注册账号并充值（或领取免费额度）。
- 在控制台的「API Keys」页新建一个密钥，复制。
- 回到 AIRI 的服务商配置页，粘贴密钥；Base URL 保留默认（官方示例根地址形如 api.deepseek.com，不需要加 chat/completions 后缀）。
- 点验证按钮测试连通性，通过后去选模型。
其他兼容接口的站点同理：拿到密钥、必要时填接口根地址、验证、选模型，四步走完。
逐字核对清单（填错重灾区）
- 密钥开头结尾有没有多复制了空格或换行——最常见的翻车点。
- Base URL 是否与服务商文档逐字一致：少个版本段、多个斜杠都可能验证失败。
- 模型 ID 是否照抄服务商文档：界面上的展示名称不是模型 ID。
- 账户有没有可用额度：没余额时密钥再正确也验证不过。
凭据安全
官方手册反复强调的一条：API Key 只应保存在你自己的设备里，不要提交到代码仓库、发到 Issue、截图外传或发给别人。怀疑泄露就去服务商控制台立刻作废重开。
接下来
- 填完测连通：Ping API 与选择模型。
- 验证报错了对照排查：服务商验证失败怎么办。