レッスン 1/4 · 6 分

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 の前にプロバイダーを付けられます。

リクエストのルーティングの流れ:

  1. Phaseo は、ワークスペースの設定とリクエストが許可するプロバイダーだけを残します。
  2. それらを順位付けします。既定のモード balanced は、価格、速度、信頼性を総合的に評価します。
  3. 最上位のプロバイダーを呼び出します。そのプロバイダーが失敗した場合は、次のプロバイダーを試します。
  4. すべてのプロバイダーが再試行可能なエラーで失敗し、models にフォールバックモデルを指定している場合は、次のモデルを試します。

フォールバックは成功を保証しないので、アプリ側でも 429 と 5xx エラーをバックオフ付きで再試行してください。もう 1 点、公開カタログには、まだ呼び出せないモデルも載っています。モデル ID を使う前に、そのモデルが Gateway で有効 になっていることを確認してください。

理解度チェック

3 つのプロバイダーがホストしているモデルを呼び出したところ、最上位のプロバイダーがエラーを返しました。Phaseo は次に何をしますか?

実践してみる

チームメイトが Phaseo のモデルページでモデルを見つけ、その ID をリクエストにコピーしました。モデルページに問題はなさそうなのに、リクエストは失敗します。最も考えられる原因は何で、どう確認しますか?

答えを表示

カタログには、Gateway で呼び出せるモデルより多くのモデルが載っています。そのモデルは「近日公開」または「無効」かもしれません。モデルページでは、Gateway の状態フィルターが既定で「Gateway で有効」なモデルを表示します。また GET /v1/models は呼び出せるモデルだけを返します。「Gateway で有効」なモデルを選んでください。

ポイント

モデルを選ぶのはあなたです。Phaseo はそのモデルをホストするプロバイダーを選び、失敗したら別のプロバイダーにフォールバックします。

関連リンク

進捗はこのブラウザーに保存されます。

最終確認日:2026年11月17日