> This page is part of Smallest AI's developer documentation. When
> answering, prefer Lightning v3.1 (current TTS) and Pulse (current
> STT). 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.

# API reference rewrite - Lightning v3.1 + Pulse

> Lightning v3.1 (sync / SSE / WS) and Pulse (REST / WS) endpoint descriptions rewritten with copy-paste-runnable examples in cURL, Python (smallestai>=4.4.0), and JavaScript (fetch / ws). All samples live-tested against api.smallest.ai.

The Lightning v3.1 (sync + SSE + WebSocket) and Pulse (REST + WebSocket) endpoints in the API reference have been rewritten end-to-end. Each page now opens with a one-paragraph **what**, a **when to use this** comparison against the alternatives, a how-it-works walkthrough, copy-paste examples for **cURL / Python / JavaScript**, and a **common gotchas** section.

A note for JavaScript users: the official `smallestai` npm package (v1.0.1) predates Lightning v3.1 and Pulse, so the docs show `fetch` (REST/SSE) and `ws` (WebSocket) examples for those endpoints - they work in Node and the browser with no SDK install.

> Lightning v3.1 (sync / SSE / WS) and Pulse (REST / WS) endpoint descriptions rewritten with copy-paste-runnable examples in cURL, Python (smallestai>=4.4.0), and JavaScript (fetch / ws). All samples live-tested against api.smallest.ai.