リクエストを送る
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 を確認してください。
ポイント
関連リンク
最終確認日:2026年11月17日