Connect Azure OpenAI (BYOK)
Connect your Azure OpenAI resource in Settings — endpoint, API key, and deployment names, about 2 minutes
Connect Azure OpenAI (BYOK)
Route GPT and reasoning models through your Azure OpenAI resource. Setup takes about two minutes if you already have a resource endpoint and API key.
Navigation
- Parent: Deployment
- Related: Connect AWS Bedrock (BYOK) | On-Premise Deployment
Connect in five steps
- Open Settings → AI Providers from the dashboard sidebar.
- Find the Azure OpenAI card and click Connect.
- Enter your resource endpoint (for example
https://my-resource.openai.azure.com). - Paste your API key and, if needed, an API version (defaults to
2024-10-21when left blank). - Click Connect, then pick an
azure-*model in chat to verify.
On connect, Deslicer validates the endpoint format and probes your resource. Credentials are stored encrypted for your team.
Prerequisites
- An Azure OpenAI resource with models deployed in the Azure AI Foundry portal.
- Deployment names in Azure that match the catalog below (custom names are not synced in v1).
- Enterprise deployment — Azure OpenAI BYOK is available on enterprise/on-premise installations, same as AWS Bedrock BYOK.
Connection fields
| Field | Purpose |
|---|---|
| Endpoint | Your resource URL, for example https://{resource}.openai.azure.com |
| API key | Azure OpenAI resource key from the Azure portal |
| API version | Optional; defaults to 2024-10-21 when omitted |
Available models
Deployment names in Azure must match the Azure deployment column exactly.
| Deslicer slug | Azure deployment | Display name |
|---|---|---|
azure-gpt-4o | gpt-4o | GPT-4o (Azure) |
azure-gpt-4o-mini | gpt-4o-mini | GPT-4o mini (Azure) |
azure-gpt-4.1 | gpt-4.1 | GPT-4.1 (Azure) |
azure-gpt-4.1-mini | gpt-4.1-mini | GPT-4.1 mini (Azure) |
azure-o3-mini | o3-mini | o3-mini (Azure) |
azure-o4-mini | o4-mini | o4-mini (Azure) |
Only models in this catalog appear in chat after a successful connect.
Eligibility
Azure OpenAI BYOK is gated to enterprise deployments (DEPLOYMENT_MODE=enterprise). On-premise installations include enterprise-tier features by default. Cloud SaaS tenants need an enterprise plan with BYOK enabled.
See also Connect AWS Bedrock (BYOK) for the parallel AWS flow.
Troubleshooting
Connection probe failed
- Confirm the endpoint URL includes
https://and matches your Azure resource hostname. - Verify the API key is active and belongs to the same resource.
- Check that the resource allows the API version you entered (or leave API version blank to use the default
2024-10-21).
Model not available in chat
- Ensure the model is deployed in Azure with a deployment name that exactly matches the catalog (for example deploy
gpt-4o, notmy-gpt-4o). - Disconnect and reconnect after adding new deployments — v1 does not live-sync custom deployment names.
Enterprise-only message
Azure OpenAI BYOK requires an enterprise deployment. On-premise installs qualify automatically; contact your administrator if you are on cloud SaaS and need BYOK access.
