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

# Azure OpenAI

Azure OpenAI は、Microsoft が Azure 上でホストする OpenAI モデルサービスで、企業コンプライアンス、データ所在の保証、または Microsoft エコシステムを必要とするチームに適しています。

## 事前準備

* Azure サブスクリプションを有効化済み
* Azure Portal で Azure OpenAI Service のアクセス申請を行い、承認済み
* 少なくとも 1 つ作成済み **リソース（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-**\*：埋め込みモデルで、 [グローバルメモリ](/docs/jp/advanced-basic/memory.md)、ナレッジベースと共用

## よくある質問

* **401 Unauthorized**：Key が正しいか、Endpoint の末尾に余分なスラッシュがないか確認
* **404 Not Found**：Deployment Name が Azure 上のものと一致しているか、API Version が入力されているか確認
* **429 Throttled**：Azure のクォータ（Quota & Limits ページ）を確認

***

### 💡 ヘルプの取得とフィードバックの送信

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/pre-basic/providers/azure-openai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.