官方平台 API Key 配置
BYOK 表示使用自己的厂商账户与 API Key 接入模型。密钥在 Mystilink 本机配置,模型用量由对应厂商计费。若想使用 Mystilink 账户与余额,请看 Newton LLM,无需在这里添加第三方 Key。
先准备三项信息
- API Key:由实际提供 API 的厂商开放平台生成;不要填写网页登录密码、Mystilink 激活码或聊天产品的登录凭证。
- 模型 ID:必须是当前 API 账户有权限使用的标识;显示名称不一定就是请求使用的 ID。
- API 权限与额度:能登录厂商聊天网页,不等于该账户已经具备可用 API 额度。请在开放平台确认。
不要把网上示例中的旧模型名视为必然可用。优先从当前可用模型列表选择;手工输入时逐字核对。
在 Mystilink 中添加
打开 设置 → 大模型,选择与服务对应的厂商。填写 API Key,或按界面支持的方式填写本机可读取的环境变量名。使用官方服务时,保留模板默认地址;只有明确需要代理或不同端点时,才覆写 Base URL。
先测试连接,再填写或选择模型 ID、补充显示名称并保存。将目标配置设为主模型后,用一条不含私人资料的消息确认对话能完成。连接测试成功并不保证模型具备完整的 Agent 工具调用能力。
厂商与协议
以下是 Mystilink 中对应的模板与官方入口,不是对可用地区、模型或价格的承诺。具体 Key 获取步骤、权限和付费规则以厂商平台为准。
| 厂商 | 官方入口 | Mystilink 模板注意事项 |
|---|---|---|
| OpenAI | API 平台、认证说明 | 使用 OpenAI 模板;保留默认地址,选择账户实际可用的模型 |
| Anthropic | Console、API 文档 | 原生 API 使用 Anthropic 协议,不要当作通用兼容网关填写 |
| Google Gemini | AI Studio、模型文档 | 使用 Gemini 模板;当前模板不提供 Base URL 覆写 |
| DeepSeek | 开放平台、API 文档 | 使用 DeepSeek 模板,确认模型与账户权限 |
| MiniMax | 开放平台 | 使用对应模板;不同区域的账户、密钥和地址不要混用 |
| Moonshot / Kimi | 开放平台 | 使用对应模板;模型 ID 与地址应来自同一服务区域和账户 |
Anthropic
使用官方原生服务时选择 Anthropic 模板。如果服务商另外提供兼容网关,应使用其公布的兼容协议和地址,不能只因为模型名称包含 Claude 就选原生模板。
Google Gemini
使用 Gemini 模板连接官方原生 API。第三方平台提供的 Gemini 模型可能采用另一种兼容协议;应按实际网关选择 自定义供应商。
地址、密钥与模型必须来自同一服务
官方 Key 不一定能用于代理,代理 Key 也不能直接用于官方地址。检查时应同时确认:谁发放了 Key、请求发往哪个域名、该账户可用哪些模型。覆写地址后,请求内容会发送到新地址对应的服务。
Base URL 应 填服务的 API 前缀,不要把完整聊天请求路径或模型详情网页粘贴进去。配置第三方网关或本机服务见 兼容供应商 与 本地模型。
常见问题
| 现象 | 先检查 |
|---|---|
| 401 / Key 无效 | Key 是否属于当前地址,是否过期或被撤销;环境变量能否被应用读取 |
| 模型列表为空 | 账户权限、模型发现支持;已知准确 ID 时可手工输入 |
| 404 / model not found | API 前缀与模型 ID,是否把显示名当作 ID |
| 测试成功但任务不能完成 | 工具调用、流式输出及模型能力,不只检查网络 |
| 额度相关错误 | 到实际厂商核对 API 账单;向 Newton 充值不会补充第三方额度 |
更多排查见 大模型连接问题。Key 泄露时应在发放平台撤销并重新配置,不要只修改显示名称或删除截图。