SSE 调试

服务器发送事件（Server-Sent Events，SSE）是一种基于 HTTP 协议构建的实时通信技术，允许服务器通过持久的单向连接向客户端推送更新。SSE 通常用于流式传输 AI 模型响应、实时通知和实时数据馈送。

借助 SSE，用户可以即时看到推理模型的思考过程，以及从服务器流式传输的生成内容。

前提条件

Apidog 版本 2.3.10 或更高版本

返回 Content-Type: text/event-stream 的 HTTP 端点

发起 SSE 连接

创建新端点

在 Apidog 中，创建一个新的 HTTP 项目，添加一个新端点，并输入 AI 模型端点或 SSE 服务器的 URL。

发送请求

发送请求后，如果响应头部 Content-Type 包含 text/event-stream，Apidog 会自动将返回的数据解析为 SSE 事件。

查看实时响应

在响应面板的 Timeline 视图中查看实时消息，内容会以自然语言格式显示。

自动合并消息

版本要求

自动合并功能需要 Apidog 版本 2.7.14 或更高版本。

Apidog 内置支持主流 AI 模型，并会自动识别和合并以下格式的流式响应：

格式	描述
OpenAI API Compatible	绝大多数 AI 模型提供商使用的格式
Gemini API Compatible	Google 的 Gemini 模型格式
Claude API Compatible	Anthropic 的 Claude 模型格式
Ollama API Compatible	用于本地部署 AI 模型的 JSON Streaming（NDJSON）格式

当 AI 模型的响应匹配以上任意格式时，Apidog 会自动将消息片段合并为完整回复，并以 Markdown 格式预览内容。

推理模型支持

对于某些模型，例如 DeepSeek R1，Apidog 会在时间线中显示模型的思考过程，从而更清晰、更直观地展示 AI 推理。

自定义合并规则

如果 Auto-Merge 功能无法正常工作，你可以根据具体使用场景配置自定义提取规则。

配置 JSONPath 提取规则

当 SSE 返回的 JSON 内容不符合内置识别规则（OpenAI、Gemini、Claude 等）时，可以手动配置 JSONPath 来提取所需内容。

SSE 响应示例：

data: {"choices":[{"index":0,"message":{"role":"assistant","content":"H"},"logprobs":null,"finish_reason":"stop"}]}

data: {"choices":[{"index":0,"message":{"role":"assistant","content":"i"},"logprobs":null,"finish_reason":"stop"}]}

JSONPath 配置：

要提取 content 字段，请使用：

$.choices[0].message.content

JSONPath 解析：

组件	描述
`$`	JSON 对象的根
`choices[0]`	`choices` 数组的第一个元素
`message.content`	`message` 对象下的 `content` 属性

提取结果：

Hi

使用后置处理器脚本

对于非 JSON 的 SSE 消息，你可以：

使用 post processor scripts 手动处理数据

联系 technical support，反馈你正在使用的模型格式，以便评估是否提供潜在的内置支持

FAQ

如果 SSE 时间线不显示消息，该怎么办？

当服务器的响应不遵循 SSE 格式规范时，通常会出现此问题。标准 SSE 消息格式要求：

消息内容必须位于 data: 之后

每条消息必须用两个换行符分隔（消息之间有一个空行）

有关 SSE 消息格式的更多详细信息，请参阅 MDN 文档 - 使用服务器发送事件。

了解更多

如何使用 Deepseek API（R1 和 V3）？

获取 DeepSeek API 密钥并调试 API 的完整指南。

前提条件#

发起 SSE 连接#

自动合并消息#

推理模型支持#

自定义合并规则#

配置 JSONPath 提取规则#

使用后置处理器脚本#

FAQ#

了解更多#

前提条件

发起 SSE 连接

自动合并消息

推理模型支持

自定义合并规则

配置 JSONPath 提取规则

使用后置处理器脚本

FAQ

了解更多