Coding in the Deepgram Python SDK for Transcription, Text-to-Speech, Async Audio Processing, and Text Intelligence.

!pip install deepgram-sdk httpx --quiet


import os, asyncio, textwrap, urllib.request
from getpass import getpass
from deepgram import DeepgramClient, AsyncDeepgramClient
from deepgram.core.api_error import ApiError
from IPython.display import Audio, display


DEEPGRAM_API_KEY = getpass(" Enter your Deepgram API key: ")
os.environ["DEEPGRAM_API_KEY"] = DEEPGRAM_API_KEY


client       = DeepgramClient(api_key=DEEPGRAM_API_KEY)
async_client = AsyncDeepgramClient(api_key=DEEPGRAM_API_KEY)


AUDIO_URL  = "
AUDIO_PATH = "/tmp/sample.wav"
urllib.request.urlretrieve(AUDIO_URL, AUDIO_PATH)


def read_audio(path=AUDIO_PATH):
   with open(path, "rb") as f:
       return f.read()


def _get(obj, key, default=None):
   """Get a field from either a dict or an object — v6 returns both."""
   if isinstance(obj, dict):
       return obj.get(key, default)
   return getattr(obj, key, default)


def get_model_name(meta):
   mi = _get(meta, "model_info")
   if mi is None:       return "n/a"
   return _get(mi, "name", "n/a")


def tts_to_bytes(response) -> bytes:
   """v6 generate() returns a generator of chunks or an object with .stream."""
   if hasattr(response, "stream"):
       return response.stream.getvalue()
   return b"".join(chunk for chunk in response if isinstance(chunk, bytes))


def save_tts(response, path: str) -> str:
   with open(path, "wb") as f:
       f.write(tts_to_bytes(response))
   return path


print(" Iklayenti le-Deepgram lilungile | isampula yomsindo ulandiwe") phrinta("n" + "="*60) phrinta(" SECTION 2: Pre-recorded Transcript from URL") print("="*60) response = client.listen.v1.media.transcript_url( url=AUDIO_URL, model="nova-3", smart_format=True, diarize=True, language="en", utterances=True, filler_words)s=True.[0].other ways[0].printing text(f"n Full Transcript:n{textwrap.fill(transcript, 80)}") self = response.results.channels[0].other ways[0].confidence (f"n Confidence: {confidence:.2%}") words = response.results.channels[0].other ways[0].words are printed(f"n First 5 words have period:") with w in words[:5]: print(f" '{w.word}' start={w.start:.2f}s end={w.end:.2f}s conf={w.confidence:.2f}") print(f"n Diarization of speaker (first 5 words):") with w in words[:5]: speaker = getattr(w, "speaker", Nothing) if speaker is not : print(f" Speaker {int(speaker)}: '{w.word}'") meta = response.metadata print(f"n Metadata: duration={meta.duration:.2f}s channels={int(meta.channels)} model={get_model_name(meta)}")

print("n" + "="*60)
print(" SECTION 3: Pre-Recorded Transcription from File")
print("="*60)


file_response = client.listen.v1.media.transcribe_file(
   request=read_audio(),
   model="nova-3",
   smart_format=True,
   diarize=True,
   paragraphs=True,
   summarize="v2",
)


alt = file_response.results.channels[0].alternatives[0]
paragraphs = getattr(alt, "paragraphs", None)
if paragraphs and _get(paragraphs, "paragraphs"):
   print("n Okulotshiweyo Okufomethwe Indima:") kwesigaba ku-_get(izigaba, "izigaba")[:2]: imisho = " ".join(_get(s, "text", "") for s in (_get(para, "imisho") noma [])) phrinta(f"  [Speaker {int(_get(para,'speaker',0))}, "
             f"{_get(para,'start',0):.1f}s–{_get(para,'end',0):.1f}s] {imisho[:120]}...") okunye: phrinta(f"n Transcript: {alt.transcript[:200]}...") if getattr(file_response.results, "summary", None): short = _get(file_response.results.summary, "short", "") if short: print(f"n AI shorthand: {short}") print(f"n Confidence: {alt.confidence:.2%}") print(f" Number of words : {len(alt.words)}") print("n" + "="*60) print(" SECTION 4: Async Parallel Transcription") print("="*60) async def transcribe_async(): audio_bytes = read_audio() async def from_url(label): r = await async_client.listen.v1.media.transcript_url(url=AUDIO_3=ru smart=AUDIO_URL), paper_model  [{label}] {r.results.channels[0].other ways[0].transcribed[:100]}...") async def from_file(label): r = await async_client.listen.v1.media.transcript_file( request=audio_bytes, model="nova-3", smart_format=True, ) print(f"  [{label}] {r.results.channels[0].other ways[0].transcribed[:100]}...") wait asyncio.gather(from_url("From URL"), from_file("From File")) wait transcribe_async()

print("n" + "="*60)
print(" SECTION 5: Text-to-Speech")
print("="*60)


sample_text = (
   "Welcome to the Deepgram advanced tutorial. "
   "This SDK lets you transcribe audio, generate speech, "
   "and analyse text — all with a simple Python interface."
)


tts_path = save_tts(
   client.speak.v1.audio.generate(text=sample_text, model="aura-2-asteria-en"),
   "/tmp/tts_output.mp3",
)
size_kb = os.path.getsize(tts_path) / 1024
print(f" Umsindo we-TTS ulondoloziwe → {tts_path} ({size_kb:.1f} KB)") isibonisi(Umsindo(tts_path)) phrinta("n" + "="*60) phrinta(" SECTION 6: Comparison of Multiple TTS Voices") print("="*60) voices = { "aura-2-asteria-en": "Asteria (female, warm)", "aura-2-orion-en": "Orion (male, deep)", "aura-2-luna-en": "Luna (female} label): voice model. try: method = save_tts( client.speak.v1.audio.generate(text="Hello! I'm a Deepgram voice model.", model=model_id), f"/tmp/tts_{model_id}.mp3", ) print(f"   {label}") display(Sound(method)) except e: print(f"    {label} — {e}") print("n" + "="*60) print(" SECTION 7: Text Intelligence — Sentiment, Topics, Intents") print("="*60) review_text = ( "I really like this product! It arrived quickly, the quality " "was outstanding, and the customer support was incredibly helpful " "" " "" I still have a question. " "I would recommend it to anyone looking for " "a reliable solution. Five starsnse = ""client.read request={"text": review_text}, language="en", sentiment=True, topics=True, intents=True, summarize=True, ) results = read_response.results

if getattr(results, "sentiments", None):
   overall = results.sentiments.average
   print(f" Sentiment: {_get(overall,'sentiment','?').upper()}  "
         f"(score={_get(overall,'sentiment_score',0):.3f})")
   for seg in (_get(results.sentiments, "segments") or [])[:2]:
       print(f"   • "{_get(seg,'text','')[:60]}"  → {_get(seg,'sentiment','?')}")


if getattr(results, "topics", None):
   print(f"n  Izihloko Ezitholiwe:") zeseg ku-(_get(results.topics, "segments") noma [])[:3]: ngo-t ku-(_get(seg, "izihloko") noma []): phrinta(f" • {_thola(t,'isihloko'?')} (conf={_get(t,'confidence_score',0):.2f})") uma getattr(imiphumela, "inhloso", None): phrinta(f"n Intents Received:") for seg in (_get(results.intents, "segments") or [])[:3]: for purpose in (_get(component, "purposes") or []): print(f" • {_get(intent,'intent','?')} (conf={_get(intent,'confidence_score',0):.2f})") if getattr(results, "summary", None): text = _get(results.summary, "text", "") if textn print(f) Summary: {text}") print("n" + "="*60) print("  SECTION 8: Advanced Options — Search, Replace, Enhance") print("="*60) search_response = client.listen.v1.media.transcript_url( url=AUDIO_URL, model="nova-3", smart_format=True, punctuate=True, search=["spacewalk", "mission", "astronaut"]return=[{"find": "um", "replace": "[hesitation]"}], keyterm=["spacewalk", "NASA"]) ch = search_response.results.channels[0]
if getattr(ch, "search", None): print(" Keyword Search Hits:"") for hit_group in ch.search: hits = _get(hit_group, "hits") or []
       print(f" '{_get(hit_group,'query','?')}': {len(hits)} hit(s)") for h hits[:2]: print(f" in {_get(h,'start',0):.2f}s–{_get(h,'end',0):.2f}s "f"conf={_get(h,'confidence',0):.2f}") print(f"n Text:n{textwrap.fill(ch.alternatives[0].transcript, 80)}") print("n" + "="*60) print(" SECTION 9: Raw HTTP Response Access") print("="*60) raw = client.listen.v1.media.with_raw_response.transcript_url( url=AUDIO_URL, model="nova-3", ) print(f"Response type : {type(raw.data).__name-raw.heads_quest").__name-raw_get_quest raw.headers.get("x-dg-request-id", "n/a")) print(f"Request ID : {request_id}")

print("n" + "="*60)
print("  SECTION 10: Error Handling")
print("="*60)


def safe_transcribe(url: str, model: str = "nova-3"):
   try:
       r = client.listen.v1.media.transcribe_url(
           url=url, model=model,
           request_options={"timeout_in_seconds": 30, "max_retries": 2},
       )
       return r.results.channels[0].alternatives[0].transcript
   except ApiError as e:
       print(f"   I-ApiError {e.status_code}: {e.body}") buyisela Akukho ngaphandle Kwangaphandle njenge-e: phrinta(f"   {type(e).__name__}: {e}") return None t = safe_transcript(AUDIO_URL) print(f" Valid URL → '{t[:60]}...'") t_bad = safe_transcript(" if t_bad Not available: print(" Invalid URL → error caught") print("n" + "="*60) print(" Tutorial complete! Sections covered:") of s in [
   "2.  transcribe_url(url=...) + diarization + word timing",
   "3.  transcribe_file(request=bytes) + paragraphs + summarize",
   "4.  Async parallel transcription",
   "5.  Text-to-Speech — generator-safe via save_tts()",
   "6.  Multi-voice TTS comparison",
   "7.  Text Intelligence — sentiment, topics, intents (dict-safe)",
   "8.  Advanced options — keyword search, word replacement, boosting",
   "9.  Raw HTTP response & request ID",
   "10. Error handling with ApiError + retries"
]: print (f"   {s}") print("="*60)