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.
Envía una solicitud regional
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.
Comprueba qué Gateway gestionó una solicitud
Las respuestas regionales llevanX-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 devuelven400 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.