[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"article-doc:docs\u002Fapi-reference\u002F1.index":3},"---\ntitle: API Reference Overview\ndescription: Base URL, REST\u002FWebSocket endpoints, versioning.\n---\n\n# API Reference — Overview\n\n## Base URL\n\n```\nhttps:\u002F\u002Faudio.lansonai.com\n```\n\nAll relative paths in this reference are relative to this domain.\n\n## Three transcription planes\n\n| Plane | Endpoint | Body | Success | Who segments speech |\n|---|---|---|---|---|\n| **Realtime** | `WS \u002Fv1\u002Faudio\u002Ftranscriptions\u002Fstream` | PCM16LE stream | WS events | **Server** (VAD) |\n| **Segment** | `POST \u002Fv1\u002Faudio\u002Ftranscriptions` | `multipart\u002Fform-data` | **200** sync | **Client** (VAD) |\n| **Batch jobs** | `POST \u002Fv1\u002Faudio\u002Ftranscriptions\u002Fjobs` | JSON `audio_url` | **202** async | **Server** (time slicing) |\n\n## Endpoints\n\n| Endpoint | Method | Purpose | Auth |\n|---|---|---|---|\n| `\u002Fv1\u002Faudio\u002Ftranscriptions\u002Fstream` | WS | Realtime streaming transcription | `Bearer sk-...` or `rt_...` |\n| `\u002Fv1\u002Faudio\u002Ftranscriptions` | POST | Segment transcription (multipart, sync) | `Bearer sk-...` |\n| `\u002Fv1\u002Faudio\u002Ftranscriptions\u002Fjobs` | POST | Submit batch transcription job | `Bearer sk-...` |\n| `\u002Fv1\u002Faudio\u002Ftranscriptions\u002Fjobs\u002F{workflowId}` | GET | Poll batch job (preferred) | `Bearer sk-...` |\n| `\u002Fv1\u002Faudio\u002Ftranscriptions\u002F{workflowId}` | GET | Poll batch job (alias) | `Bearer sk-...` |\n| `\u002F{workflowId}` | GET | Poll batch job (legacy alias) | `Bearer sk-...` |\n| `\u002Fv1\u002Faudio\u002Ftranscriptions\u002Fsession-token` | POST | Issue short-lived browser WebSocket token | `Bearer sk-...` |\n| `\u002Fhealth` | GET | Liveness check | Public |\n| `\u002Freadyz` | GET | Realtime readiness check | Public |\n| `\u002Fopenapi.json` | GET | OpenAPI specification | Public |\n| `\u002Fdocs` | GET | Swagger UI | Public |\n\n::callout{icon=\"i-lucide-info\" color=\"primary\"}\nLegacy JSON on `POST \u002Fv1\u002Faudio\u002Ftranscriptions`\nStill accepted temporarily with `Deprecation: true` and a `Link` to `\u002Fjobs`. Prefer `POST \u002Fv1\u002Faudio\u002Ftranscriptions\u002Fjobs` for batch jobs.\n::\n\nService health board (latency \u002F probe SLI) is **not** on this host. Use the public ops page:\n\n- Production: [https:\u002F\u002Fcontrol.lansonai.com\u002Fstatus\u002Flanson-audio](https:\u002F\u002Fcontrol.lansonai.com\u002Fstatus\u002Flanson-audio)\n- Local tunnel: `https:\u002F\u002Fcontrol.deth.us\u002Fstatus\u002Flanson-audio`\n\n## Versioning\n\nThe current version uses the `\u002Fv1\u002F...` path prefix. Future breaking changes will use `\u002Fv2\u002F...`; `\u002Fv1\u002F` will remain supported during a reasonable transition period.\n\n## Authentication\n\nAll transcription endpoints require an API key via `Authorization: Bearer sk-...`. See [Authentication](\u002Fdocs\u002Fstart\u002Fauthentication) for browser-side session token flow.\n\n## Page layout\n\nEach endpoint page follows a consistent template:\n\n- **What it does** — functional description\n- **Endpoint** — URL and method\n- **Authentication** — auth requirements\n- **Request** — request format\n- **Parameters** — parameter reference\n- **Example** — code example\n- **Response** — response format\n- **Errors** — relevant error codes\n- **Related** — links to guides and concepts\n\n::callout{icon=\"i-lucide-info\" color=\"primary\"}\nReference pages are for field facts\nThis section does not contain product narratives or tutorials. For concepts, see [Concepts](\u002Fdocs\u002Fconcepts). For integration guides, see [Guides](\u002Fdocs\u002Fguides).\n::\n",1790059118940]