本篇要点
位置： 设置 → 内容与发布 → 您的 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 提示已达到配额或速率限制
请等待一分钟，或在 Azure 中提高该部署的配额。
常见问题
常见问题
我应该使用哪个密钥，KEY 1 还是 KEY 2？
两者均可，通常使用 KEY 1。如果您在 Azure 中轮换了密钥，可通过 更换 key 粘贴新密钥。
为什么需要手动输入部署名称？
因为 Azure 允许您为每个部署自定义名称。管理后台无法自动识别，因此需要您指定使用哪些部署。