メインコンテンツへスキップ
ブラウザーのコードが自分のサーバールートとだけ通信し、Phaseo の API キーがブラウザーに届かない小さな Next.js チャットアプリを実行します。完成すると、GET /v1/models から取得したモデル選択欄と、POST /v1/responses からの回答を持つローカルのチャットページができます。 このサンプルは例示用です。ルートにはサインインもレート制限もないため、ルートにアクセスできる人は誰でもあなたのキーを使って支出できます。先にデプロイする前にのチェックを追加してください。 コーディングエージェントに同じアプリを一から作らせるには、次のプロンプトを貼り付けます。

Phaseo Gateway 上に Next.js のウェブチャットアプリ を作成します。

Cursorで開く

サンプルの構成

サンプルは examples/web-chat-nextjs にあります。

実行する

Node.js と Phaseo の API キーが必要です。
1

インストールする

サンプルには package-lock.json が含まれているため、npm はテスト済みのバージョンをインストールします。
2

.env.local を作成する

サンプルには .env.example がありません。.env.local を自分で作成します。
.env.local
ここでは NEXT_PUBLIC_GATEWAY_URL はサーバー側でしか読み取られませんが、NEXT_PUBLIC_ という接頭辞が付いた変数はブラウザーのコードに公開されるため、キーは絶対に入れないでください。省略可能な 2 つのヘッダーについてはアプリのアトリビューションで説明しています。
3

2 回目のチャットターンを修正する

ChatClient.tsx は、前の回答の id を previous_response_id として送信します。Gateway はレスポンスを保存しないため、このフィールドを 400 validation_error(キーワード unsupported_param)で拒否し、2 通目のメッセージは失敗します。app/api/responses/route.ts で、previous_response_id をペイロードにコピーするブロックを削除します。
app/api/responses/route.ts
これで各ターンは単独で回答されます。コンテキストを保つには、それまでのターンをメッセージの配列として input で送信してください。
4

開発サーバーを起動する

http://localhost:3000 を開きます。

動作を確認する

  • モデル選択欄にモデル ID が入ります。
  • 続けて送った 2 通のメッセージの両方に回答が返ります。
  • ブラウザーのネットワークパネルで、リクエストの送信先は /api/models と /api/responses だけで、PHASEO_API_KEY を含むリクエストはありません。
  • 不正なモデル ID を指定すると、空の回答ではなく Gateway のエラーメッセージが表示されます。
  • リクエストは、設定したアプリのタイトルとともに 設定 → 利用状況 → ログ に表示されます。

デプロイする前に

  • ルートを認証する。 /api/responses と /api/models でサインイン済みのユーザーを必須にするか、OAuth ワークベンチを使って各ユーザーが自分のクレジットを使うようにしてください。
  • モデルを許可リストで制限する。 ルートはブラウザーから届いた任意の model 文字列を転送します。サーバー側で固定のリストと照合してください。
  • 入力とリクエスト頻度に上限を設ける。 入力の長さとユーザーごとのリクエスト数を制限し、キーに支出上限を設定してください。
  • 必要ならストリーミングする。 stream: true を設定してイベントを転送します。Responses のストリームを終了させるイベントはストリーミングで説明しています。
UI ではなくバックエンドのスクリプトが必要な場合は、Node REST スモークアプリまたは Python Gateway CLI から始めてください。
最終更新日 2026年11月5日