メインコンテンツへスキップ
テキストリクエストを eu.api.phaseo.app または us.api.phaseo.app に送ると、そのリージョンでモデルを実行し、プロンプトと補完のデータを処理するプロバイダールートだけが使われます。モデル ID と API キーは変わりません。Chat Completions、Responses、Messages に対応しています。
リージョンルーティングは、まだエンドツーエンドのデータ所在地の保証ではありません。Phaseo はプロバイダーの選択を制限し、Gateway をリージョンの近くに配置しますが、共有のアカウント、請求、キャッシュ、運用のシステムがリージョン外でデータを処理することがあります。リージョン外に残るものを参照してください。

リージョン指定のリクエストを送る

SDK では 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、グローバルのエンドポイントで異なります。
一覧には、宣言された実行リージョンとデータリージョンの両方にそのリージョンが含まれる、有効なプロバイダールートを持つモデルだけが含まれ、テキストの入出力による Chat Completions、Responses、Messages だけが示されます。各オファーにはリージョンが表示されます。

どの 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 をどこに配置したかにかかわらず、そのプロバイダーのリージョンのエンドポイントに送られます。
  • サポートと運用のスタッフはリージョン内に限定されていません。
Phaseo がこれをエンドツーエンドのデータ所在地と呼ぶのは、Gateway、ストレージ、ログ、プロバイダー、運用のすべての経路に、強制力のあるリージョンの制御が備わってからです。
最終更新日 2026年11月5日