Lección 1 de 4 · 6 minutos

Qué es Phaseo

Phaseo es un gateway: una API y una clave delante de muchos modelos y de los proveedores que los alojan.

Phaseo es un gateway de IA. Envías todas las solicitudes a una sola API, https://api.phaseo.app/v1, con una sola clave. Phaseo pasa cada solicitud a un proveedor que pueda atenderla y la factura a tu espacio de trabajo. Puedes usar el formato de la API Responses, Chat Completions o Messages, el que ya use tu aplicación.

Los modelos y los proveedores son cosas distintas. Un modelo es el sistema que escribe la respuesta. Un proveedor aloja el modelo y fija su precio, su velocidad, su disponibilidad y los parámetros que admite. Un mismo modelo puede tener varios proveedores.

Un ID de modelo nombra el modelo, no el proveedor. Los ID tienen esta forma: openai/gpt-6-astra o anthropic/claude-sonnet-5.5, es decir, el laboratorio y después el modelo. phaseo/free elige un modelo gratuito disponible y funciona sin créditos. Si necesitas un proveedor concreto, puedes ponerlo delante del ID, por ejemplo baseten:thinking-machines/inkling-small.

Cómo se enruta una solicitud:

  1. Phaseo se queda solo con los proveedores que permiten los ajustes de tu espacio de trabajo y la solicitud.
  2. Los ordena. El modo predeterminado, balanced, tiene en cuenta el precio, la velocidad y la fiabilidad.
  3. Llama al primer proveedor. Si ese proveedor falla, prueba con el siguiente.
  4. Si todos los proveedores fallan con un error reintentable y has indicado modelos alternativos en models, prueba con el siguiente modelo.

Las alternativas no garantizan el éxito, así que tu aplicación debe seguir reintentando los errores 429 y 5xx con espera exponencial. Una cosa más: el catálogo público incluye algunos modelos a los que todavía no se puede llamar. Comprueba que un modelo está Activo en Gateway antes de usar su ID.

Comprueba lo que has aprendido

Llamas a un modelo que alojan tres proveedores y el proveedor mejor situado devuelve un error. ¿Qué hace Phaseo a continuación?

Ponlo en práctica

Un compañero encontró un modelo en la página Modelos de Phaseo y copió su ID en una solicitud. La solicitud falla, pero la página del modelo parece correcta. ¿Cuál es el motivo más probable y cómo lo compruebas?

Mostrar la respuesta

El catálogo incluye más modelos de los que el Gateway puede llamar. Puede que el modelo esté en Próximamente o Inactivo. En la página Modelos, el filtro de estado del Gateway muestra por defecto los modelos Activo en Gateway, y GET /v1/models devuelve solo los modelos a los que puedes llamar. Elige un modelo que esté Activo en Gateway.

Idea clave

Tú eliges el modelo; Phaseo elige un proveedor que lo aloja y pasa a otro cuando uno falla.

Enlaces relacionados

El progreso se guarda en este navegador.

Revisado por última vez el 17 de noviembre de 2026