Azure OpenAI

Azure OpenAI 係微軟喺 Azure 上託管嘅 OpenAI 模型服務，適合需要企業合規、數據駐留承諾、或者微軟生態嘅團隊。

前置準備

• 已開通 Azure 訂閱
• 已喺 Azure Portal 入面申請並通過 Azure OpenAI Service 存取審批
• 已建立至少一個 資源（Resource） 同 部署（Deployment）

獲取 API Key

• Azure Portal → 你嘅 Azure OpenAI 資源 → Keys 同 Endpoint
• 複製 KEY 1 或 KEY 2，記低 Endpoint（例如 https://<your-name>.openai.azure.com/）

喺 Cherry Studio 配置

• 打開 設定 → 模型服務，搵到 Azure OpenAI Provider 進入詳情頁
• API 密鑰：填入複製咗嘅 KEY
• API 地址：填入資源嘅 Endpoint（唔使帶尾端路徑）
• API Version：喺專屬欄位填入你嘅部署嘅 API 版本（例如 2024-08-01-preview）
• 撳 獲取模型列表，或者手動加返你已喺 Azure 上部署嘅模型名（即 Deployment Name，而唔係 OpenAI 原始模型 ID）

Deployment Name 同 Model ID：Azure 用嘅係你畀部署改嘅名（如 gpt-4o-prod），唔係 gpt-4o 呢種原始 ID。填錯會 404。

推薦用法

• gpt-4o / gpt-4o-mini：通用對話、Agent
• gpt-4 turbo：長上下文
• text-embedding-3-*：嵌入模型，可用於知識庫

常見問題

• 401 Unauthorized：檢查 Key 係咪正確、Endpoint 尾端係咪多咗斜線
• 404 Not Found：檢查 Deployment Name 係咪同 Azure 上一致、API Version 係咪已填
• 429 Throttled：檢查 Azure 配額（Quota & Limits 頁）

---

取得幫助同提交反饋

如果你喺配置或者使用過程中遇到任何疑問、Bug，或者有功能改善建議，請參考 反饋與建議 入面提供嘅官方渠道。