WebSocket接続はどのくらいの時間オープンにしておくことができますか？

WebSocket接続は60分に制限されています。この制限に達したら、再接続して新しいWebSocket接続を作成し、続行する必要があります。

WebSocketモードは、Zero Data Retention (ZDR) と store=false と互換性がありますか？

はい、WebSocketモードは、Zero Data Retention (ZDR) と store=false の両方の設定と互換性があります。以前のレスポンスの状態をメモリ内のみに保持し、ディスクに書き込まないためです。

WebSocketモードでの継続はどのように機能しますか？

WebSocketモードでは、サービスは接続ローカルのインメモリキャッシュに1つ前のレスポンスの状態（最新のレスポンス）を保持します。実行を継続するには、別の response.create を、previous_response_id を前のレスポンスIDに設定し、新しいアイテムのみを含む入力とともに送信します。

1つのWebSocket接続で複数のレスポンスを同時に実行できますか？

いいえ、単一のWebSocket接続は複数の response.create メッセージを受信できますが、それらを順番に（一度に1つのインフライトレスポンス）実行します。並列実行には、複数の接続を使用する必要があります。

WebSocketモードでターンが失敗するとどうなりますか？

ターンが失敗した場合（4xxまたは5xxエラー）、サービスは参照されている previous_response_id を接続ローカルキャッシュから削除します。これにより、その失敗した継続のために古いキャッシュされた状態が再利用されるのを防ぎます。

OpenAI WebSocket Mode for Responses API

WebsiteContact for PricingAI DevOps Assistant AI API Design

Responses API用のOpenAI WebSocketモードは、増分入力と効率的なツール呼び出し処理を備えた、低レイテンシで長時間の実行エージェントワークフローを可能にする永続的な接続ベースのソリューションです。

ウェブサイトを訪問

このツールを宣伝する

https://developers.openai.com/api/docs/guides/websocket-mode?ref=producthunt&utm_source=aipure

概要
動画
代替案

製品情報

更新日:2026年03月02日

OpenAI WebSocket Mode for Responses APIとは

OpenAI WebSocketモードは、頻繁なモデルとツールのインタラクションを必要とする複雑なAIワークフロー向けに設計された、Responses API内の特殊なトランスポートモードです。/v1/responsesエンドポイントへの永続的なWebSocket接続を確立し、開発者がアプリケーションとOpenAIのモデル間の継続的な通信を維持できるようにします。このモードは、ゼロデータ保持（ZDR）およびstore=falseオプションと完全に互換性があり、データプライバシー要件を維持しながら、ステートフルおよびステートレスの実装の両方に適しています。

OpenAI WebSocket Mode for Responses APIの主な機能

OpenAI WebSocket モード (Responses API) は、長期にわたる、ツール呼び出しを多用するワークフローのために設計された特殊な通信プロトコルです。接続ローカルのインメモリキャッシュに最新の応答を保持し、クライアントが毎回完全なコンテキストを再送信する代わりに、previous_response_id を使用して差分入力のみを送信できるようにします。このモードは、Zero Data Retention (ZDR) および store=false オプションとの互換性を維持しながら、20 以上のツール呼び出しを含むワークフローのエンドツーエンドの実行速度を最大 40% 向上させることができます。

永続的な接続: 最大 60 分間、単一の WebSocket 接続を維持し、インタラクションごとに新しい HTTP 接続を確立する必要をなくします

差分入力処理: 会話コンテキスト全体を再送信する代わりに、新しい入力項目と previous_response_id のみを送信できます

接続ローカルキャッシュ: Zero Data Retention の要件との互換性を維持しながら、高速アクセスを実現するために、最新の応答状態をメモリに保持します

オプションのウォームアップリクエスト: サーバー側の状態を事前に準備し、後続のターンのレイテンシを削減するために、generate:false リクエストをサポートします

OpenAI WebSocket Mode for Responses APIのユースケース

AI を活用したコード開発: AI エージェントがファイルの読み取り、コードの記述、テストのために複数の連続したツール呼び出しを行う効率的なコーディング支援ワークフローを可能にします

複雑な自動化パイプライン: 複数のツールインタラクションとオーケストレーションステップを必要とする、レイテンシが低減された長期的な自動化タスクをサポートします

多段階推論システム: AI が複数の連続した意思決定とツール呼び出しを行う必要がある複雑な問題解決シナリオを促進します

リアルタイムエージェントワークフロー: ユーザー入力に応答して複数のアクションを実行しながら、コンテキストを維持する必要があるインタラクティブな AI エージェントを強化します

メリット

ツールを多用するワークフローのレイテンシを大幅に削減します (最大 40% 高速化)

差分更新のみを送信することで、帯域幅の使用量を削減します

ZDR や store=false などの既存のセキュリティ機能と互換性があります

デメリット

接続時間が 60 分に制限されており、再接続が必要

単一接続内での並列応答処理はサポートされていません

接続管理とリカバリのための追加のエラー処理が必要です

OpenAI WebSocket Mode for Responses APIの使い方

必要な依存関係のインストール: Python用のwebsocket-clientライブラリをインストールします：pip install websocket-client

ライブラリのインポート: 必要なライブラリをインポートします：websocket、json、および環境変数のためのos

WebSocket接続の作成: APIキーをヘッダーに含めて、OpenAIエンドポイント'wss://api.openai.com/v1/responses'へのWebSocket接続を確立します

初期レスポンス作成イベントの送信: モデル、storeフラグ、初期入力メッセージ、およびツール配列を含む最初のresponse.createイベントを送信します。streamまたはbackgroundフィールドは含めないでください

オプション：リクエスト状態のウォームアップ: オプションで、出力を生成せずに今後のリクエストのためにサーバーの状態を準備するために、generate:falseでresponse.createを送信します

会話の継続: previous_response_idと新しい入力項目（ツール出力、新しいメッセージ）のみを含む後続のresponse.createイベントを送信します

接続制限の処理: 60分間の接続制限を監視し、必要に応じて再接続します。一度に処理できるレスポンスは1つだけです

再接続の処理: 再接続時：previous_response_id（store=trueの場合）で続行するか、新しいレスポンスを開始するか、/responses/compactから圧縮されたコンテキストを使用します

エラーの処理: previous_response_not_foundおよびwebsocket_connection_limit_reachedエラーを適切に処理します

接続の終了: 使用が終了したら、WebSocket接続を閉じます：ws.close()

OpenAI WebSocket Mode for Responses APIのよくある質問

WebSocketモードは、OpenAIのResponses APIの機能で、長時間実行される、ツール呼び出しが頻繁なワークフローのために永続的な接続を可能にします。主な利点としては、ターンごとの継続オーバーヘッドの削減と、長いチェーン全体でのエンドツーエンドのレイテンシの改善が挙げられます。20回以上のツール呼び出しを含むワークフローでは、エンドツーエンドの実行を最大40%高速化できます。