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 イベントとして自動的に解析します。

リアルタイムレスポンスを表示する

レスポンスパネルの タイムライン ビューでリアルタイムメッセージを表示します。ここでは、コンテンツが自然言語形式で表示されます。

メッセージの自動マージ

バージョン要件

自動マージ機能を使用するには、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 メッセージの場合は、次のことができます。

post processor scripts を使用してデータを手動で処理する

使用しているモデル形式についてフィードバックを提供し、将来的な組み込みサポートの可能性について technical support に問い合わせる

FAQ

SSE タイムラインにメッセージが表示されない場合はどうすればよいですか？

この問題は通常、サーバーのレスポンスが SSE 形式のガイドラインに従っていない場合に発生します。標準の SSE メッセージ形式では、次のことが必要です。

メッセージコンテンツは data: の後に記述する必要があります

各メッセージは 2 つの改行文字（メッセージ間の空行）で区切る必要があります

SSE メッセージ形式の詳細については、MDN ドキュメント - Server-Sent Events の使用を参照してください。

さらに詳しく

Deepseek API（R1 & V3）の使用方法

DeepSeek API キーの取得と API のデバッグに関する完全ガイドです。

前提条件#

SSE 接続の開始#

メッセージの自動マージ#

推論モデルのサポート#

マージルールのカスタマイズ#

JSONPath 抽出ルールを設定する#

ポストプロセッサスクリプトを使用する#

FAQ#

さらに詳しく#

前提条件

SSE 接続の開始

メッセージの自動マージ

推論モデルのサポート

マージルールのカスタマイズ

JSONPath 抽出ルールを設定する

ポストプロセッサスクリプトを使用する

FAQ

さらに詳しく