开通并配置 Azure OpenAI
最后核对：2026-09-21。 Azure 的可用区域、模型、配额、部署类型和价格变化频繁。本文适合已经拥有 Azure 订阅，或公司要求通过 Microsoft Azure 使用模型的用户。
Azure OpenAI 比普通模型 API 多两个概念：先创建 Azure OpenAI 资源，再在资源中创建一个 模型部署。EasyAI 中的“默认模型”需要填写部署名称，而不是模型目录里的展示名称。
开始前需要什么
Section titled “开始前需要什么”- 一个 Microsoft 账号；
- 一个状态正常、可计费的 Azure Subscription；
- 在目标 Subscription 中创建资源和模型部署的权限；
- 目标地区有可用模型和配额。
没有 Azure 订阅时，可以从 Azure 免费账户 查看当前注册条件。免费账户是否提供足够额度、是否要求付款方式，以及 Azure OpenAI 是否可直接使用，都以注册页面和你的订阅实际状态为准。
1. 创建 Azure OpenAI 资源
Section titled “1. 创建 Azure OpenAI 资源”- 登录 Azure Portal。
- 搜索并创建 Azure OpenAI 资源。
- 选择 Subscription 和 Resource group。
- 选择支持目标模型的 Region。
- 填写唯一的资源名称，并选择页面提供的 Pricing tier。
- 检查网络设置和条款，创建资源。
不同地区支持的模型并不相同。创建前先查看 Azure OpenAI 模型与区域，不要只因为某个地区离自己近就直接选择。
Microsoft 的完整操作步骤见 创建资源并部署模型。
2. 部署一个模型
Section titled “2. 部署一个模型”- 从资源进入 Microsoft Foundry 管理界面。
- 打开模型部署页面，选择当前地区可用的模型。
- 创建 Deployment，并设置一个容易识别的部署名称。
- 记录这个 Deployment name。
如果无法创建部署，常见原因是目标地区没有该模型、当前 Subscription 没有配额，或账号缺少部署权限。请查看 Azure OpenAI 配额与限制。
3. 获取 Endpoint 和 API Key
Section titled “3. 获取 Endpoint 和 API Key”进入 Azure OpenAI 资源的 Keys and Endpoint 页面，记录：
- Resource endpoint，例如
https://你的资源名.openai.azure.com/； KEY 1或KEY 2中的一项。
不要公开 API Key。企业生产环境中，Microsoft 更推荐使用 Microsoft Entra ID 和无 Key 认证；EasyAI 当前的普通配置表单更适合个人或测试环境中的 API Key 路线。
4. 在 EasyAI 中怎么填
Section titled “4. 在 EasyAI 中怎么填”打开目标 Agent 的 配置 API → 添加服务商：
| 字段 | 填写内容 |
|---|---|
| 服务商名称 | Azure OpenAI |
| API 类型 | OpenAI Responses |
| Base URL | https://你的资源名.openai.azure.com/openai/v1/ |
| API Key | Azure 资源的 API Key |
| 默认模型 | 你创建的 Deployment name |
| 启用此服务商 | 开启 |
Azure OpenAI 的 v1 API 不需要再手动添加日期格式的 api-version。Base URL 要使用资源的 openai.azure.com 地址，并保留 /openai/v1/。
如果该部署或目标 Agent 不支持 Responses，请将 API 类型改为 OpenAI Chat Completions。接口兼容性和 v1 说明见 Azure OpenAI API 生命周期。
保存后选择 配置生效，再执行 重新检测。如果公司资源只允许私有网络或指定 IP，从普通家庭网络检测可能会失败，需要联系 Azure 管理员确认网络策略。
计费怎么理解
Section titled “计费怎么理解”Azure OpenAI 的费用进入你的 Azure Subscription 账单。常见的 Serverless 部署通常按 API 输入与输出用量计费；Managed compute 则可能按计算资源时长计费，不适合作为新手默认选择。
实际价格取决于模型、区域、部署类型和结算币种，部分配套服务也可能单独计费。创建部署前查看 Azure OpenAI Pricing，并在 Azure Cost Management 中设置预算与提醒。
| 提示或状态 | 常见原因与处理方法 |
|---|---|
401 / 403 |
Key 错误、资源权限不足，或网络访问策略拒绝请求 |
404 / Deployment not found |
EasyAI 的默认模型与 Deployment name 不一致 |
| Endpoint 无效 | 资源名错误，或 Base URL 缺少 /openai/v1/ |
| Model not supported | 当前部署不支持 Responses，可按官方说明尝试 Chat Completions |
429 |
达到 TPM、RPM、Subscription 配额或当前区域容量限制 |
| Portal 可用但本机不可用 | 检查 Public network access、防火墙、Private endpoint 和公司网络 |
Azure 的配额可能按 Subscription、区域、模型和部署类型共同生效。即使资源已经创建成功，也不代表目标模型一定还有可部署额度。