eu.api.phaseo.app または us.api.phaseo.app に送ると、そのリージョンでモデルを実行し、プロンプトと補完のデータを処理するプロバイダールートだけが使われます。モデル ID と API キーは変わりません。Chat Completions、Responses、Messages に対応しています。
リージョン指定のリクエストを送る
region を "eu" または "us" に設定します。グローバルなルーティングを使う場合は省略するか "global" を使います。region とカスタムの baseUrl(Python では base_url)の両方を設定すると、それぞれ別のホストを選ぶため、SDK は例外を投げます。
ホスト名がそのままポリシーになります。リクエストやプリセット内の required_execution_region または required_data_region が別のリージョンを指定している場合は、400 validation_error(理由 deployment_region_conflict)で失敗します。プリセットと動的ルーティングのルールが先に適用され、リージョンのルールは最後に適用されるため、それらがリージョンのルールを弱めることはできません。Phaseo がリージョン外のプロバイダーで再試行することはありません。
リージョン指定のリクエストに含められるもの
自分のツールはアプリケーション内で実行されるため許可されます。ホスト型ツールとサーバーツールは、リージョンのルールが制御できない場所で実行されます。
リージョンで利用できるモデルを調べる
リクエストを送るのと同じホスト名で/v1/models を呼び出します。利用できるモデルは EU、US、グローバルのエンドポイントで異なります。
どの Gateway がリクエストを処理したか確認する
リージョン指定のレスポンスにはX-Phaseo-Gateway-Region: eu(または us)が付きます。このヘッダーはリクエストを処理したリージョンのポリシーを示すもので、Cloudflare がどこで実行したかの証明ではありません。リクエスト詳細には、必要な実行リージョンとデータリージョン、選択されたプロバイダー、そのプロバイダーが宣言したリージョンも記録されます。
エラー
リージョンのルールに違反すると、次のいずれかのreason とともに 400 not_supported が返ります。
理由
deployment_region_conflict の 400 validation_error は、リクエストまたはプリセットが別のリージョンを指定していることを意味します。その設定を取り除いてください。モデルとリージョンの両方を満たす正常なプロバイダールートがない場合、リクエストはプロバイダーを呼び出す前に停止します。リージョンの /v1/models に表示されるモデルを選んでください。
リージョン外に残るもの
リージョンのルールが対象とするのは、どのプロバイダーがモデルを実行し、プロンプトと補完のデータを処理するかです。リクエストのライフサイクル全体はまだ対象になっていません。- Cloudflare の配置によって Gateway はリージョンの近くに置かれますが、それはコンプライアンス上の境界ではありません。
- アカウント、認証、請求、リクエストのメタデータは、共有の Supabase インフラにあります。
- Cloudflare KV と Worker の呼び出しログは、リージョンに限定されません。
- プロバイダーへの呼び出しは、Cloudflare が Gateway をどこに配置したかにかかわらず、そのプロバイダーのリージョンのエンドポイントに送られます。
- サポートと運用のスタッフはリージョン内に限定されていません。