Cursor 使用 Azure OpenAI API Key 报错：model is required

问题

在 Cursor 设置中配置 Azure OpenAI BYOK（自带密钥）后，无论如何配置 Endpoint、Deployment Name 和 API Key，提交请求时都返回以下错误：

{"error":{"type":"client","reason":"invalid_input","message":"model is required","retryable":false}}

即使已经填写了 Azure 部署名称，Cursor 仍然没有正确传递 model 参数给 Azure API。Pro 订阅用户也会遇到此问题，因为 Azure BYOK 走的是独立通道。

解决方案

原因

这是 Cursor 端的已知 Bug：Cursor 在调用 Azure OpenAI API 时没有正确传递 model 参数（Azure 要求这个字段为 Deployment Name）。同时缺少 api-version 字段，部分 Azure 部署也因此失败。

截至目前（2026年），官方尚未发布修复版本。

临时方案：使用社区代理转换请求格式

社区有人专门开发了适配器，将 Cursor 的请求格式转换为 Azure API 可接受的格式：

https://github.com/gabrii/Cursor-Azure-GPT-5

使用方式：

1. Clone 或部署该代理到本地（或你的服务器）
2. 在 Cursor 的 OpenAI API Base URL 填写代理地址
3. API Key 和 Deployment Name 仍然填写 Azure 的配置

等待官方修复

已有多名用户在 Cursor 论坛反馈此问题，官方表示已记录并会更新。若急需 Azure 模型，建议暂时使用 Cursor 订阅内置模型（Claude Sonnet / GPT-5 等），等待 Azure BYOK 修复。