Speech Revolutions — Python SDK

Official Python client for the Speech Revolutions speech-to-text API.

Install

pip install speechrevolutions

For console progress bars, install the optional tqdm extra:

pip install "speechrevolutions[progress]"

Quick start

from speechrevolutions import SpeechRevolutions

client = SpeechRevolutions()  # reads SPEECHREVOLUTIONS_API_KEY
result = client.transcribe("meeting.mp3", speaker_labels=True)
print(result.text)

for u in result.utterances:
    print(f"Speaker {u.speaker}: {u.text}")

Async

from speechrevolutions import AsyncSpeechRevolutions

async with AsyncSpeechRevolutions() as client:
    result = await client.transcribe("meeting.mp3", speaker_labels=True)
    print(result.text)

From a URL (Deepgram-style)

result = client.transcribe_url("https://example.com/audio.mp3")
# or
result = client.transcribe("https://example.com/audio.mp3")

Options as kwargs or config object

# kwargs (ElevenLabs / Deepgram style). `diarize` is an alias for `speaker_labels`.
result = client.transcribe("a.mp3", diarize=True, output_type="json")

# config object (AssemblyAI style)
from speechrevolutions import TranscribeOptions
result = client.transcribe("a.mp3", options=TranscribeOptions(speaker_labels=True))

Defaults: output_type="json", word_timestamps, speaker_labels, nltk all True, tier="standard", custom_vocabulary=None, language=None.

language pins an ISO 639-1 code (e.g. language="ru") and skips language detection; None (or "auto") detects it automatically. Pinning the wrong language makes the model translate into it (Russian audio pinned to "en" comes back as English), and an unsupported code is rejected with HTTP 422.

Live progress

Unlike AssemblyAI/Deepgram (which give no percentage for pre-recorded audio), you get real-time progress — for both the file upload and the transcription — as a console bar, a callback, or both.

# 1. Console bars (uses tqdm if installed: pip install "speechrevolutions[progress]")
#    Shows an "Uploading" byte bar, then a "Transcribing" bar.
result = client.transcribe("meeting.mp3", progress=True)

# 2. Programmatic — read event.percent (0–100) to drive your own UI / API
def on_progress(event):        # transcription
    print(event.percent, event.step)      # e.g. 50.0 "chunk:0"

def on_upload(event):          # upload (event.step == "upload")
    print("upload", event.percent)

result = client.transcribe(
    "meeting.mp3",
    on_progress=on_progress,
    on_upload_progress=on_upload,
)

progress=True and the callbacks compose — the bars render and your callbacks still fire for every event.

Result shape

Default output_type is json. The SDK parses it into a transcript-first object:

dg = result.to_deepgram()
print(dg["results"]["channels"][0]["alternatives"][0]["transcript"])

Webhooks & retrieving results later

submit() uploads and enqueues a job and returns its id without waiting — ideal for batch/background work. Collect the result later via a webhook (callback_url, a signed POST — verify X-SR-Signature: sha256=… against the raw bytes) or by polling:

job_id = client.submit("meeting.mp3")       # returns immediately, no waiting
# ...or notify a webhook instead of polling:
client.transcribe("meeting.mp3", callback_url="https://you.example.com/hook")

status = client.get_job_status(job_id)      # .status: processing|completed|failed
if status.is_completed:
    result = client.get_transcript(job_id)  # downloads + parses
page = client.list_jobs(limit=50)           # {"jobs": [...], "next_before": ...}

The signature is HMAC-SHA256 over the raw request body, keyed with your account's own webhook signing secret — find it under API Keys in the console. Compare it with a constant-time function, and verify against the bytes you received rather than a re-serialised copy. Worked receivers for Python, Node, Go and C# are in the webhooks guide.

See examples/ for a full submit/poll/webhook walkthrough.

Robustness

SpeechRevolutions(max_retries=3, retry_backoff=0.5, proxies={"https": "..."}). Transient 429/5xx/network errors are retried (honoring Retry-After). Errors are typed (RateLimitError, AuthenticationError, …) and carry .status_code and .request_id for correlating with support.

Auth

export SPEECHREVOLUTIONS_API_KEY=stt_...

Or SpeechRevolutions(api_key="stt_...").

Other languages

Speech Revolutions also publishes SDKs for JavaScript/TypeScript, Go, and C#/.NET — see docs.speechrevolutions.com for a cross-language feature comparison.

License

MIT