Phaseo とは
Phaseo はゲートウェイです。多くのモデルと、それを提供するプロバイダーの前に、1 つの API と 1 つのキーを置きます。
Phaseo は AI ゲートウェイです。すべてのリクエストを 1 つの API、https://api.phaseo.app/v1 に 1 つのキーで送ります。Phaseo は各リクエストを処理できるプロバイダーに渡し、ワークスペースに課金します。Responses、Chat Completions、Messages のどの API 形式でも使えるので、アプリがすでに使っている形式をそのまま使えます。
モデルとプロバイダーは別物です。 モデルは回答を書くシステムです。プロバイダーはモデルをホストし、その価格、速度、可用性、対応パラメーターを決めます。1 つのモデルに複数のプロバイダーがあることもあります。
モデル ID が示すのはモデルで、プロバイダーではありません。 ID は openai/gpt-6-astra や anthropic/claude-sonnet-5.5 のように、開発元、モデルの順に並びます。phaseo/free は利用可能な無料モデルを選び、クレジットなしで動作します。特定のプロバイダーを使いたい場合は、baseten:thinking-machines/inkling-small のように ID の前にプロバイダーを付けられます。
リクエストのルーティングの流れ:
- Phaseo は、ワークスペースの設定とリクエストが許可するプロバイダーだけを残します。
- それらを順位付けします。既定のモード
balancedは、価格、速度、信頼性を総合的に評価します。 - 最上位のプロバイダーを呼び出します。そのプロバイダーが失敗した場合は、次のプロバイダーを試します。
- すべてのプロバイダーが再試行可能なエラーで失敗し、
modelsにフォールバックモデルを指定している場合は、次のモデルを試します。
フォールバックは成功を保証しないので、アプリ側でも 429 と 5xx エラーをバックオフ付きで再試行してください。もう 1 点、公開カタログには、まだ呼び出せないモデルも載っています。モデル ID を使う前に、そのモデルが Gateway で有効 になっていることを確認してください。
理解度チェック
3 つのプロバイダーがホストしているモデルを呼び出したところ、最上位のプロバイダーがエラーを返しました。Phaseo は次に何をしますか?
実践してみる
チームメイトが Phaseo のモデルページでモデルを見つけ、その ID をリクエストにコピーしました。モデルページに問題はなさそうなのに、リクエストは失敗します。最も考えられる原因は何で、どう確認しますか?
答えを表示答えを隠す
カタログには、Gateway で呼び出せるモデルより多くのモデルが載っています。そのモデルは「近日公開」または「無効」かもしれません。モデルページでは、Gateway の状態フィルターが既定で「Gateway で有効」なモデルを表示します。また GET /v1/models は呼び出せるモデルだけを返します。「Gateway で有効」なモデルを選んでください。
ポイント
関連リンク
最終確認日:2026年11月17日