> 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 リソース → `キーとエンドポイント`
* コピー `キー 1` または `キー 2`をメモする `Endpoint`（次のような形式 `https://<your-name>.openai.azure.com/`）

## Cherry Studioで設定

* 開く `設定 → モデルサービス`、見つけて **Azure OpenAI** Providerを開いて詳細ページへ
* **API キー**：コピーした KEY を入力
* **API アドレス**：リソースの Endpoint を入力（末尾のパスは不要）
* **API バージョン**：専用フィールドにあなたのデプロイの API バージョンを入力（例： `2024-08-01-preview`）
* クリック **モデル一覧を取得**、または Azure にデプロイ済みのモデル名を手動で追加します（つまり Deployment Name であり、OpenAI の元のモデル ID ではありません）

{% hint style="warning" %}
**Deployment Name と Model ID の違い**：Azure ではデプロイに付けた名前を使います（例： `gpt-4o-prod`）、 `gpt-4o` のような元の ID ではありません。誤って入力すると 404 になります。
{% endhint %}

## 推奨の使い方

* **gpt-4o / gpt-4o-mini**：一般的な対話、Agent
* **gpt-4 turbo**：長文コンテキスト
* **text-embedding-3-**\*：埋め込みモデル。ナレッジベースに利用可能

## よくある質問

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

***

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

設定や使用中に疑問、バグ、または機能改善の提案がある場合は、 [フィードバックと提案](/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.