Skip to main content

Migration Guides

Phaseo migration guides cover two different upgrade problems:
  • moving from one platform or gateway to Phaseo
  • adopting a specific model release on the same platform

Model migrations

Upgrade a model while keeping the surrounding integration broadly the same.

Platform migrations

Move an SDK, provider, or gateway integration onto Phaseo.

Model migrations

Use model migrations when the integration stays broadly the same but the model changes underneath it. These guides focus on:
  • request parameter changes
  • prompt and reasoning behavior shifts
  • structured output and tool-calling differences
  • rollout, fallback, and rollback strategy
Current model migration guides:

Platform migrations

Use platform migrations when you are changing SDKs, providers, or gateways and need to map your current integration onto Phaseo.

Build a migration checklist

Choose your current integration and open the interactive migration assistant.
Current platform migration guides: Plan and validate the rollout:

How to use these guides

  1. Identify whether you are changing the platform, the model, or both.
  2. Start with the guide that matches the riskiest part of the migration.
  3. Verify request parameters and endpoint behavior before comparing output quality.
  4. Run production-like evals before shifting live traffic.
Last modified on August 19, 2026