Model Migrations
Use these guides when you are staying on the same platform but upgrading the model itself.
These pages focus on the changes that usually break real integrations first:
- request parameter changes
- prompt and reasoning behavior shifts
- structured output and tool-calling regressions
- rollout, fallback, and rollback strategy
Available guides
Release timeline
How to use this section
- Start with the guide for the exact model family you are upgrading.
- Update the request shape before testing output quality.
- Re-run prompt and schema evaluations on production-like prompts.
- Shift traffic gradually with explicit fallback and rollback rules.
If you are changing providers, SDKs, or gateways rather than just the model, use the Migration Guides section instead.Last modified on March 11, 2026