{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"entry_sha256":"5c710e8a0153e6b8d30e20ef1a57939f99d7228f21354f1e6ef6775585ee97cd","entry":{"id":"microsoft/azure-openai","name":"Azure OpenAI in Microsoft Foundry Models","vendor":"Microsoft","summary":"Run OpenAI models (and other \"models sold by Azure\") inside your own Azure subscription. You need an Azure account with a subscription, an Azure OpenAI or Foundry resource, and a model deployment. Most models need no application any more; quota, a few limited-access models and abuse-monitoring opt-outs are the remaining gates.","aliases":["Azure OpenAI Service","Azure AI Foundry","Microsoft Foundry","AOAI"],"category":"ai","group":"B","homepage":"https://ai.azure.com/","docs":["https://learn.microsoft.com/en-us/azure/ai-foundry/openai/how-to/create-resource","https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits","https://learn.microsoft.com/en-us/azure/ai-foundry/responsible-ai/openai/limited-access"],"status":"researched","last_verified":null,"last_researched":"2026-10-25","sources":[{"id":"limited-access","url":"https://learn.microsoft.com/en-us/azure/ai-foundry/responsible-ai/openai/limited-access","title":"Limited access to Azure OpenAI in Microsoft Foundry Models","accessed":"2026-10-25","supports":"All Azure customers are eligible and no registration form is needed unless using a Limited Access model or asking to modify guardrails/abuse monitoring; modified guardrails and abuse monitoring only for customers managed by a Microsoft account team or an eligible program; form links.","kind":"official"},{"id":"models","url":"https://learn.microsoft.com/en-us/azure/foundry/foundry-models/concepts/models-sold-directly-by-azure","title":"Foundry Models sold by Azure","accessed":"2026-10-25","supports":"Registration required for computer-use-preview (aka.ms/oai/cuaaccess) and for grok-4 and grok-code-fast-1 (aka.ms/xai/grok-4); newer GPT families need quota requests in some quota tiers; preview models not recommended for production.","kind":"official"},{"id":"quotas","url":"https://learn.microsoft.com/en-us/azure/foundry/openai/quotas-limits","title":"Azure OpenAI in Microsoft Foundry Models quotas and limits","accessed":"2026-10-25","supports":"Quota tiers (Free Tier, Tiers 1-6) assigned per subscription by usage, payment history, offer and enterprise relationship; automatic upgrades with opt-out; quota request form aka.ms/oai/stuquotarequest; batch quota N/A for Azure for Students and free trials.","kind":"official"},{"id":"create-resource","url":"https://learn.microsoft.com/en-us/azure/ai-foundry/openai/how-to/create-resource","title":"Create and deploy an Azure OpenAI in Microsoft Foundry Models resource (classic)","accessed":"2026-10-25","supports":"Prerequisites (Azure subscription, RBAC permissions to create resources and deploy models); portal fields (subscription, resource group, region, name, Standard tier); network options; deploying a model; deployment name (not model name) used in API calls; CLI to read endpoint and key1.","kind":"official"},{"id":"quickstart","url":"https://learn.microsoft.com/en-us/azure/ai-services/openai/quickstart","title":"Azure OpenAI quickstart","accessed":"2026-10-25","supports":"Environment variable AZURE_OPENAI_API_KEY (and AZURE_OPENAI_AUTH_TOKEN for Entra ID), endpoint base https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/, Entra ID authentication recommended.","kind":"official"},{"id":"data-privacy","url":"https://learn.microsoft.com/en-us/azure/foundry/responsible-ai/openai/data-privacy","title":"Data, privacy, and security for Foundry Models sold by Azure","accessed":"2026-10-25","supports":"Prompts/completions not used to train foundation models or shared with OpenAI; Global/DataZone processing locations; abuse monitoring data store and human review; how to check ContentLogging=false after approval.","kind":"official"},{"id":"abuse-monitoring","url":"https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/abuse-monitoring","title":"Foundry Models sold by Azure abuse monitoring","accessed":"2026-10-25","supports":"Classification, pattern capture, automated and human review, email notification, chance to remediate except severe or recurring abuse, suspension or termination; modified abuse monitoring eligibility.","kind":"official"},{"id":"coc","url":"https://learn.microsoft.com/en-us/legal/ai-code-of-conduct","title":"Code of Conduct for Microsoft AI Services","accessed":"2026-10-25","supports":"Responsible AI requirements (AI disclosure, fraud controls, feedback channels, human oversight), usage restrictions (romantic/erotic chatbots, impersonation, emotion inference, social scoring etc.), content rules, loss of access for violations.","kind":"official"},{"id":"azure-free","url":"https://azure.microsoft.com/en-us/pricing/purchase-options/azure-account","title":"Azure free account","accessed":"2026-10-25","supports":"Phone, non-prepaid card and Microsoft or GitHub account needed; credit valid 30 days; must move to pay-as-you-go or services are disabled; one free account per new customer.","kind":"official"},{"id":"signup-trouble","url":"https://learn.microsoft.com/en-us/azure/cost-management-billing/troubleshoot-subscription/troubleshoot-azure-sign-up","title":"Troubleshoot issues when you sign up for a new account in the Azure portal","accessed":"2026-10-25","supports":"Common Azure sign-up blockers and fixes.","kind":"official"},{"id":"pricing","url":"https://azure.microsoft.com/en-us/pricing/details/azure-openai/","title":"Azure OpenAI pricing","accessed":"2026-10-25","supports":"Standard pay-as-you-go per input/output token; provisioned throughput units with monthly/annual reservations; Batch API returns within 24 hours at 50% off Global Standard; no Azure OpenAI-specific free tier shown.","kind":"official"}],"allowed_domains":["portal.azure.com","ai.azure.com","azure.microsoft.com","customervoice.microsoft.com"],"account_model":{"summary":"A Microsoft or GitHub account signs up for Azure; that creates an Entra tenant and a billing account with a subscription. Inside the subscription you create a resource group, then an Azure OpenAI (or Foundry) resource in a region, then one or more model deployments. Keys belong to the resource; quota belongs to the subscription.","accounts":[{"name":"Microsoft account or GitHub account","kind":"personal","owned_by":"the person","required":true},{"name":"Azure subscription","kind":"billing","owned_by":"the person or the company","parent":"Microsoft account or GitHub account","required":true,"note":"Free account, pay-as-you-go, Enterprise Agreement or MCA. Quota tier is assessed per subscription."},{"name":"Azure OpenAI / Foundry resource","kind":"project","parent":"Azure subscription","required":true,"note":"Lives in one region and resource group; holds KEY1/KEY2 and the endpoint."},{"name":"Model deployment","kind":"other","parent":"Azure OpenAI / Foundry resource","required":true,"note":"API calls use the deployment name you choose, not the model name."}],"notes":["Microsoft recommends Microsoft Entra ID (for example a managed identity) instead of API keys."]},"prerequisites":[{"need":"An Azure subscription (a free account works to start, but free trials get little or no quota for some deployment types)"},{"entry":"microsoft/entra-app-registration","note":"Only if a server outside Azure will authenticate with Entra ID instead of an API key."}],"have_ready":[{"kind":"payment_card","description":"A non-prepaid credit or debit card in your name","why":"Azure sign-up verifies identity with a card; continuing past the free credit needs pay-as-you-go billing.","needed_for":["azure-account","upgrade"],"auto_check":"none","source":"azure-free"},{"kind":"phone_for_2fa","description":"A phone that can receive a verification code","why":"Azure sign-up verifies a phone number.","needed_for":["azure-account"],"auto_check":"none","source":"azure-free"},{"kind":"other","description":"Which model and deployment type (Standard, Global Standard, Data Zone, Batch, Provisioned) and which region you need","why":"Model availability and quota vary by region, deployment type and subscription tier.","needed_for":["create-resource","deploy-model"],"auto_check":"none","source":"quotas"},{"kind":"other","description":"A written description of your use case, users and safety mitigations","why":"Limited-access model and abuse-monitoring forms ask about your scenario, and the Code of Conduct requires disclosure, abuse controls and human oversight.","needed_for":["limited-access","abuse-monitoring"],"auto_check":"none","source":"coc"}],"steps":[{"id":"azure-account","title":"Create an Azure account","summary":"Sign up with a Microsoft or GitHub account, verify a phone number and a non-prepaid card. Sign-up does not charge you; the free credit lasts up to 30 days.","route":"guided","depends_on":[],"gate":"human_payment","url":"https://azure.microsoft.com/en-us/pricing/purchase-options/azure-account","recovery":[{"hiccup":"Sign-up cannot proceed and tells you to contact billing support.","fix":"Make the Microsoft account name and address match the card's bank records, retry in a private window, then open a billing support request.","source":"signup-trouble"}],"sources":["azure-free"]},{"id":"upgrade","title":"Move to pay-as-you-go","summary":"Free accounts must move to pay-as-you-go within 30 days or when the credit runs out, or services are disabled. Free trials and student subscriptions also get no batch quota, so upgrade before real use.","route":"guided","depends_on":["azure-account"],"gate":"human_payment","url":"https://portal.azure.com/","optional":true,"sources":["azure-free","quotas"]},{"id":"create-resource","title":"Create an Azure OpenAI resource","summary":"In the Azure portal choose Create a resource > Azure OpenAI, then pick subscription, resource group, region, a resource name and the Standard pricing tier, and choose network access (all networks, selected networks or private endpoint only). You need RBAC permission to create the resource. The Foundry portal may offer to upgrade it to a Foundry resource.","route":"guided","depends_on":["azure-account"],"gate":"human_submit","url":"https://portal.azure.com/#create/Microsoft.CognitiveServicesOpenAI","sources":["create-resource"]},{"id":"deploy-model","title":"Deploy a model","summary":"In the Foundry portal open your resource > Deployments (or Models + endpoints) > Deploy model > Deploy base model, choose the model, a deployment name and a deployment type. Your code calls the deployment name.","route":"guided","depends_on":["create-resource"],"gate":"human_submit","url":"https://ai.azure.com/","recovery":[{"hiccup":"The model you want cannot be deployed because you have no quota for it.","fix":"Some quota tiers need a quota request for the newest GPT families; submit the quota request form or try another region or deployment type.","source":"models"},{"hiccup":"Calls fail because the code passes the model name.","fix":"Azure OpenAI always needs the deployment name, even in the model parameter.","source":"create-resource"}],"sources":["create-resource"]},{"id":"get-keys","title":"Copy the endpoint and key (or set up Entra ID)","summary":"On the resource's Keys and Endpoint page copy the endpoint and KEY1 (KEY2 is a spare for rotation). Microsoft recommends Microsoft Entra ID with managed identities instead of keys; if you use keys, keep them in a vault and rotate them.","route":"guided","depends_on":["create-resource"],"gate":"human_login","url":"https://portal.azure.com/","capture":{"env":"AZURE_OPENAI_API_KEY","kind":"api_key"},"sources":["create-resource","quickstart"]},{"id":"quota","title":"Request more quota (if needed)","summary":"Each subscription has a quota tier (Free Tier, Tiers 1-6) that rises automatically with use and payment history; enterprise agreements start higher. To get more now, submit the quota request form. Approved requests add quota without changing your tier.","route":"guided","depends_on":["deploy-model"],"gate":"third_party_review","url":"https://aka.ms/oai/stuquotarequest","optional":true,"sources":["quotas"]},{"id":"limited-access","title":"Apply for a limited-access model (only some models)","summary":"A few models need registration, for example computer-use-preview (aka.ms/oai/cuaaccess) and xAI grok-4 / grok-code-fast-1 (aka.ms/xai/grok-4). Access is granted against Microsoft's eligibility criteria; approval for one limited model does not cover another.","route":"guided","depends_on":["azure-account"],"gate":"third_party_review","url":"https://aka.ms/oai/cuaaccess","optional":true,"sources":["models","limited-access"]},{"id":"abuse-monitoring","title":"Apply to modify abuse monitoring or guardrails (managed customers only)","summary":"By default, flagged prompts and outputs can be stored and reviewed (by AI and, if needed, by authorised Microsoft staff) for abuse. Customers managed by a Microsoft account team or in an eligible programme can apply to turn off that storage and human review, or to switch guardrails partly or fully off. After approval, the resource's JSON view shows ContentLogging false.","route":"guided","depends_on":["create-resource"],"gate":"third_party_review","url":"https://learn.microsoft.com/en-us/azure/ai-foundry/responsible-ai/openai/limited-access","optional":true,"sources":["limited-access","abuse-monitoring","data-privacy"]}],"outputs":[{"name":"AZURE_OPENAI_API_KEY","description":"Resource key (KEY1 or KEY2) sent in the api-key header.","secret":true,"example_format":"opaque key string from Keys and Endpoint","from_step":"get-keys"},{"name":"AZURE_OPENAI_ENDPOINT","description":"Resource endpoint base URL.","secret":false,"example_format":"https://<resource-name>.openai.azure.com/","from_step":"get-keys"}],"terms_notes":[{"kind":"rules_say","severity":"red","title":"Abuse monitoring can suspend you","text":"Microsoft detects patterns such as repeated harmful content or jailbreak attempts. Confirmed abuse is notified by email; except for severe or recurring abuse you get a chance to fix it, but failure to fix, or severe or recurring abuse, can mean suspension or termination of access.","source":"abuse-monitoring"},{"kind":"rules_say","severity":"red","title":"Code of Conduct restrictions","text":"Apps must disclose AI-generated output and voices, control misuse and offer abuse reporting. Banned uses include erotic or romantic chatbots, personas of real people without consent, impersonation, emotion inference and social scoring. Violators may lose access at Microsoft's discretion.","source":"coc"},{"kind":"rules_say","severity":"amber","title":"Free accounts stop working","text":"Free credit lasts 30 days; if the account is not moved to pay-as-you-go, it and its services are disabled.","source":"azure-free"},{"kind":"rules_say","severity":"amber","title":"You pay per token; reservations are commitments","text":"Standard deployments bill per input and output token; provisioned throughput can be reserved monthly or yearly. Batch is 50% off Global Standard but returns within 24 hours.","source":"pricing"},{"kind":"rules_say","severity":"yellow","title":"Your data is not used for training","text":"Prompts, completions, embeddings and training data are not shared with OpenAI and not used to train foundation models without your permission. Global and Data Zone deployments may process data outside your resource's region.","source":"data-privacy"},{"kind":"rules_say","severity":"yellow","title":"Preview models change under you","text":"Microsoft does not recommend preview models in production; preview deployments are upgraded to later versions.","source":"models"}],"pricing_notes":{"costs":"Pay-as-you-go per 1M input and output tokens (rates vary by model and deployment type); provisioned throughput units for reserved capacity; Batch at 50% off Global Standard.","notes":"No Azure OpenAI-specific free tier is shown; the general Azure free account credit applies.","source":"pricing"},"api_provisioning":{"available":"partial","notes":"After a human has an Azure subscription, resources, deployments and keys can be created with the Azure CLI (az cognitiveservices account create / deployment create / keys list), PowerShell or ARM templates. Account sign-up, payment, quota requests and limited-access applications are human-only.","docs":["https://learn.microsoft.com/en-us/azure/ai-foundry/openai/how-to/create-resource"],"source":"create-resource"},"detect":{"env_names":["AZURE_OPENAI_API_KEY","AZURE_OPENAI_ENDPOINT","AZURE_OPENAI_AUTH_TOKEN"],"packages":["openai","@azure/openai","azure-ai-openai","Azure.AI.OpenAI"]}}}