Skip to main content

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

GuideModel release date
Anthropic: Claude Opus 4.5 to 4.6February 5, 2026
Anthropic: Claude Sonnet 4.5 to 4.6February 17, 2026
OpenAI: Migrating to GPT-5.4March 5, 2026
Google: Migrating to Gemini 3 and 3.1Gemini 3: November 25, 2025; Gemini 3.1 Pro: February 19, 2026
Google: Nano Banana 1 to Nano Banana 2February 26, 2026
xAI: Grok 4.20February 17, 2026

How to use this section

  1. Start with the guide for the exact model family you are upgrading.
  2. Update the request shape before testing output quality.
  3. Re-run prompt and schema evaluations on production-like prompts.
  4. 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