BeefAPIChat Completions
发送消息、读取回复并处理 OpenAI 兼容流式输出。
POST https://enterprise.beefapi.com/v1/chat/completions
使用企业 Key 的 Bearer 认证和 Content-Type: application/json。模型须在 实时目录 中并支持对话。
最小请求
curl --fail-with-body https://enterprise.beefapi.com/v1/chat/completions \
-H "Authorization: Bearer $BEEFAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话介绍你能帮我做什么。"}]}'| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 必填，精确模型 ID |
messages | array | 必填，对话消息，每条有 role 和相应 content |
stream | boolean | 可选；true 使用 SSE |
temperature | number | 可选，仅在模型支持时使用；显式 0 与不传不同 |
tools / tool_choice | array / string 或 object | 可选，工具结构与选择，需所选模型支持 |
开始时只发送必要字段。不要假设所有模型都支持同一种 token 上限、温度或工具参数。历史对话由客户端通过 messages 提供，接口不会仅凭相同 Key 自动记住前一轮聊天。
非流式响应
读取 choices[].message。示例（省略部分字段，内容和用量均为示例）：
{
"id":"chatcmpl_example",
"object":"chat.completion",
"model":"gpt-5.6-sol",
"choices":[{"index":0,"message":{"role":"assistant","content":"我可以帮助你分析信息、编写内容和解决问题。"},"finish_reason":"stop"}],
"usage":{"prompt_tokens":20,"completion_tokens":18,"total_tokens":38}
}finish_reason 和消息内容共同表示完成方式。工具调用时消息可能包含 tool_calls，content 可能为空；不能将空文本直接当作服务错误。工具需要应用执行并回传结果，模型回复不会替你完成本地工具执行。
流式请求
curl --fail-with-body --no-buffer https://enterprise.beefapi.com/v1/chat/completions \
-H "Authorization: Bearer $BEEFAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"写一句欢迎语。"}],"stream":true}'读取 SSE data: 中的 JSON，文本增量位于 choices[].delta.content，流通常以 data: [DONE] 结束。角色、工具参数等事件可能不含文本。使用 SDK 或 SSE 解析器处理跨网络块的事件，不能把每个 HTTP chunk 直接当完整 JSON。