跳转到主要内容
运行一个小型 Next.js 聊天应用,其浏览器代码只与你自己的服务器路由通信,因此你的 Phaseo API 密钥永远不会到达浏览器。完成后,你会得到一个本地聊天页面,其模型选择器由 GET /v1/models 填充,回答来自 POST /v1/responses。 该示例仅作演示:它的路由没有登录或速率限制,任何能访问这些路由的人都会消耗你的密钥。请先添加部署之前中的检查。 要让编码智能体从零开始构建同样的应用,请粘贴以下提示词:

基于 Phaseo Gateway 构建一个 Next.js Web 聊天应用。

在 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_ 前缀会将它暴露给浏览器代码,因此绝不要在其中放入密钥。应用归因介绍了这两个可选请求头。
3

修复第二轮聊天

ChatClient.tsx 会将上一个回答的 id 作为 previous_response_id 发送。Gateway 不存储响应,因此会以 400 validation_error(关键字 unsupported_param)拒绝该字段,第二条消息就会失败。在 app/api/responses/route.ts 中,删除将 previous_response_id 复制到 payload 中的代码块:
app/api/responses/route.ts
之后,每一轮都会被单独回答。要保留上下文,请在 input 中以消息数组的形式发送之前的轮次。
4

启动开发服务器

打开 http://localhost:3000。

检查是否成功

  • 模型选择器中填充了模型 ID。
  • 连续发送的两条消息都得到了回答。
  • 在浏览器的网络面板中,请求只发往 /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日