BeefAPIResponses
使用 input 发起 Responses 请求并解析输出项与流事件。
POST https://enterprise.beefapi.com/v1/responses
使用企业 Key 的 Bearer 认证。此接口面向支持 Responses 协议的文本模型；不要将 Chat Completions 或 Anthropic Messages 的返回解析器直接复用到这里。
请求
curl --fail-with-body https://enterprise.beefapi.com/v1/responses \
-H "Authorization: Bearer $BEEFAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"用一句话解释异步任务。"}' \
-o response.json| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 必填，支持 Responses 的可用模型 |
input | string 或 array | 输入文本或协议规定的输入项 |
instructions | string | 可选，模型指令 |
stream | boolean | 可选，启用 SSE |
tools | array | 可选，工具定义；具体类型需模型支持 |
首次集成从字符串 input 开始。持久会话、内置工具和其他高级字段的支持随模型而异；不要仅因路径兼容就假设完整复刻所有平台功能。
解析输出
HTTP 成功后检查响应状态和 output。output 可以包含文本消息、推理或工具调用等多种项，不能只取第一个元素就断言没有答案。
示例响应（仅展示文本相关字段）：
{
"id":"resp_example",
"status":"completed",
"output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"异步任务先返回标识，之后再查询执行结果。"}]}]
}import json
from pathlib import Path
response = json.loads(Path("response.json").read_text())
for item in response.get("output", []):
if item.get("type") == "message":
for part in item.get("content", []):
if part.get("type") == "output_text":
print(part["text"])流式输出
将请求加上 "stream": true，curl 加 --no-buffer。读取 response.output_text.delta 文本事件，并等待 response.completed；同时处理错误、失败和不完整结果，不能把最后一个文本片段当作完整成功。
若使用 OpenAI SDK，Base URL 为 https://enterprise.beefapi.com/v1。工具参数可能分片到达，需在工具调用完整后再执行。客户端连接中断不等于取消执行，费用核对见 用量与计费。