跳转到主要内容
创建 API 密钥,向 POST /v1/responses 发送一个请求,然后从 output_text 读取回复。

从编程智能体开始

将此提示词复制到你的编程智能体中。它会识别项目的语言、安装 SDK、让智能体参考 Phaseo 文档、确保密钥不会写进代码,并发送第一个请求。如果项目已经在使用 Phaseo,它会检查现有配置,而不是从头开始。phaseo/free 无需额度即可使用;也可以换成 模型 中的任意文本模型 ID。

适用于编程智能体的设置提示词。 复制它,或在 Cursor 中打开。

在 Cursor 中打开
如需手动设置,请按照下面的步骤操作。

1. 创建 API 密钥

在控制台的 设置 -> API 密钥 下创建密钥,然后导出它:
密钥只显示一次。每个请求都把它作为 bearer 令牌发送:
请像对待密码一样对待 API 密钥。把它放在服务端代码中,永远不要把它发布到浏览器或移动应用中。

为付费模型充值额度

phaseo/free 无需额度即可使用。openai/gpt-6-astra 等付费模型需要钱包余额:
如果有已保存的银行卡,由工作区所有者或管理员通过邮件中的链接确认扣款。如果没有已保存的银行卡,命令会返回一个支付链接,由所有者或管理员打开并付款,银行卡会保存下来供之后充值使用。

2. 发送文本请求

POST /v1/responses 是新文本工作的推荐端点。示例使用付费模型 openai/gpt-6-astra。如需在没有额度的情况下测试,请把它换成 phaseo/free,它会选择一个可用的免费模型;参见从免费路由器开始上线。 cURL 和 fetch 无需安装任何内容。如需使用 SDK,请先安装:
运行环境要求和其他 SDK 请参阅 TypeScript 和 Python 安装页面。

3. 读取回复

流式输出回复

使用流式输出,可以在回复生成时就把它打印出来。每个 response.output_text.delta 事件的 text 只包含新增文本,因此这个循环只会打印一次答案。response.output_text.done 等结束事件会重复已经流式输出过的文本。完整事件列表请参阅流式输出。

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

错误参考列出了每个错误代码及其处理方法。

获取带类型的答案而不是文本

当代码需要的是一个值而不是一段文字时,把问题发送到 POST /v1/decisions(Beta)。每个答案都带类型和概率返回,顺序与问题相同。问题类型有 predicate(是/否)、choice(从你的选项中选一个)和 score(你的量表上的一个等级)。
响应(数值仅作示意):
读取 answers[0].choice 或 answers[1].probability,并用 confidence 或 probabilities 设置你自己的阈值。Decisions 参考列出了每个决策模型、它的限制和价格、图片输入,以及带命名问题映射(noul、criteria)的旧版 state 格式;旧格式仍然可用,某些模型也必须使用它。

生成视频

视频生成是异步的:先创建任务,再轮询它,然后下载文件。
如需用 webhook 代替轮询,请参阅异步任务与 Webhook。

继续构建

集成 Gateway

选择端点并搭建生产环境集成。

API 参考

每个端点的全部请求和响应字段。

示例

常见工作流的入门应用。

支持

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