Skip to main content
The Vook API lets you work with your transcriptions programmatically: upload a file or send a link to transcribe, get notified by webhook when it is done, list your transcriptions, read the transcript text, download exports, and delete transcriptions, using only an API key.

​
Base URL

All requests target the versioned public surface under /api/v1:

​
Authentication

Every request authenticates with an API key sent as a Bearer token:
Keys look like vk_live_…. See Authentication for how to mint and revoke them.

​
Conventions

Every request and response field is snake_case, on resources, list pages, and error bodies alike. Timestamps are ISO 8601 strings. Failed requests share one error body with a stable code; see Errors and limits.

​
Requirements

The examples in these guides use curl and Python. The Python snippets require Python 3.8+ and the requests package:

​
Next steps

Authentication

Mint a vk_live_… key and send it on every request.

Transcribe from a file

Upload a file and turn it into a transcription.

Retrieve and export

List a transcription, read its text, and download an export.

AI assistants (MCP)

Transcribe and read transcripts from Claude, Cursor and other MCP clients.