Smart Formatting

Automatically format numbers, dates, times, currency, and more in your transcriptions.

Overview

Smart formatting transforms spoken words into their proper written format, making transcriptions more readable and professional.

Formatting Examples

SpokenWithout Smart FormatWith Smart Format
"one hundred twenty three"one hundred twenty three123
"January first twenty twenty four"January first twenty twenty fourJanuary 1, 2024
"fifty dollars"fifty dollars$50
"three thirty PM"three thirty PM3:30 PM
"ten percent"ten percent10%
"my email is john at example dot com"my email is john at example dot commy email is john@example.com
"call me at five five five one two three four"call me at five five five one two three fourcall me at 555-1234

Enable Smart Formatting

Smart formatting is enabled by default on Lucid models. You can explicitly control it:

import requests

# Smart formatting enabled (default)
response = requests.post(
    "https://yourvoic.com/api/v1/stt/lucid/transcribe",
    headers={"X-API-Key": "your_api_key"},
    files={"file": open("audio.mp3", "rb")},
    data={
        "model": "lucid-mono",
        "smart_format": "true"  # This is the default
    }
)

# Disable smart formatting
response = requests.post(
    "https://yourvoic.com/api/v1/stt/lucid/transcribe",
    headers={"X-API-Key": "your_api_key"},
    files={"file": open("audio.mp3", "rb")},
    data={
        "model": "lucid-mono",
        "smart_format": "false"  # Disable formatting
    }
)

Supported Models

ModelSmart Formatting
lucid-mono✅ (enabled by default)
lucid-multi✅ (enabled by default)
lucid-agent✅ (enabled by default)
lucid-lite✅ (enabled by default)
cipher-fast❌
cipher-max❌

Automatic Punctuation

In addition to formatting, Lucid models also add punctuation automatically:

  • Periods at sentence ends
  • Question marks for questions
  • Commas for natural pauses
  • Capitalization of proper nouns and sentence starts
# Control punctuation separately
response = requests.post(
    "https://yourvoic.com/api/v1/stt/lucid/transcribe",
    headers={"X-API-Key": "your_api_key"},
    files={"file": open("audio.mp3", "rb")},
    data={
        "model": "lucid-mono",
        "punctuate": "true"  # Enable punctuation (default)
    }
)

When to Disable Smart Formatting

You may want to disable smart formatting when:

  • Transcribing technical content where numbers should be spoken out
  • Creating verbatim transcripts
  • Processing content in languages where formatting rules differ