Skip to main content

​
Overview

Azure OpenAI Service provides access to OpenAI models through Microsoft’s Azure cloud platform. It offers enterprise-grade security, regional data residency, and compliance certifications, making it suitable for organizations with strict data governance requirements.

​
Supported Models

Models available depend on your Azure deployment. Common options include:
You must deploy a model in your Azure portal before you can use it. Azure does not provide default model endpoints — each model requires its own deployment.

​
Setup

1

Create Azure Subscription

  1. Go to Azure Portal
  2. Sign in or create a Microsoft Azure account
  3. Ensure you have an active Azure subscription
2

Create Azure OpenAI Resource

  1. In Azure Portal, search for Azure OpenAI
  2. Click Create and fill in the resource details
  3. Select your preferred region
  4. Wait for the resource to be provisioned
3

Deploy a Model

  1. Open your Azure OpenAI resource
  2. Go to Model deployments → Manage Deployments
  3. Click Create new deployment
  4. Select a model (e.g., gpt-4o) and give it a deployment name
  5. Note down the deployment name — you will need it
4

Get Endpoint and API Key

  1. In your Azure OpenAI resource, go to Keys and Endpoint
  2. Copy the Endpoint URL (e.g., https://your-resource.openai.azure.com/)
  3. Copy one of the API Keys
5

Configure in EnConvo

  1. Open Settings → AI Provider
  2. Select Azure OpenAI
  3. Go to Credentials module
  4. Enter your API Key, Endpoint URL, and Deployment Name

​
Configuration

​
Validate and Use

1

Validate credentials

Click Validate in the Azure OpenAI credential settings. Validation requires a correct API key, resource endpoint, API version, and deployment name.
2

Use deployment names

In Azure, EnConvo calls your deployment name, not just the base model name. A deployment named my-gpt-4o must be entered exactly as my-gpt-4o.
3

Test each deployment

If you maintain multiple deployments, validate and test each one before assigning it to production workflows or agents.
A 404 from Azure OpenAI usually means the endpoint, API version, or deployment name does not match the Azure resource, even when the API key is valid.

​
Pricing

Azure OpenAI pricing mirrors OpenAI’s pricing but may vary by region. Check Azure OpenAI Pricing for details.
Azure OpenAI billing goes through your Azure subscription. You can set spending alerts and budgets in the Azure portal.

​
Enterprise Benefits

Data Residency

Choose which Azure region hosts your data

Compliance

SOC 2, HIPAA, GDPR, and more

Private Networking

VNet integration, private endpoints

Managed Identity

Azure AD authentication support

​
Troubleshooting

  • Verify your API key is correct
  • Check that the key belongs to the correct Azure OpenAI resource
  • Ensure the resource is in an active subscription
  • Confirm your deployment name matches exactly (case-sensitive)
  • Verify the endpoint URL is correct
  • Check that the deployment has finished provisioning in Azure portal
  • Not all models are available in all Azure regions
  • Check Azure OpenAI model availability for your region
  • Consider creating a resource in a different region