Saltar al contenido principal
Envía las solicitudes de texto a eu.api.phaseo.app o a us.api.phaseo.app para usar solo las rutas de proveedor que ejecutan el modelo y tratan los datos de prompts y respuestas en esa región. Los ID de modelo y las claves de API no cambian. Se admiten Chat Completions, Responses y Messages.
El enrutamiento regional todavía no es una garantía de residencia de datos de extremo a extremo. Phaseo limita la selección de proveedores y sitúa el Gateway cerca de la región, pero los sistemas compartidos de cuentas, facturación, caché y operaciones pueden procesar datos fuera de ella. Consulta Qué queda fuera de la región.

Envía una solicitud regional

En los SDK, establece region en "eu" o "us"; omítelo, o usa "global", para el enrutamiento global. El SDK lanza un error si estableces a la vez region y una baseUrl personalizada (base_url en Python), porque eligen hosts distintos. El nombre de host es la política. Un required_execution_region o required_data_region en la solicitud o en un preajuste que nombre otra región falla con 400 validation_error, motivo deployment_region_conflict. Los preajustes y las reglas de enrutamiento dinámico se aplican primero y la regla regional al final, así que no pueden debilitarla. Phaseo nunca reintenta a través de un proveedor fuera de la región.

Qué puede contener una solicitud regional

Tus propias herramientas están permitidas porque se ejecutan en tu aplicación. Las herramientas alojadas y de servidor se ejecutan en lugares que la regla regional no puede controlar.

Busca los modelos disponibles en una región

Llama a /v1/models en el mismo nombre de host al que envías las solicitudes. La disponibilidad varía entre los endpoints de la UE, de EE. UU. y global.
La lista solo contiene modelos con una ruta de proveedor activa cuyas regiones declaradas de ejecución y de datos incluyen ambas la región, y solo anuncia Chat Completions, Responses y Messages con entrada y salida de texto. Cada oferta muestra sus regiones:

Comprueba qué Gateway gestionó una solicitud

Las respuestas regionales llevan X-Phaseo-Gateway-Region: eu (o us). El encabezado nombra la política regional que gestionó la solicitud; no demuestra dónde la ejecutó Cloudflare. Los detalles de la solicitud también registran las regiones de ejecución y de datos requeridas, el proveedor seleccionado y las regiones que declara ese proveedor.

Errores

Las infracciones de la regla regional devuelven 400 not_supported con uno de estos valores de reason: 400 validation_error con el motivo deployment_region_conflict significa que la solicitud o un preajuste nombra otra región; quita ese ajuste. Si ninguna ruta de proveedor en buen estado cumple a la vez con el modelo y con la región, la solicitud se detiene antes de llamar a ningún proveedor; elige un modelo de los que muestra el /v1/models regional.

Qué queda fuera de la región

La regla regional abarca qué proveedor ejecuta el modelo y trata los datos de prompts y respuestas. Todavía no abarca todo el ciclo de vida de la solicitud:
  • La ubicación de Cloudflare sitúa el Gateway cerca de la región, pero no es un límite de cumplimiento normativo.
  • Los datos de cuenta, autenticación, facturación y metadatos de solicitudes residen en una infraestructura compartida de Supabase.
  • Cloudflare KV y los registros de invocación de Workers no están ligados a una región.
  • Las llamadas al proveedor van al endpoint regional de ese proveedor, independientemente de dónde haya situado Cloudflare el Gateway.
  • El personal de soporte y operaciones no está restringido a la región.
Phaseo solo llamará a esto residencia de datos de extremo a extremo cuando el Gateway, el almacenamiento, los registros, el proveedor y las rutas operativas tengan todos controles regionales aplicables.
Última modificación el 5 de noviembre de 2026