RealtimeAPIEvents
Constants
ConnectorInformation
Contains information about connector.
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemAdded
Sent by the server when an Item is added to the default Conversation. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/added
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemDeleted
Returned when an item in the conversation is deleted by the client with a conversation.item.delete event. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/deleted
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemDone
Returned when a conversation item is finalized. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemInputAudioTranscriptionCompleted
This event is the output of audio transcription for user audio written to the user audio buffer. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/input_audio_transcription/completed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemInputAudioTranscriptionDelta
Returned when the text value of an input audio transcription content part is updated with incremental transcription results. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/input_audio_transcription/delta
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemInputAudioTranscriptionFailed
Returned when input audio transcription is configured, and a transcription request for a user message failed. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/input_audio_transcription/failed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemInputAudioTranscriptionSegment
Returned when an input audio transcription segment is identified for an item. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/input_audio_transcription/segment
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemRetrieved
Returned when a conversation item is retrieved with conversation.item.retrieve. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/retrieved
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ConversationItemTruncated
Returned when an earlier assistant audio message item is truncated by the client with a conversation.item.truncate event. https://platform.openai.com/docs/api-reference/realtime-server-events/conversation/item/truncated
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
Error
Returned when an error occurs, which could be a client problem or a server problem. https://platform.openai.com/docs/api-reference/realtime-server-events/error
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
HTTPResponse
The HTTP response event.
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
InputAudioBufferCleared
Returned when the input audio buffer is cleared by the client with an input_audio_buffer.clear event. https://platform.openai.com/docs/api-reference/realtime-server-events/input_audio_buffer/cleared
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
InputAudioBufferCommited
Returned when an input audio buffer is committed. https://platform.openai.com/docs/api-reference/realtime-server-events/input_audio_buffer/committed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
InputAudioBufferSpeechStarted
Sent by the server when in server_vad mode to indicate that speech has been detected in the audio buffer. https://platform.openai.com/docs/api-reference/realtime-server-events/input_audio_buffer/speech_started
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
InputAudioBufferSpeechStopped
Returned in server_vad mode when the server detects the end of speech in the audio buffer. https://platform.openai.com/docs/api-reference/realtime-server-events/input_audio_buffer/speech_stopped
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
InputAudioBufferTimeoutTriggered
Returned when the Server VAD timeout is triggered for the input audio buffer. https://platform.openai.com/docs/api-reference/realtime-server-events/input_audio_buffer/timeout_triggered
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
MCPListToolsCompleted
Returned when listing MCP tools has completed for an item. https://platform.openai.com/docs/api-reference/realtime-server-events/mcp_list_tools/completed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
MCPListToolsFailed
Returned when listing MCP tools has failed for an item. https://platform.openai.com/docs/api-reference/realtime-server-events/mcp_list_tools/failed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
MCPListToolsInProgress
Returned when listing MCP tools is in progress for an item. https://platform.openai.com/docs/api-reference/realtime-server-events/mcp_list_tools/in_progress
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
RateLimitsUpdated
Emitted at the beginning of a Response to indicate the updated rate limits. https://platform.openai.com/docs/api-reference/realtime-server-events/rate_limits/updated
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseContentPartAdded
Returned when a new content part is added to an assistant message item during response generation. https://platform.openai.com/docs/api-reference/realtime-server-events/response/content_part/added
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseContentPartDone
Returned when a content part is done streaming in an assistant message item. https://platform.openai.com/docs/api-reference/realtime-server-events/response/content_part/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseCreated
Returned when a new Response is created. https://platform.openai.com/docs/api-reference/realtime-server-events/response/created
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseDone
Returned when a Response is done streaming. https://platform.openai.com/docs/api-reference/realtime-server-events/response/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseFunctionCallArgumentsDelta
Returned when the model-generated function call arguments are updated. https://platform.openai.com/docs/api-reference/realtime-server-events/response/function_call_arguments/delta
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseFunctionCallArgumentsDone
Returned when the model-generated function call arguments are done streaming. https://platform.openai.com/docs/api-reference/realtime-server-events/response/function_call_arguments/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseMCPCallArgumentsDelta
Returned when MCP tool call arguments are updated during response generation. https://platform.openai.com/docs/api-reference/realtime-server-events/response/mcp_call_arguments/delta
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseMCPCallArgumentsDone
Returned when MCP tool call arguments are finalized during response generation. https://platform.openai.com/docs/api-reference/realtime-server-events/response/mcp_call_arguments/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseMCPCallCompleted
Returned when an MCP tool call has completed successfully. https://platform.openai.com/docs/api-reference/realtime-server-events/response/mcp_call/completed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseMCPCallFailed
Returned when an MCP tool call has failed. https://platform.openai.com/docs/api-reference/realtime-server-events/response/mcp_call/failed
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseMCPCallInProgress
Returned when an MCP tool call has started and is in progress. https://platform.openai.com/docs/api-reference/realtime-server-events/response/mcp_call/in_progress
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputAudioDone
Returned when the model-generated audio is done. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_audio/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputAudioTranscriptionDelta
Returned when the model-generated transcription of audio output is updated. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_audio_transcript/delta
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputAudioTranscriptionDone
Returned when the model-generated transcription of audio output is done streaming. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_audio_transcript/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputItemAdded
Returned when a new Item is created during Response generation. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_item/added
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputItemDone
Returned when an Item is done streaming. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_item/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputTextDelta
Returned when the text value of an "output_text" content part is updated. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_text/delta
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
ResponseOutputTextDone
Returned when the text value of an "output_text" content part is done streaming. https://platform.openai.com/docs/api-reference/realtime-server-events/response/output_text/done
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
SessionCreated
Returned when a Session is created. https://platform.openai.com/docs/api-reference/realtime-server-events/session/created
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
SessionUpdated
Returned when a session is updated with a session.update event, unless there is an error. https://platform.openai.com/docs/api-reference/realtime-server-events/session/updated
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
Unknown
The unknown event.
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.
WebSocketError
The WebSocket error response event.
Parameters
client:
The OpenAI.Beta.RealtimeAPIClient instance.
data:
Object
OptionalThe event's data.