From c44c32f15f6ca4861888ffc740f5ed1e6d0efe6b Mon Sep 17 00:00:00 2001 From: Ettore Di Giacinto Date: Tue, 13 Oct 2026 08:44:29 +0000 Subject: [PATCH] docs(realtime): describe a client response whose commit failed Document the failed and cancelled outcomes of a response.create that waits for the preceding input_audio_buffer.commit. Assisted-by: Claude Code:claude-sonnet-5-5 Signed-off-by: Ettore Di Giacinto --- docs/content/features/openai-realtime.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/content/features/openai-realtime.md b/docs/content/features/openai-realtime.md index 290f7e9bf..7f3f68b83 100644 --- a/docs/content/features/openai-realtime.md +++ b/docs/content/features/openai-realtime.md @@ -131,6 +131,7 @@ For client-controlled turns, set `turn_detection` to `null` in `session.update`. After sending audio, send `input_audio_buffer.commit`, followed by `response.create`. If transcription is still running, the response waits for the committed user item before starting the LLM. A standalone `response.create` with no pending client commit starts without this wait. +If the commit produces no user item (transcription error, empty transcript or a voice gate rejection), the server does not run the LLM. It sends `response.done` with status `failed` and an `input_not_committed` error, after the error event that describes the cause. If you cancel the response while it waits, you get `response.done` with status `cancelled`. Turn detection decides when the user has finished speaking and the pipeline should respond. Two modes are supported, matching the OpenAI session schema: