跳到主要内容

调试

Server-Sent Events（SSE） 调试功能 👋

本篇文档帮助你快速理解如何调试基于 text/event-stream 协议的接口，如 OpenAI、DeepSeek 等流式响应模型。

什么是 SSE ？

SSE（Server-Sent Events）是一种基于 HTTP 的单向通信协议，允许服务器向客户端持续推送消息。它非常适合用于 AI 模型的流式响应场景（如OpenAI、DeepSeek等），一边生成一边输出文本。

开始调试 Server-Sent Events（SSE）​

  1. 新建请求：点击 新建 按钮，选择 Event Stream Request ，通过粘贴 cURL 或手动填写 AI 模型地址的方式进行编辑接口（以Deepseek举例）： image.png

  2. 发送并查看响应结果：发送请求后，可在响应面板的 实时响应 视图中查看实时消息内容，包含左侧的 消息事件流 和右侧的 消息聚合（自然语言的流式响应） 。 image.png

事件流​

当接口返回流式数据时，响应区域左侧会自动以事件流的形式进行流式响应展示，每接收到一条 SSE 消息，将作为一个事件节点实时追加在面板中。

点击 任意事件条目 ，右侧将自动切换至「事件流」Tab，显示该条消息的详细内容。 image.png

消息聚合机制说明​

当接口返回流式数据时，响应区域右侧会自动识别主流 AI 模型的流式响应格式，并将消息内容自动拼接展示，无需手动干预。

image.png

✅ 默认内置的消息内容提取格式​

  • OpenAI 格式（兼容绝大多数主流模型）
  • Gemini 格式
  • Claude 格式
  • DeepSeek 格式
  • 豆包 格式
  • KIMI 格式
  • Ollama Generate 格式
  • Ollama Chat 格式
  • 自定义 JSONPath 提取

⚠️ 非内置格式处理​

当 AI 模型返回数据不符合内置格式时，可通过手动配置 JSONPath 表达式 提取目标字段。

配置示例：DeepSeek 内容提取，下方展示为美化的 SSE 消息结构​
{
    "id": "5a69843e-ca50-4127-8228-927ffbddfdf7",
    "object": "chat.completion.chunk",
    "created": 1747828085,
    "model": "deepseek-chat",
    "system_fingerprint": "fp_8834569eaa_prod0425fp8",
    "choices": [
        {
            "index": 0,
            "delta": {
                "content": "SS"
            },
            "logprobs": null,
            "finish_reason": null
        }
    ]
}

我们希望从中提取 "content": "SS" 这个字段进行拼接，可以配置如下 JSONPath：$.choices[0].delta.content

📖 JSONPath 表达式解析：

$：表示 JSON 的根节点

choices[0]：表示选择 choices 数组的第一个元素

delta.content：表示在该元素下 delta 对象的 content 字段

提取后，拼接结果如下： image.png

常见问题
  1. 消息未自动拼接？ 接口返回格式可能不符合内置识别规范（如 OpenAI / Claude 等）。 ✅ 建议使用 JSONPath 自定义提取规则手动配置。
  1. 实时响应中无响应信息？ 检查请求参数中是否携带了 "stream": true 字段。 消息格式不标准：缺少 data: 前缀或换行分隔。
  1. JSONPath 无法提取内容？ 路径配置有误，或返回内容不是标准 JSON。 ✅ 可使用在线工具：https://jsonpath.com 等其他在线工具进行结构测试。验证提取规则是否正确。

如果你的模型格式不在内置支持范围内，欢迎反馈，我们会持续迭代支持更多模型格式。