OpenAI 兼容供应商配置
除 官方平台 外，许多第三方服务提供 OpenAI 兼容 API（请求格式与 OpenAI Chat Completions 相同）。Mystilink Agent 可通过 自定义 Provider 或 官方模板 + 覆写 Base URL 接入这些服务。
什么是 OpenAI 兼容 API
满足以下特征的服务即可视为 OpenAI 兼容：
- 提供类似
POST /v1/chat/completions的端点 - 使用
Authorization: Bearer <API Key>认证（部分本地服务可填佔位 Key） - 请求/响应 JSON 结构与 OpenAI 相近
Mystilink 中对应 API Family 为 openai-compatible。
不适用的情况
- Anthropic Claude 官方 API 使用獨立协议 → 请用 Anthropic 官方模板。
- Google Gemini 官方 API → 请用 Gemini 官方模 板。
两种接入方式
方式 A：官方模板 + 覆写 Base URL（适合单一閘道）
若第三方服务本质上是某官方模型的代理（例如 OpenAI 代理、DeepSeek 代理），可：
- 選擇对应官方 Provider 模板（如 OpenAI、DeepSeek）。
- 开启 覆写 Base URL，填入閘道地址（须含
/v1路径，如https://gateway.example.com/v1）。 - 填寫閘道提供的 API Key，測試連接后選擇模型 ID。
适用于：已有官方模板、仅更换 endpoint 的场景。
方式 B：自定义 Provider（推荐用于獨立平台）
适用于 OpenRouter、SiliconFlow、Together、Groq、自建閘道等獨立品牌：
- 打開 設定 → 大模型，滚动至 新建 Provider。
- 模板 選擇 自定义 Provider。
- 填寫以下字段：
| 字段 | 说明 | 示例 |
|---|---|---|
| Provider ID | 唯一标识，小写英文 | openrouter |
| 顯示名称 | 界面展示名 | OpenRouter |
| API Family | 选 openai-compatible | — |
| 預設 Base URL | 服务根地址（含 /v1） | https://openrouter.ai/api/v1 |
| API Key | 平台发放的金鑰 | sk-or-... |
| 启用模型发现 | 若平台支持 /models 列表可勾选 | — |
- 点击 创建 Provider。
- 再按 添加模型 流程：选 Provider → 測試連接 → 填模型 ID → 保存。
常见 OpenAI 兼容平台示例
以下 Base URL 与模型 ID 以各平台当前文檔为准，部署前请核对官方说明。
OpenRouter
| 项目 | 值 |
|---|---|
| 註冊 | openrouter.ai |
| Base URL | https://openrouter.ai/api/v1 |
| 模型 ID | 如 anthropic/claude-3.5-sonnet、openai/gpt-4o（见平台模型列表） |
SiliconFlow（硅基流动）
| 项目 | 值 |
|---|---|
| 註冊 | cloud.siliconflow.cn |
| Base URL | https://api.siliconflow.cn/v1 |
| 模型 ID | 如 Qwen/Qwen2.5-72B-Instruct |
Groq
| 项目 | 值 |
|---|---|
| 註冊 | console.groq.com |
| Base URL | https://api.groq.com/openai/v1 |
| 模型 ID | 如 llama-3.3-70b-versatile |
Together AI
| 项目 | 值 |
|---|---|
| 註冊 | api.together.xyz |
| Base URL | https://api.together.xyz/v1 |
| 模型 ID | 见 Together 模型目录 |
Azure OpenAI
Azure 的 endpoint 因资源而异，通常形如：
https://<你的资源名>.openai.azure.com/openai/deployments/<部署名>
建议创建自定义 Provider，Base URL 填 Azure 文檔给出的完整前缀；模型 ID 填部署名称（deployment name），而非 OpenAI 公开模型名。API Key 使用 Azure 资源金鑰。
配置检查清单
在保存前確認：
- Base URL 末尾路径正确（多数为
/v1，以廠商文檔为准） - API Key 有效且帳戶有余额/权限
- 測試連接 顯示成功
- 模型 ID 与平台文檔完全一致（区分大小写）
- 若走公司代理，本机網路可訪問该 Base URL 域名
常见问题
| 现象 | 可能原因 | 处理 |
|---|---|---|
404 on /v1/chat/completions | Base URL 多写或少写路径段 | 对照文檔调整，常见错误是多加了 /chat/completions |
| 401 | Key 错误或 Header 不匹配 | 確認 Bearer 格式；部分閘道需额外 Header（若平台要求，目前需在閘道侧配置） |
| 模型列表为空 | 未开启模型发现或平台不支持 | 手动输入模型 ID |
| 能测通但 Agent 回复异常 | 模型不支持 tool calling | 换用支持工具调用的模型，或见 大模型連接问题 |