本篇重點
位置：設定 → 內容與發布 → 您的 AI 帳號
開啟此頁面：admin.<your-site>/settings/ai/providers（請將 <your-site> 替換為您的網站網址）
事前準備
- 擁有 Azure OpenAI 資源的 Azure 帳號。
- 該資源中已部署至少一個模型。Azure 必須在您部署模型後才能運作。
- 您在 Azure 中擁有讀取該資源金鑰的權限。
- 僅限管理 AI 的成員可進行串接，且您必須為近期登入狀態。
操作步驟
- 開啟 Azure 入口網站 並前往您的 Azure OpenAI 資源。
- 前往資源管理，然後點選金鑰與端點。
- 複製端點。其格式類似
https://my-resource.openai.azure.com，結尾必須是.openai.azure.com或.cognitiveservices.azure.com。 - 複製 KEY 1（KEY 2 請留作備用）。後台支援 32 個字元（字母 a–f 與數字）或 84 個字元的金鑰格式。
- 查詢您的部署名稱。在 Azure AI Foundry 入口網站中，開啟資源的部署。部署名稱是您在部署模型時所自訂的名稱，可能與模型本身名稱不同，例如
gpt-4o-mini。 - 在您的網站後台中，開啟 設定 → 內容與發布 → 您的 AI 帳號，並找到 Azure OpenAI 卡片。
- 貼上 Azure 端點。在 部署名稱 底下輸入每個部署名稱，每輸入完一個請點擊 新增。請至少新增一個。
- 貼上金鑰並點擊 測試並連結。畫面會顯示「正在檢查您的金鑰…」，隨後顯示 已連線 ✓。
貼心提醒
- 您最多可串接兩個 Azure 資源。
- Azure 無法透過金鑰自動列出模型清單，因此後台僅會顯示您手動輸入的部署。若日後部署了更多模型，隨時可回來新增。
- 定價為選填。若填寫定價，後台能顯示預估費用；若未填寫，當其他帳號發生錯誤時，AI 不會自動切換至此帳號。
- 款項由 Azure 向您收取。您可在 Azure 入口網站查看費用與預算。AI 預算與額度限制
- 金鑰僅儲存在您自己的伺服器上，Keynate 絕不會接觸到。
疑難排解
請使用您的 Azure OpenAI 端點
端點網址結尾必須是 .openai.azure.com 或 .cognitiveservices.azure.com。請從金鑰與端點頁面複製。自訂網域或 IP 位址將無法使用。
您的 Azure OpenAI 帳號中找不到此模型或部署
部署名稱不符。名稱必須完全一致（包含大小寫）。請至 Foundry 查看部署，修正卡片上的名稱後重新測試。
Azure OpenAI 拒絕了此金鑰
請重新複製完整金鑰。金鑰屬於特定資源，因此請確認使用的金鑰與端點來自同一個資源。
無法連線至此位址
請檢查端點是否有打錯字。如果您的資源設有網路存取限制，連線測試可能會失敗。請允許公用網路存取該資源，或將您伺服器的位址加入允許清單，然後重新測試。
Azure 顯示已達配額或速率限制 (Rate limit)
請稍候一分鐘，或至 Azure 調高該部署的配額額度。
常見問題
常見問題
我該使用 KEY 1 還是 KEY 2？
兩者皆可，建議使用 KEY 1。若日後在 Azure 輪替重設金鑰，請透過 更換金鑰 貼上新金鑰。
為什麼需要手動輸入部署名稱？
因為 Azure 允許您自訂每個部署的名稱。後台無法自動讀取，因此需要由您手動指定要使用的部署。