Model capability mismatch occurs when an application requests a feature that the selected model, provider account tier, or deployment region does not support. Common cases include unavailable image analysis, region-locked audio transcription, inconsistent function calling, and unsupported streaming. section 8.2.1
Treat mismatches as compatibility failures that require verification and recovery:
- Verify disputed capabilities by executing the workflow and inspecting provider responses, especially for region-locked features. section 8.2.1
- Expect empty responses, inconsistent token limits, unclear policy errors, and behavior differences between model versions. section 8.2.1
- Wrap server-side requests in try-catch handling, record provider, model, and input context, then return a user-facing error with retry support. section 8.2.1
