Back to home
Lanson Flow Docs

Timestamps & Speakers

Timestamp and speaker information in transcription results.

Segment timestamps

Each segment includes timestamps:

{
  "id": 0,
  "start_time": 0.0,
  "end_time": 3.2,
  "duration": 3.2,
  "text": "The weather is nice today",
  "confidence": 0.95
}

FieldTypeDescription
idnumberSegment index (from 0)
start_timenumberStart time in seconds
end_timenumberEnd time in seconds
durationnumberDuration in seconds
textstringTranscribed text
confidencenumberConfidence score (0–1, 3 decimal places)

Confidence

  • Range: 0 to 1
  • 3 decimal places
  • Calculated from 1 - no_speech_prob when upstream provides it
  • Global timestamps

    After slicing, timestamps are aggregated to global time. start_time and end_time are relative to the original audio, not chunk-internal time.

    Summary statistics

    {
      "summary": {
        "total_duration": 120.5,
        "total_speech_duration": 95.3,
        "overall_speech_ratio": 0.79,
        "num_segments": 45
      }
    }
    

    FieldDescription
    total_durationTotal audio duration (seconds)
    total_speech_durationActual speech duration (seconds)
    overall_speech_ratioSpeech ratio
    num_segmentsNumber of segments

    Metadata

    {
      "metadata": {
        "language": "zh",
        "model": "whisper-large-v3-turbo",
        "chunk_count": 3,
        "audio_duration_seconds": 120.5
      }
    }
    

    Speaker diarization

    Speaker diarization is not available in the current version and is on the roadmap.

    ::callout{icon="i-lucide-triangle-alert" color="amber"} Current segments do not include a speaker field. Do not rely on speaker information. ::

    Precision notes

  • Timestamp precision depends on the upstream model and slicing granularity
  • Timestamps at slice boundaries are corrected during aggregation
  • Short speech segments (<1s) may have less precise timestamps
  • Related

  • Transcribe Audio — submit a job
  • Subtitles — generate subtitles from timestamps
  • Batch Jobs API — API reference