Add keyterms and no_verbatim to Scribe realtime API

Bias the Scribe model towards specific terms via repeated `keyterms`
query params and remove filler words/disfluencies with `no_verbatim`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: kraenhansen

src/elevenlabs/realtime/scribe.py

@@ -66,6 +66,8 @@ class RealtimeAudioOptions(typing.TypedDict, total=False):
     min_silence_duration_ms: int
     language_code: str
     include_timestamps: bool
+    keyterms: typing.List[str]
+    no_verbatim: bool
 
 
 class RealtimeUrlOptions(typing.TypedDict, total=False):
@@ -92,6 +94,8 @@ class RealtimeUrlOptions(typing.TypedDict, total=False):
     min_silence_duration_ms: int
     language_code: str
     include_timestamps: bool
+    keyterms: typing.List[str]
+    no_verbatim: bool
 
 
 class ScribeRealtime:
@@ -196,6 +200,8 @@ async def _connect_audio(self, options: RealtimeAudioOptions) -> RealtimeConnect
         min_silence_duration_ms = options.get("min_silence_duration_ms")
         language_code = options.get("language_code")
         include_timestamps = options.get("include_timestamps", False)
+        keyterms = options.get("keyterms")
+        no_verbatim = options.get("no_verbatim")
 
         if not audio_format or not sample_rate:
             raise ValueError("audio_format and sample_rate are required for manual audio mode")
@@ -211,6 +217,8 @@ async def _connect_audio(self, options: RealtimeAudioOptions) -> RealtimeConnect
             min_silence_duration_ms=min_silence_duration_ms,
             language_code=language_code,
             include_timestamps=include_timestamps,
+            keyterms=keyterms,
+            no_verbatim=no_verbatim,
         )
 
         # Connect to WebSocket
@@ -243,6 +251,8 @@ async def _connect_url(self, options: RealtimeUrlOptions) -> RealtimeConnection:
         min_silence_duration_ms = options.get("min_silence_duration_ms")
         language_code = options.get("language_code")
         include_timestamps = options.get("include_timestamps", False)
+        keyterms = options.get("keyterms")
+        no_verbatim = options.get("no_verbatim")
 
         if not url:
             raise ValueError("url is required for URL mode")
@@ -262,6 +272,8 @@ async def _connect_url(self, options: RealtimeUrlOptions) -> RealtimeConnection:
             min_silence_duration_ms=min_silence_duration_ms,
             language_code=language_code,
             include_timestamps=include_timestamps,
+            keyterms=keyterms,
+            no_verbatim=no_verbatim,
         )
 
         # Connect to WebSocket
@@ -364,7 +376,9 @@ def _build_websocket_url(
         min_speech_duration_ms: typing.Optional[int] = None,
         min_silence_duration_ms: typing.Optional[int] = None,
         language_code: typing.Optional[str] = None,
-        include_timestamps: typing.Optional[bool] = None
+        include_timestamps: typing.Optional[bool] = None,
+        keyterms: typing.Optional[typing.List[str]] = None,
+        no_verbatim: typing.Optional[bool] = None,
     ) -> str:
         """Build the WebSocket URL with query parameters"""
         # Extract base domain
@@ -390,6 +404,11 @@ def _build_websocket_url(
             params.append(f"language_code={language_code}")
         if include_timestamps is not None:
             params.append(f"include_timestamps={str(include_timestamps).lower()}")
+        if keyterms is not None:
+            for term in keyterms:
+                params.append(f"keyterms={term}")
+        if no_verbatim is not None:
+            params.append(f"no_verbatim={str(no_verbatim).lower()}")
 
         query_string = "&".join(params)
         return f"{base}/v1/speech-to-text/realtime?{query_string}"

tests/test_stt_realtime.py

@@ -95,6 +95,51 @@ def test_url_converts_http_to_ws(self):
 
         assert url.startswith("ws://localhost:8080")
 
+    def test_includes_keyterms_as_repeated_query_params(self):
+        """Test that keyterms are included as repeated query params"""
+        url = self.scribe._build_websocket_url(
+            model_id="scribe_v2_realtime",
+            audio_format="pcm_16000",
+            commit_strategy="manual",
+            keyterms=["ElevenLabs", "Scribe"],
+        )
+
+        assert "keyterms=ElevenLabs" in url
+        assert "keyterms=Scribe" in url
+
+    def test_includes_no_verbatim_true(self):
+        """Test that no_verbatim=true is included when set to True"""
+        url = self.scribe._build_websocket_url(
+            model_id="scribe_v2_realtime",
+            audio_format="pcm_16000",
+            commit_strategy="manual",
+            no_verbatim=True,
+        )
+
+        assert "no_verbatim=true" in url
+
+    def test_includes_no_verbatim_false(self):
+        """Test that no_verbatim=false is included when set to False"""
+        url = self.scribe._build_websocket_url(
+            model_id="scribe_v2_realtime",
+            audio_format="pcm_16000",
+            commit_strategy="manual",
+            no_verbatim=False,
+        )
+
+        assert "no_verbatim=false" in url
+
+    def test_omits_keyterms_and_no_verbatim_when_not_specified(self):
+        """Test that keyterms and no_verbatim are omitted when not specified"""
+        url = self.scribe._build_websocket_url(
+            model_id="scribe_v2_realtime",
+            audio_format="pcm_16000",
+            commit_strategy="manual",
+        )
+
+        assert "keyterms" not in url
+        assert "no_verbatim" not in url
+
 
 class TestConnectValidation:
     """Tests for connect method validation"""