レッスン 1/4 · 7 分

リクエストを送る

API キー、モデル ID、入力を、1 つの OpenAI 互換エンドポイントに送ります。

すべてのリクエストは https://api.phaseo.app/v1 に送り、API キーをベアラートークンとして付けます:Authorization: Bearer phaseo_v1_sk_...。キーは 設定 -> APIキー で作成します。一度しか表示されないので、PHASEO_API_KEY などの環境変数に保存し、サーバー側のコードでだけ使ってください。

新しいテキスト処理には POST /v1/responses をおすすめします。model と input を送ります。

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-astra",
    "input": "Reply with: quickstart works"
  }'

すでに OpenAI 公式 SDK を使っていますか? 変更するのは 3 つだけです。API キー、ベース URL、モデル ID です。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await client.responses.create({
  model: "openai/gpt-6-astra",
  input: "Write one sentence about reliable model routing.",
});

console.log(response.output_text);

Chat Completions を呼び出すコードも、同じクライアントで動きます。代わりに client.chat.completions.create に messages を送ってください。

モデル ID には、openai/、anthropic/、google/ のように必ずプロバイダーのプレフィックスが付きます。モデルを切り替えるときは model の文字列だけを変え、リクエストのほかの部分はそのままです。有効な ID は推測せず、GET /v1/models で一覧を取得してください。phaseo/free は利用可能な無料モデルを選び、クレジットなしで動作するので、最初のテストに便利です。

理解度チェック

OpenAI 公式 SDK の接続先を Phaseo にします。必要な変更はどれですか?

実践してみる

アプリが "model": "gpt-6-astra" を送ると、リクエストが 400 で失敗します。チームメイトはモデルが停止しているに違いないと言います。最初に何を確認しますか?

答えを表示

モデル ID です。Phaseo のモデル ID にはプロバイダーのプレフィックスが含まれるので、openai/gpt-6-astra が正しい形です。400 は障害ではなく、リクエスト本文かモデル ID の問題を示しています。GET /v1/models を呼び出して、正確な ID を確認してください。

ポイント

必要なのは、1 つのベース URL、1 つのベアラーキー、プロバイダーのプレフィックス付きのモデル ID だけです。モデルの切り替えは文字列を 1 つ変えるだけです。

関連リンク

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

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