4Z API

AI 返回字段:思考相关

部分推理 / 思考类模型会在响应中附带「思考」内容(reasoning / thinking)。不同厂商字段名不同,接入时请按模型文档解析,不要假定只有一种结构。

常见形态

1. OpenAI 兼容 · reasoning_content / reasoning

部分兼容接口在 choices[].message 中增加:

{
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "最终回答…",
        "reasoning_content": "中间推理过程…"
      }
    }
  ]
}
  • 展示给终端用户:通常只用 content。
  • 调试 / 审计:可记录 reasoning_content(注意隐私与成本日志体积)。

2. 独立 thinking / thought 块

部分原生协议(如部分 Gemini / Anthropic 风格适配)会把思考放在独立 part 或独立字段中。请以对应平台 OpenAPI 的 response schema 为准。

3. 流式(SSE)

流式场景下思考与正文可能分多帧到达:

  1. 先收到 reasoning / thinking delta
  2. 再收到最终 content delta
  3. 以 data: [DONE] 或厂商约定结束帧收尾

客户端应按帧累加对应字段,避免把思考拼进最终回答展示区。

计费与可见性

项 说明
Token 计量 思考内容通常计入输入或输出 token(以模型/渠道说明为准)
空思考 部分模型可关闭思考或思考为空;不要因字段缺失直接报错
安全 不要把完整思考日志暴露给不可信前端

接入建议

  1. 先看目标模型在门户对应平台页的 response 示例。
  2. UI 默认折叠思考区,仅展示 content。
  3. 若字段缺失,回退为只渲染 content,不要阻断主流程。