Soniox
Docs
Shared concepts

Context

Learn how to use custom context to enhance trancription accuracy.

Overview

Soniox Speech-to-Text AI lets you boost both transcription and translation accuracy by providing context with each session.

Context is extra text that guides the AI model with domain knowledge, vocabulary, and phrases. It is especially helpful when your audio includes:

  • Industry-specific terminology.
  • Brand or product names.
  • Rare, uncommon, or invented words.
  • Domain-specific documents, scripts, or phrases.

With context, you can adapt Soniox instantly to your domain — no training required.


How context works

You provide context through the context parameter:

  • The text does not need to appear in the audio.
  • Context is used only when helpful — it does not override normal recognition or translation.
  • Improves accuracy for both transcription and translation.

Examples

Keyword list

Helpful for drug names, product names, or technical vocabulary:

{
  "context": "Celebrex, Zyrtec, Xanax, Prilosec, Amoxicillin Clavulanate Potassium"
}

Paragraph or summary

Provide a relevant text that reflects the audio content:

{
  "context": "The customer, Maria Lopez, contacted BrightWay Insurance to update
  her auto policy after purchasing a new vehicle. Agent Daniel Kim reviewed the
  changes, explained the premium adjustment, and offered a bundling discount.
  Maria agreed to update the policy and scheduled a follow-up to consider
  additional options."
}

Context size limit

  • Maximum 8,000 tokens (~10,000 characters).
  • Supports large blocks of text: glossaries, scripts, domain summaries.
  • If you exceed the limit, the API will return an error → trim or summarize first.