跳转到主要内容
调用 SDK 的 responses 方法发送 POST /v1/responses,获取一个完整的响应。

流式输出响应

每个解析后的事件(TypeScript 和 Python)保留其原始字段(type、delta 等),并增加 text、usage 和推理 token 数(reasoningTokens / reasoning_tokens)。text 只包含新增文本:在 .done 事件和 response.completed 上它为空,因为这些事件会重复你已经拿到的文本;.done 事件的完整文本位于 fullText / full_text 中。 使用原始 SSE 行时(C#、PHP、Ruby、Java),请把每个 data: 行解析为 JSON,并自行处理事件名、事件类型(例如 response.output_text.delta 和 response.completed)以及完成标记。流式输出方法会为你设置 stream: true,所以不要在请求中设置它。

读取输出文本

输出是一个由输出项组成的数组。文本位于类型为 message 的 output 项中,函数调用位于类型为 function_call 的项中,token 数位于 usage 中。Python 的 resp.output_text 会帮你拼接文本。
如果一个请求可能返回多条消息、推理项、工具调用或提供商元数据,请保留完整的响应。

发送函数工具

请求正文在每个 SDK 中都相同。以 Rust 为例:
Rust
如需带审批和可恢复状态的本地工具循环,请使用 Agent SDK。

参数

在每个 SDK 中,字段名都是 JSON 正文字段。Go 的带类型 phaseo.ResponsesRequest 使用 PascalCase 结构体字段(Model、Input)。 参数解释了每个字段,Responses API 参考提供完整的 schema。

响应

ResponsesResponse:
设置 stream: true 时,端点会发送带类型的 SSE 事件。文本通过 response.output_text.delta 事件到达,最后的 response.completed 事件携带完整的响应和用量:
最后修改于 2026年11月5日