Skip to main content
本教程帮助你成功发送 Phaseo 请求,生成文本或结构化决策,并确认响应出现的位置。
使用编程智能体? 开始前请复制并粘贴此提示:
你将完成以下操作:
  • 创建 API 密钥
  • 发送文本请求或结构化决策请求
  • 读取生成文本或带类型的答案
  • 了解请求失败时应先检查什么

1. 创建 API 密钥

  1. 打开 Phaseo 控制台。
  2. 在 Gateway -> 密钥下创建密钥。
  3. 只复制一次,并安全保存。
密钥格式如下:
请像保护密码一样保护 API 密钥。不要将其暴露在客户端代码中。

2. 发送文本请求

首次请求使用 POST /v1/responses。这是新文本生成集成的推荐端点。

请求

响应

直接调用 Responses API 时,请从 output[].content[] 中 type 为 output_text 的内容读取助手回复。 如果使用 Vercel AI SDK,请从 result.text 读取回复。

3. 作出结构化决策

应用需要带类型的答案而非生成文本时,请使用 POST /v1/decisions。Phaseo 提供 TypeSafe 的 Jev 1.13,模型 ID 为 typesafe/jev-1.13.0。发送 state 值和一个或多个具名问题;每个答案都以相同名称返回。
Decisions 是测试版功能,可能需要在工作区启用。Jev 1.13 按每百万输入令牌 $0.042 计费;输出令牌免费。
请在设置了 PHASEO_API_KEY 的服务器上运行这些示例。切勿在浏览器代码中暴露 Gateway API 密钥。 三种问题类型为:
  • choice 从条件映射中选择一个选项,并返回概率和置信度。
  • noul 返回 0 到 1 之间的是/否概率。
  • score 评估有序条件数组,并返回概率加权分数。
同一个请求中可以混合问题类型。

请求

响应

从与问题 ID 匹配的答案中读取带类型的值,例如 answers.department.choice、answers.is_urgent.noul 或 answers.customer_impact.score。需要设置应用阈值时,使用 confidence 和 probabilities,不要仅根据值分支。 完整请求和响应约定请参阅 Decisions API 参考;模型行为和上游限制请参阅 TypeSafe 的 Jev 模型参考。

4. 排查第一个请求的问题

  • 401:检查 API 密钥和 Authorization 请求头。
  • 400:检查请求正文和模型 ID。
  • 402:切换到 :free 模型,或在使用付费模型前充值。
  • 429 或 5xx:使用指数退避策略重试。
请参阅错误处理参考,快速排查问题。

5. 如果你正在开发视频功能

视频生成是异步的。先创建任务,然后轮询状态或订阅结果。
  1. 使用 POST /v1/videos 创建任务。
  2. 使用 GET /v1/videos/{video_id} 查询状态,直到任务完成。
  3. 使用 GET /v1/videos/{video_id}/content 下载内容。

6. 继续开发

集成 Gateway

生产环境集成模式和端点选择。

API 参考

所有端点的完整请求与响应文档。

示例

常见工作流的更多完整请求示例。

支持

获取有关调试、路由和模型行为的帮助。
最后修改于 2026年10月2日