odysseus/specs/model-providers/azure-openai.md

Azure OpenAI Provider Shape

Last updated: dev@28d27ee | 2026-07-17

Scope

Canonical provider ID azure_openai; Azure deployment-scoped OpenAI dialects; custom endpoints use explicit configuration.

Shape

Azure commonly identifies deployments rather than globally stable model IDs. Preserve endpoint, deployment ID, API version, and underlying model/version as separate structured identity when returned. A standard OpenAI-compatible model list is identity-only until an Azure-specific reader intentionally maps its deployment fields.

Request paths and authentication can be deployment/API-version specific; do not blindly append public OpenAI paths or copy provider quirks. Capability and limits are deployment scoped.

Fallback And Current Gaps

Known *.openai.azure.com hosts select Azure OpenAI; other Azure gateways need explicit kind. Odysseus lacks a native Azure deployment catalog reader and structured API-version persistence in the canonical record.