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 | 換用支援工具調用的模型，或見 大模型連接問題 |