---
title: "Capture Readiness Endpoint"
method: GET
path: "/capture/readiness"
---

# Capture Readiness Endpoint

`GET /capture/readiness`

## Request

- Base URL: `https://api.voicelabs.now` (the document declares no server; this is the origin it was published from)
- URL: `https://api.voicelabs.now/capture/readiness`
- Auth: none declared

Whether the STT and LLM models the user has selected are downloaded.

The frontend gates the global hotkey on this — pressing the chord with
a missing model would otherwise produce a stuck "transcribing" pill that
waits forever for a download to finish. Checks on-disk cache, not RAM
load, so the answer survives backend restarts.

## Response `200`

Successful Response

- CaptureReadinessResponse: Backend gates that must be green before the global hotkey will fire. The frontend combines this with its own TCC permission checks (input monitoring, accessibility) into the full dictation readiness checklist. Hotkey-enabled is the user's intent toggle and lives outside this struct.
  - `stt` ModelReadiness, required: Per-model entry in the dictation readiness checklist. ``model_name`` is the canonical id used by ``POST /models/download`` so the frontend can wire a one-click "Download" button without a second lookup. ``size`` is the user's chosen variant (e.g. "turbo", "0.6B"); ``display_name`` is what the checklist row should show ("Whisper Turbo").
    - `ready` boolean, required
    - `model_name` string, required
    - `display_name` string, required
    - `size` string, required
    - `size_mb` integer, nullable
  - `llm` ModelReadiness, required: Per-model entry in the dictation readiness checklist. ``model_name`` is the canonical id used by ``POST /models/download`` so the frontend can wire a one-click "Download" button without a second lookup. ``size`` is the user's chosen variant (e.g. "turbo", "0.6B"); ``display_name`` is what the checklist row should show ("Whisper Turbo").
    - `ready` boolean, required
    - `model_name` string, required
    - `display_name` string, required
    - `size` string, required
    - `size_mb` integer, nullable

---

[API](https://skmtc.dev/voicelabs/apis/voicebox-api.md) · [All operations](https://skmtc.dev/voicelabs/apis/voicebox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voicelabs/apis/voicebox-api/revisions/a7a37d1fc02f?raw)