第 1/4 节课 · 7 分钟

发送请求

把你的 API 密钥、模型 ID 和输入发送到一个兼容 OpenAI 的端点。

每个请求都发送到 https://api.phaseo.app/v1,并把你的 API 密钥作为 bearer 令牌携带: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?只需改三处: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 的代码也可以使用同一个客户端:改为把 messages 发送给 client.chat.completions.create 即可。

模型 ID 总是带有提供商前缀,例如 openai/、anthropic/ 或 google/。要切换模型,只需更改 model 字符串,请求的其余部分保持不变。用 GET /v1/models 列出有效的 ID,不要靠猜。phaseo/free 会选择一个可用的免费模型,无需额度即可使用,很适合做第一次测试。

检验你的理解

你把 OpenAI 官方 SDK 指向 Phaseo。需要做哪些更改?

学以致用

你的应用发送了 "model": "gpt-6-astra",请求以 400 失败。一位同事说这个模型肯定宕机了。你首先检查什么?

显示答案

检查模型 ID。Phaseo 的模型 ID 包含提供商前缀,所以应该是 openai/gpt-6-astra。400 说明问题出在请求体或模型 ID 上,而不是服务中断。调用 GET /v1/models 确认准确的 ID。

要点

一个基础 URL、一个 bearer 密钥和一个带提供商前缀的模型 ID 就够了,切换模型只需改一个字符串。

相关链接

进度保存在此浏览器中。

最后核对于 2026年11月17日