Support model_version param for turn detection in realtime agents sdk (#2450)

Author: jhills20

src/agents/realtime/config.py

@@ -100,6 +100,9 @@ class RealtimeTurnDetectionConfig(TypedDict):
     idle_timeout_ms: NotRequired[int]
     """Threshold for server-vad to trigger a response if the user is idle for this duration."""
 
+    model_version: NotRequired[str]
+    """Optional backend-specific VAD model identifier."""
+
 
 class RealtimeAudioInputConfig(TypedDict, total=False):
     """Configuration for audio input in realtime sessions."""

src/agents/realtime/openai_realtime.py

@@ -998,6 +998,7 @@ def _normalize_turn_detection_config(config: object) -> object:
             "prefixPaddingMs": "prefix_padding_ms",
             "silenceDurationMs": "silence_duration_ms",
             "idleTimeoutMs": "idle_timeout_ms",
+            "modelVersion": "model_version",
         }
         for camel_key, snake_key in key_map.items():
             if camel_key in normalized and snake_key not in normalized:

tests/realtime/test_openai_realtime.py

@@ -821,6 +821,7 @@ def test_session_config_respects_audio_block_and_output_modalities(self, model):
                         "type": "server_vad",
                         "createResponse": True,
                         "silenceDurationMs": 450,
+                        "modelVersion": "default",
                     },
                 },
                 "output": {
@@ -848,7 +849,9 @@ def test_session_config_respects_audio_block_and_output_modalities(self, model):
         )
         assert turn_detection_mapping["create_response"] is True
         assert turn_detection_mapping["silence_duration_ms"] == 450
+        assert turn_detection_mapping["model_version"] == "default"
         assert "silenceDurationMs" not in turn_detection_mapping
+        assert "modelVersion" not in turn_detection_mapping
 
     @pytest.mark.asyncio
     async def test_handle_error_event_success(self, model):