> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/pre-basic/providers/azure-openai.md).

# Azure OpenAI

Azure OpenAI 是微软在 Azure 上托管的 OpenAI 模型服务，适合需要企业合规、数据驻留承诺、或微软生态的团队。

## 前置准备

* 已开通 Azure 订阅
* 已在 Azure Portal 中申请并通过 Azure OpenAI Service 访问审批
* 已创建至少一个 **资源（Resource）** 与 **部署（Deployment）**

## 获取 API Key

* Azure Portal → 你的 Azure OpenAI 资源 → `Keys and 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）

{% hint style="warning" %}
**Deployment Name vs Model ID**：Azure 用的是你给部署起的名字（如 `gpt-4o-prod`），不是 `gpt-4o` 这种原始 ID。填错会 404。
{% endhint %}

## 推荐用法

* **gpt-4o / gpt-4o-mini**：通用对话、Agent
* **gpt-4 turbo**：长上下文
* **text-embedding-3-**\*：嵌入模型，可与 [全局记忆](/advanced-basic/memory.md)、知识库共用

## 常见问题

* **401 Unauthorized**：检查 Key 是否正确、Endpoint 末尾是否多余斜杠
* **404 Not Found**：检查 Deployment Name 是否与 Azure 上一致、API Version 是否填了
* **429 Throttled**：检查 Azure 配额（Quota & Limits 页）

***

### 💡 获取帮助与提交反馈

如果您在配置或使用过程中遇到任何疑问、Bug 或有功能改进建议，请参考 [反馈与建议](/question-contact/suggestions.md) 中提供的官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/pre-basic/providers/azure-openai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.