Azure OpenAI

Azure OpenAI — это сервис моделей OpenAI, размещённый Microsoft в Azure, подходящий для команд, которым нужны корпоративное соответствие требованиям, гарантии хранения данных в регионе или экосистема Microsoft.

Подготовка

• Подписка Azure уже активирована
• В Azure Portal уже подана заявка и получено одобрение доступа к Azure OpenAI Service
• Создан как минимум один ресурс (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, а не исходный ID модели OpenAI)

Deployment Name vs Model ID: в Azure используется имя, которое вы дали развертыванию (например gpt-4o-prod), а не gpt-4o . Если указать неверно, будет 404.

Рекомендуемое использование

• gpt-4o / gpt-4o-mini: универсальные диалоги, Agent
• gpt-4 turbo: длинный контекст
• text-embedding-3-*: модель эмбеддингов, можно использовать для базы знаний

Частые вопросы

• 401 Unauthorized: проверьте, правильно ли указан Key, и нет ли лишнего слэша в конце Endpoint
• 404 Not Found: проверьте, совпадает ли Deployment Name с тем, что задан в Azure, и указана ли версия API
• 429 Throttled: проверьте квоту Azure (страница Quota & Limits)

---

Получить помощь и отправить отзыв

Если в процессе настройки или использования у вас возникнут вопросы, баги или предложения по улучшению функций, пожалуйста, обратитесь к Обратная связь и предложения официальным каналам, указанным в