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 ではありません）

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

推奨の使い方

• 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 ページ）を確認

---

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

設定や使用中に疑問、バグ、または機能改善の提案がある場合は、 フィードバックと提案 に記載の公式チャネルをご参照ください。