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 回傳不符合內建識別規則（OpenAI、Gemini、Claude 等）的 JSON 內容時，可手動設定 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 訊息，你可以：

使用後置處理器指令碼手動處理資料

聯絡技術支援，針對你正在使用的模型格式提供回饋，以便未來可能納入內建支援

FAQ

如果 SSE 時間軸未顯示訊息，該怎麼辦？

此問題通常發生在伺服器的回應未遵循 SSE 格式指南時。標準 SSE 訊息格式要求：

訊息內容必須接在 data: 之後

每則訊息必須以兩個換行字元分隔（訊息之間有一個空白行）

如需更多 SSE 訊息格式的詳細資訊，請參閱 MDN 文件 - 使用 Server-Sent Events。

了解更多

如何使用 Deepseek API (R1 & V3)？

取得 DeepSeek API 金鑰並偵錯 API 的完整指南。

前置條件#

啟動 SSE 連線#

自動合併訊息#

推理模型支援#

自訂合併規則#

設定 JSONPath 擷取規則#

使用後置處理器指令碼#

FAQ#

了解更多#

前置條件

啟動 SSE 連線

自動合併訊息

推理模型支援

自訂合併規則

設定 JSONPath 擷取規則

使用後置處理器指令碼

FAQ

了解更多