Skip to content

Add keyterms and no_verbatim to Scribe realtime API#778

Merged
kraenhansen merged 1 commit into
mainfrom
kh/add-keyterms-no-verbatim-scribe-realtime
Apr 30, 2026
Merged

Add keyterms and no_verbatim to Scribe realtime API#778
kraenhansen merged 1 commit into
mainfrom
kh/add-keyterms-no-verbatim-scribe-realtime

Conversation

@kraenhansen
Copy link
Copy Markdown
Member

@kraenhansen kraenhansen commented Apr 27, 2026

Summary

  • Add keyterms option (list[str]) to bias the Scribe model towards specific terms. Passed as repeated query params on the WebSocket URL.
  • Add no_verbatim option (bool) to remove filler words, false starts, and disfluencies from transcripts.
  • Both options added to RealtimeAudioOptions and RealtimeUrlOptions TypedDicts and threaded through to _build_websocket_url.

Python equivalent of elevenlabs/elevenlabs-js#376.

Test plan

  • Unit tests for keyterms repeated query params
  • Unit tests for no_verbatim true/false query param
  • Unit test confirming params omitted when not specified
  • All files edited are in .fernignore (hand-maintained)
  • All 17 tests pass
  • Manual verification with a real Scribe realtime session using keyterms
  • Manual verification with no_verbatim=True

🤖 Generated with Claude Code


Note

Low Risk
Only adds optional query parameters and tests, with minimal impact on existing behavior unless callers start supplying the new options.

Overview
Extends Scribe realtime connection options with keyterms (list of bias terms) and no_verbatim (boolean transcript cleanup) for both manual-audio and URL-streaming modes.

Threads these values through connect() into _build_websocket_url, encoding keyterms as repeated keyterms=<term> query params and no_verbatim as a lowercased boolean when provided, and adds unit tests verifying correct inclusion and omission.

Reviewed by Cursor Bugbot for commit 14583cd. Bugbot is set up for automated code reviews on this repo. Configure here.

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 6efae06. Configure here.

Comment thread src/elevenlabs/realtime/scribe.py Outdated
Copy link
Copy Markdown
Collaborator

@PaulAsjes PaulAsjes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, but that bugbot comment should be addressed.

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>
@kraenhansen kraenhansen force-pushed the kh/add-keyterms-no-verbatim-scribe-realtime branch from 6efae06 to 14583cd Compare April 29, 2026 11:53
@kraenhansen kraenhansen merged commit f785d33 into main Apr 30, 2026
6 checks passed
@kraenhansen kraenhansen deleted the kh/add-keyterms-no-verbatim-scribe-realtime branch April 30, 2026 10:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants