添加第一个 API 密钥：Providers 配置全程

前置：先有一把钥匙

BYOK 应用的第一步永远在应用外：去你选定的模型服务商开放平台注册账号、创建 API 密钥。各家平台都有免费额度或按量计费，选择上可以参考内置的九类提供商。拿到一串密钥后回到 Agora。

五步配置

官方手册给的上手路径就是这五步，顺序别乱：

1. 打开设置：从主界面点菜单按钮进入对话抽屉，点底部「设置」；
2. 进入 Providers：选择你要用的提供商（如 OpenAI、DeepSeek）；
3. 填入凭据：粘贴 API 密钥；需要的话顺便改 Base URL，但一般留空即可（原因见Base URL 写法）；
4. 同步模型：切到 Models 页，点同步，提供商的模型列表会拉下来，勾选启用你想用的；
5. 回对话选模型：回到聊天界面，点底栏模型选择条，选中刚启用的模型，发消息。

任何一步卡住，对应的排错页在密钥连不上怎么办。

密钥存在哪、安全吗

• 密钥不进对话数据库，存在应用偏好设置里，正常情况下由 Android Keystore 的 AES-256-GCM 信封加密；
• 请求发出时，只有当前选中的凭据发往配置的目标端点；
• Base URL 决定了请求到底发给谁——用自定义端点时务必核对地址，这是最常见的泄露隐患点。

配完立刻能验证的两件事

• 底栏模型条不再显示「未选择模型」，而是显示模型名；
• 发一条消息，回复正常流式输出——注意深度推理模型可能先输出一段思维链再给正文，这属于正常现象，见深度推理模型。

相关页面

• 一家提供商想配好几个密钥轮换着用，看管理多个密钥；
• 全程不需要密钥的路线是导入 GGUF 模型。