https://api.phaseo.app/v1 y la clave a PHASEO_API_KEY. Las cargas útiles de las solicitudes, el encabezado Authorization: Bearer, el objeto provider y la matriz de respaldo models siguen funcionando; comprueba los ID de modelo y los pocos campos de la tabla siguiente.
Cambia el cliente
OPENROUTER_BASE_URL y la clave antigua del código, de CI y de los ajustes de hosting. @openrouter/ai-sdk-provider pasa a ser @phaseo/ai-sdk-provider (consulta Migrar desde Vercel AI Gateway); los SDK propios de OpenRouter (@openrouter/sdk, openrouter en PyPI) necesitan un cambio de cliente, no solo una URL base nueva.
Comprueba los ID de modelos
La mayoría de los ID coinciden, pero algunas organizaciones difieren:x-ai/ es spacex-ai/, meta-llama/ es meta/ y mistralai/ es mistral/. Lista los ID de Phaseo y comprueba cada modelo de producción con ellos:
availability=all para ver los inactivos o los que llegarán pronto. Sin format=openai, la respuesta es la lista paginada models de Phaseo, que no tiene matriz data.
Asigna los campos de la solicitud
Phaseo también tiene
provider.required_execution_region y provider.required_data_region, que no tienen equivalente en OpenRouter. Consulta Fijar o ignorar proveedores y Enrutar solo a proveedores de la UE o con ZDR para ver solicitudes completas.
Mantén los campos exclusivos de OpenRouter que queden en un único adaptador en lugar de en cada punto de llamada, para que la reversión siga siendo un cambio de URL base y clave.
Valida antes del cambio
Ejecuta estas comprobaciones contra Phaseo y después las mismas a través de la ruta de cliente de tu aplicación:OPENROUTER_API_KEYse ha sustituido porPHASEO_API_KEYen todos los entornos;- cada ID de modelo de producción está en
GET /v1/models?format=openai; - una solicitud sin streaming y otra con streaming funcionan a través de
/v1/chat/completionso/v1/responses, usando la misma ruta de cliente que en producción; - los flujos de llamadas a herramientas y de salida estructurada funcionan con prompts reales;
- se gestionan los fallos por clave no válida y por modelo no válido;
- una solicitud fallida se puede consultar con
GET /v1/generations?id=<request_id>y, cuandoreplay_supportedestrue, repetir a partir dereplay_request; - los encabezados y campos de respuesta exclusivos de OpenRouter se han eliminado o normalizado, y los valores predeterminados compartidos están en presets.
Despliega
- Empieza con el tráfico interno.
- Mueve entre el 5 y el 10 % del tráfico de producción y compara calidad, latencia y coste.
- Pasa al 100 % cuando se confirme la paridad.
- Mantén la reversión como un cambio de URL base y clave hasta que el cambio sea estable.
Encarga la migración a un agente de programación
Da al agente esta secuencia acotada, o instala la skill de migración de OpenRouter a Phaseo, que incluye los mismos pasos de inventario, asignación, validación y reversión:- Busca en el código de ejecución y en la configuración de despliegue
openrouter.ai,OPENROUTER_API_KEY,sk-or-v1,HTTP-RefereryX-Title. - Cambia el límite del cliente a
https://api.phaseo.app/v1yPHASEO_API_KEYsin añadir ningún valor secreto al control de versiones. - Consulta
GET /v1/models?format=openaiy anota cada correspondencia de modelo antiguo a nuevo. - Adapta las opciones de enrutamiento o los campos de respuesta exclusivos de OpenRouter en un único módulo de compatibilidad.
- Ejecuta las comprobaciones de estado, sin streaming, con streaming y de rutas de fallo anteriores.
- Informa de los archivos cambiados, los cambios de nombre de secretos, las correspondencias de modelos, las pruebas realizadas, las diferencias de paridad y el interruptor de reversión.