OpenAI 兼容供应商配置
第三方平台、自建网关或本机服务若提供 Mystilink 支持的兼容接口，可以创建自定义 Provider 接入。这里的「兼容」指接口协议，不保证所有模型、功能和认证方式都相同。
接入前确认
- 服务是否支持所需聊天接口、流式回复和工具调用。
- API 前缀、认证方式与模型 ID 是否由同一服务提供。
- 若需要特殊请求头、签名、查询参数或专用端点，当前设置是否支持；不能只改一个 URL 就假定可以使用。
- 该服务会怎样处理上下文、账单与密钥。网关可能进一步把请求转给上游厂商。
只有能返回普通文本，不代表一定能完成排盘工具、问询等 Agent 流程。
创建自定义 Provider
在 设置 → 大模型 的 Provider 创建入口选择自定义配置，按界面填写：
| 字段 | 怎样填写 |
|---|---|
| Provider ID | 本机配置的唯一标识，例如 my-gateway |
| 显示名称 | 便于辨认服务来源的名称 |
| API 协议族 | 服务确实提供该兼容协议时，选 openai-compatible |
| Base URL | 官方说明中的 API 前缀；不要填写聊天网页或完整 /chat/completions 请求地址 |
| API Key | 此网关自己的 Key；认证要求以服务文档为准 |
| 模型发现 | 服务支持模型列表时启用；否则使用准确的模型 ID |
保存 Provider 后，再添加模型配置、测试连接、填写模型 ID 与显示名称，最后确认主模型。参见 大模型与厂商。
地址示例
OpenRouter 官方接口说明 使用的 API 前缀为 https://openrouter.ai/api/v1。模型 ID 应从该账户可用目录获取，不能把上游厂商的简称直接当作网关 ID。
其他兼容平台或自建服务请使用其当前官方文档中的地址。例子里的 /v1 不是所有服务都通用的后缀；不要重复补上，也不要自行删去平台要求的路径。
能否覆写官方模板地址
只有确认协议和认证方式都匹配时，才使用「官方模板 + 覆写 Base URL」。名称相同的模型也可能通过不同接口提供；例如 Anthropic 原生协议、Gemini 原生协议和通用兼容协议不能简单混用。
Azure 等服务可能需要专门的认证、API 版本或部署路径。这里不提供未经验证的直连配方；先核对服务与 Mystilink 当前支持的协议是否 匹配，或使用明确提供受支持兼容接口的网关。
测试与排查
先发送不含私人资料的简短消息，再确认需要工具的实际任务能否完成。常见问题：
| 现象 | 排查方向 |
|---|---|
| 404 | API 前缀重复、缺路径，或模型 ID 不存在 |
| 401 / 403 | Key 与网关不匹配、权限不足或认证方式不支持 |
| 没有模型列表 | 未开启发现、服务不支持列表或账号无权限；核对后手工输入 |
| 有文字但工具不执行 | 模型或端点工具能力不匹配 |
| 回复中断或超时 | 网关、上游服务、网络及流式输出支持 |