Skip to content

Commit be9aefa

Browse files
Add troubleshooting for Azure OpenAI model access error
1 parent 491b218 commit be9aefa

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/TroubleShootingSteps.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -556,6 +556,30 @@ If the server was deleted, either restore it (if possible) or update references
556556
557557
</details>
558558
559+
<details>
560+
561+
<summary><b>SpecialFeatureOrQuotaIdRequired</b></summary>
562+
563+
This error occurs when your subscription does not have access to certain Azure OpenAI models.
564+
565+
**Example error message:**
566+
`SpecialFeatureOrQuotaIdRequired: The current subscription does not have access to this model 'Format:OpenAI,Name:o3,Version:2025-04-16'.`
567+
568+
**Resolution:**
569+
To gain access, submit a request using the official form:
570+
👉 [Azure OpenAI Model Access Request](https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUQ1VGQUEzRlBIMVU2UFlHSFpSNkpOR0paRSQlQCN0PWcu)
571+
572+
You’ll need to use this form if you require access to the following restricted models:
573+
- gpt-5
574+
- o3
575+
- o3-pro
576+
- deep research
577+
- reasoning summary
578+
- gpt-image-1
579+
580+
Once your request is approved, redeploy your resource.
581+
582+
</details>
559583
560584
💡 Note: If you encounter any other issues, you can refer to the [Common Deployment Errors](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/common-deployment-errors) documentation.
561585
If the problem persists, you can also raise an bug in our [MACAE Github Issues](https://github.com/microsoft/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator/issues) for further support.

0 commit comments

Comments
 (0)