Azure / Azure/azure-rest-api-specs
[Question] Why are there two separated api specs for Azure OpenAI (authoring and inference) ? How to bundle these two?
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 6k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
### API Spec link
https://github.com/Azure/azure-rest-api-specs/blob/7f4f4d7bffe69d7dd74ece53980a83f7c41f949e/specification/cognitiveservices/data-plane/AzureOpenAI/inference/preview/2025-04-01-preview/inference.yaml
### API Spec version
2025-04-01-preview
### Question/Query
I want to use Azure OpenAI behind Azure APIM. I tried to use the APIM wizard to import Azure OpenAI API into APIM, but it seems that only inference API is imported. I need both inference and authoring APIs. I tried to bundle the specifications myself but I was not able to import the bundled file into APIM. Is there a documented way to merge these two specs into one file? Is there a place where I can find this bundled file?
### Environment
_No response_
Contributor guide
Research direction
Start by reading the linked inference.yaml and locating the corresponding authoring specification in the AzureOpenAI data-plane tree. Determine whether the repository documents a supported combined OpenAPI import for APIM; done means pointing to an existing bundled file or documenting the supported merge and import procedure.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, openapi
- Domain
- api, documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100