eu.api.phaseo.app ou us.api.phaseo.app pour n’utiliser que les routes de fournisseur qui exécutent le modèle et traitent les données de prompt et de complétion dans cette région. Les identifiants de modèle et les clés API restent les mêmes. Chat Completions, Responses et Messages sont pris en charge.
Envoyer une requête régionale
region sur "eu" ou "us" ; omettez-le, ou utilisez "global", pour le routage mondial. Le SDK lève une erreur si vous définissez à la fois region et une baseUrl personnalisée (base_url en Python), car ils désignent des hôtes différents.
Le nom d’hôte fait office de politique. Un required_execution_region ou required_data_region dans la requête ou dans un préréglage qui nomme une autre région échoue avec 400 validation_error, motif deployment_region_conflict. Les préréglages et les règles de routage dynamique sont appliqués en premier et la règle régionale en dernier : ils ne peuvent donc pas l’affaiblir. Phaseo ne relance jamais une requête via un fournisseur hors de la région.
Ce qu’une requête régionale peut contenir
Vos propres outils sont autorisés, car ils s’exécutent dans votre application. Les outils hébergés et les outils serveur s’exécutent à un endroit que la règle régionale ne peut pas contrôler.
Trouver les modèles disponibles dans une région
Appelez/v1/models sur le même nom d’hôte que celui auquel vous envoyez les requêtes. La disponibilité diffère entre les endpoints UE, États-Unis et mondial.
Vérifier quel Gateway a traité une requête
Les réponses régionales portentX-Phaseo-Gateway-Region: eu (ou us). L’en-tête nomme la politique régionale qui a traité la requête ; il ne prouve pas où Cloudflare l’a exécutée. Les détails de la requête enregistrent aussi les régions d’exécution et de données exigées, le fournisseur sélectionné et les régions déclarées par ce fournisseur.
Erreurs
Les violations de la règle régionale renvoient400 not_supported avec l’une de ces valeurs de reason :
400 validation_error avec le motif deployment_region_conflict signifie que la requête ou un préréglage nomme une autre région ; retirez ce réglage. Si aucune route de fournisseur saine ne satisfait à la fois le modèle et la région, la requête s’arrête avant tout appel à un fournisseur ; choisissez un modèle listé par le /v1/models régional.
Ce qui reste hors de la région
La règle régionale couvre le fournisseur qui exécute le modèle et traite les données de prompt et de complétion. Elle ne couvre pas encore tout le cycle de vie de la requête :- Le placement Cloudflare met le Gateway près de la région, mais ne constitue pas une frontière de conformité.
- Les données de compte, d’authentification, de facturation et les métadonnées des requêtes résident sur une infrastructure Supabase partagée.
- Cloudflare KV et les journaux d’invocation des Workers ne sont pas liés à une région.
- Les appels au fournisseur vont vers l’endpoint régional de ce fournisseur, quel que soit l’endroit où Cloudflare a placé le Gateway.
- Les équipes de support et d’exploitation ne sont pas limitées à la région.