eu.api.phaseo.app oder us.api.phaseo.app, um nur Anbieterrouten zu nutzen, die das Modell in dieser Region ausführen und Prompt- und Antwortdaten dort verarbeiten. Modell-IDs und API-Schlüssel bleiben gleich. Chat Completions, Responses und Messages werden unterstützt.
Eine regionale Anfrage senden
region auf "eu" oder "us"; lass es weg oder verwende "global" für globales Routing. Das SDK wirft einen Fehler, wenn du sowohl region als auch eine benutzerdefinierte baseUrl (base_url in Python) setzt, weil beide unterschiedliche Hosts auswählen.
Der Hostname ist die Richtlinie. Ein required_execution_region oder required_data_region in der Anfrage oder einer Voreinstellung, das eine andere Region nennt, schlägt mit 400 validation_error und dem Grund deployment_region_conflict fehl. Voreinstellungen und dynamische Routing-Regeln werden zuerst angewendet und die regionale Regel zuletzt, sodass sie diese nicht abschwächen können. Phaseo wiederholt nie über einen Anbieter außerhalb der Region.
Was eine regionale Anfrage enthalten kann
Deine eigenen Tools sind erlaubt, weil sie in deiner Anwendung laufen. Gehostete Tools und Server-Tools laufen an einem Ort, den die regionale Regel nicht kontrollieren kann.
In einer Region verfügbare Modelle finden
Rufe/v1/models auf demselben Hostnamen auf, an den du Anfragen sendest. Die Verfügbarkeit unterscheidet sich zwischen EU-, US- und globalen Endpunkten.
Prüfen, welches Gateway eine Anfrage verarbeitet hat
Regionale Antworten tragenX-Phaseo-Gateway-Region: eu (oder us). Der Header nennt die regionale Richtlinie, die die Anfrage verarbeitet hat; er belegt nicht, wo Cloudflare sie ausgeführt hat. Die Anfragedetails erfassen außerdem die geforderten Ausführungs- und Datenregionen, den ausgewählten Anbieter und dessen deklarierte Regionen.
Fehler
Verstöße gegen die regionale Regel geben400 not_supported mit einem dieser reason-Werte zurück:
400 validation_error mit dem Grund deployment_region_conflict bedeutet, dass die Anfrage oder eine Voreinstellung eine andere Region nennt; entferne diese Einstellung. Erfüllt keine funktionsfähige Anbieterroute sowohl das Modell als auch die Region, stoppt die Anfrage, bevor ein Anbieter aufgerufen wird; wähle ein Modell, das der regionale Endpunkt /v1/models auflistet.
Was außerhalb der Region bleibt
Die regionale Regel deckt ab, welcher Anbieter das Modell ausführt und Prompt- und Antwortdaten verarbeitet. Den gesamten Lebenszyklus einer Anfrage deckt sie noch nicht ab:- Die Cloudflare-Platzierung bringt das Gateway nahe an die Region, ist aber keine Compliance-Grenze.
- Konto, Authentifizierung, Abrechnung und Anfragemetadaten liegen auf gemeinsamer Supabase-Infrastruktur.
- Cloudflare KV und Worker-Aufrufprotokolle sind nicht an eine Region gebunden.
- Aufrufe an den Anbieter gehen an dessen regionalen Endpunkt, unabhängig davon, wo Cloudflare das Gateway platziert hat.
- Support- und Betriebspersonal ist nicht auf die Region beschränkt.