Skip to main content
POST
POST https://code.heihuzi.ai/v1/responses 已验证文本生成。五个文本模型见 Models;本页扩展输入及流式测试使用 gpt-5.5。验证日期:2026-09-13 运行示例前设置环境变量 HEIHUZI_API_KEY,使用具有对应文本模型权限的 Key。Python 示例使用已验证的 OpenAI Python SDK 2.32.0

已验证的输入

input 使用消息数组,例如 [{"role":"user","content":"Reply with exactly API_OK."}]。2026-09-13 复核时,gpt-5.5 的字符串 input 返回 400,提示必须使用数组;本页与 SDK/cURL 示例已统一使用数组。

真实响应节选

响应示例取自真实调用。
非流式文本读取 output[]type: "message"content[],其中 type: "output_text"text 为文字。Python OpenAI SDK 也可使用 output_text,见SDK 示例 stream: true 的实测事件包括 response.output_text.deltaresponse.completed。缺少 modelinput 的请求已验证返回 400。 当前复核发现部分非流式响应的正文为 JSON、Content-Type 却为 text/event-stream。JavaScript SDK 示例使用 .asResponse() 后显式解析 JSON,完整代码见SDK 示例

文本流式返回

下面的完整代码读取 response.output_text.delta 并输出文字,以 response.completed 确认结束。实测输出为 API_OK
2026-09-10 实测还捕获过 HTTP 200 后收到 response.failed、错误码为 server_error 的请求。代码会抛出该错误;不要仅凭 HTTP 状态判断流式调用成功。连接结束却没有完成事件时,同样按失败处理。2026-09-13 并行测试还触发了 gateway_concurrency_limit:非流式请求返回 HTTP 429,流式请求收到 response.failed。降低并发后再发起请求。

参考图识别

下载蓝色杯子 reference.png到运行目录。此示例将图片编码为 Data URL,搭配 input_text 提问,实测回答 Blue

连续对话

此示例由客户端保存并提交完整历史:将上一轮的输入、output 和新的用户消息一起放入下一次 input。两次真实调用依次回答 READYBLUE_CUP_29

自定义函数完整示例

下面代码已真实执行两次 API 调用:先获取 add 调用,再提交本地计算结果。
图像生成与编辑使用 Images 接口。本页的图片输入测试用于识别参考图内容。

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required

已验证文本模型:gpt-5.5、gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra、gpt-6-astra。扩展输入和流式测试使用 gpt-5.5。

Example:

"gpt-5.5"

input
object[]
required

消息和函数结果数组。已验证文本消息、input_text + input_image Data URL、完整对话历史和 function_call_output。gpt-5.5 字符串 input 实测返回 400。

Example:
stream
boolean

gpt-5.5 已验证 JSON 和 SSE。

tools
object[]

已验证自定义 add 函数的参数传递和结果回传,完整格式见本页可执行示例。

tool_choice
object

已验证 {"type":"function","name":"add"}。

Response

JSON 文本位于 output 消息的 content;SSE 须检查 response.completed,收到 response.failed 应按失败处理。

The response is of type object.