Saltar al contenido principal
En el código de AI SDK, sustituye @ai-sdk/gateway por @phaseo/ai-sdk-provider y envuelve cada ID de modelo con phaseo(...). En los clientes compatibles con OpenAI, cambia la URL base y la clave. Tu lógica de generación no cambia.

Cambia el proveedor

La exportación predeterminada phaseo lee PHASEO_API_KEY una sola vez, al importar el módulo, y usa https://api.phaseo.app/v1. Si la variable se define después de las importaciones, como ocurre en algunas configuraciones serverless y de pruebas, cada llamada lanza un error de clave ausente; en ese caso, llama a createPhaseo({ apiKey, baseURL, headers }) dentro del manejador. Instala la línea del proveedor que corresponda a tu versión principal de ai: @phaseo/ai-sdk-provider para AI SDK 7, @phaseo/ai-sdk-provider@ai-sdk-v6 para AI SDK 6 y @phaseo/ai-sdk-provider@ai-sdk-v5 para AI SDK 5. AI SDK envía de forma predeterminada los modelos indicados como cadenas simples (model: "openai/gpt-4.1-mini") a través del gateway de Vercel, así que una cadena simple olvidada sigue llamándolo. Cambia una vez la fábrica de modelos compartida y después busca model: " en las llamadas de AI SDK. Los clientes del SDK de Anthropic que apuntan a ai-gateway.vercel.sh pasan a la configuración de Migrar desde el SDK de Anthropic.

Asigna las opciones del gateway

providerOptions.phaseo se combina con el cuerpo de la solicitud. Un providerOptions.gateway que quede se ignora sin error.

Prueba y despliega

Ejecuta el mismo conjunto de prompts por ambas rutas y compara latencia, formato de salida y uso de tokens. Antes de promover el tráfico, comprueba que:
  • PHASEO_API_KEY está definida en cada entorno de ejecución que tenía la clave del gateway, incluidos los despliegues de edge, de servidor y de vista previa;
  • la ruta principal de generación de texto y una prueba de streaming funcionan sin cambios en staging;
  • las llamadas a herramientas y las salidas estructuradas funcionan si la aplicación las usa;
  • la asignación de errores a nivel de aplicación sigue funcionando;
  • una solicitud fallida en staging se puede encontrar y, cuando replay_supported es true, repetir desde GET /v1/generations?id=<request_id>.
Publica detrás de una marca de función o de un despliegue por porcentaje, empezando por el tráfico interno. Vigila la latencia, la tasa de errores y las desviaciones de tokens y coste, y mantén disponible el proveedor anterior durante al menos una publicación para que la reversión no requiera cambios de código.
Para saber más sobre el proveedor, consulta AI SDK.
Última modificación el 7 de noviembre de 2026