Transcribing
Speech-to-text (Whisper) — upload audio and get a transcript via async or sync endpoints.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/transcribe/async | Upload audio, return task_id |
| POST | /api/transcribe/sync | Upload audio, wait for transcript |
| GET | /api/transcribe/status | Poll status and result |
See API Reference for details.
Task IDs
Transcribing tasks use prefix stt:.
Audio input
Two formats are supported:
multipart/form-datawith file fieldaudio- Raw binary body (any
Content-Type)
Maximum file size: 50 MB.
Optional parameters
Pass via query string or multipart form fields:
| Parameter | Description |
|---|---|
keep_alive_ms | Keep-alive hint for the node (uint32) |
fanout | Number of nodes in the auction (default 5) |
Status values
Same lifecycle as browsing: queued → … → completed | failed.
Completed responses include success, payload (transcript text), and optional error, execution_time_ms, audio_duration_seconds.