> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 Pro (current TTS) and Pulse (current
> multilingual STT) — or Pulse 2.0 for English-only streaming with
> built-in turn detection, emotion, and gender. Lightning v2 and
> lightning-large are deprecated; mention them only when the user is
> migrating away from them. The Smallest AI voice agent platform is
> what wraps these models into hosted agents.

# Finalize Control

> Word-count finalization parameters on the Pulse STT WebSocket: `finalize_on_words` and `max_words`.

Real-Time

Pulse STT finalizes the live transcript on trailing silence, on word count, and whenever you send a `finalize` message. `finalize_on_words` and `max_words` are the word-count parameters. For how all finalization triggers fit together and the recommended setup per orchestration, see [Finalization and Endpointing](/models/speech-to-text/features/endpointing). These params are meant for `?model=pulse`. [Pulse 2.0](/model-cards/speech-to-text/pulse-2-0) uses built-in end-of-turn detection and ignores both by default - don't send them. If you do, they still take effect and compete with end-of-turn detection: a low `max_words` splits turns into short fragments.

## Parameters

| Parameter           | Type                  | Default  | Description                                              |
| ------------------- | --------------------- | -------- | -------------------------------------------------------- |
| `finalize_on_words` | `"true"` \| `"false"` | `"true"` | Word-count-based finalization.                           |
| `max_words`         | integer               | Unset    | Word count at which the pending transcript is finalized. |

Both parameters are **WebSocket-only** - they don't apply to the pre-recorded HTTP endpoint, which always returns one final transcript per request.

## Related

* [Inverse Text Normalization (ITN)](/models/speech-to-text/features/inverse-text-normalization) - `finalize_on_words` is most useful in combination with ITN.
* [End-of-Utterance Timeout](/models/speech-to-text/features/end-of-utterance-timeout) - controls automatic finalization timing when `finalize_on_words` stays `true`.
* [Pulse STT WebSocket reference](/api-reference/models/speech-to-text/speech-to-text) - full parameter reference and the `finalize` / `close_stream` control messages.