API playground
Put your key, choose a file, press the button — and you see the real answer of our API: the status, the headers, the body and how long every call took. The snippets below are built from the same fields, so what you copy is what was sent.
Send a request and read the answer
The chain is the chain of the documentation: upload the file, read the transcript while it is being made, then take the export in the format you need.
Console
- No request yet. Press the button above.
Answer
Nothing yet.
Export
the file in the format you choseNothing yet.
The same call as code
The snippets are built from the fields above: the base URL, the path, the method, the headers and the body. Every snippet carries two calls — the upload and the export GET /v1/transcripts/{transcript_id}/export?format=… — so the language changes the first call and the format changes the second one. Change a field and the snippet is built again. The key is a placeholder — put your own in.
$TRANSCRIB_API_KEY. The real key stays in your browser.
What the API really answers
Every path below is taken from the routers of the service, checked on 2026-10-24. The full table with the sources is in api.md.
| Method | Path | What it does | Required |
|---|---|---|---|
POST | /v1/uploads/init | Open a chunked upload and get an upload id back. | filename, size |
PUT | /v1/uploads/{upload_id}/chunk | Send one part of the file; the index of the part is in the query. | index |
POST | /v1/uploads/{upload_id}/complete | Put the parts together and queue the transcription. | — |
DELETE | /v1/uploads/{upload_id} | Drop an upload that was never finished. | — |
POST | /v1/transcripts | Upload a file in one multipart request and queue the transcription. | file |
GET | /v1/transcripts | The list of the transcripts of the account. | — |
GET | /v1/transcripts/{transcript_id} | One transcript: the text, the segments, the times, the speakers. | — |
PATCH | /v1/transcripts/{transcript_id} | Save the edited text of a transcript. | text |
DELETE | /v1/transcripts/{transcript_id} | Delete a transcript and its file. | — |
GET | /v1/transcripts/{transcript_id}/export | Export the transcript in one of the six formats. | — |
GET | /v1/usage | The plan, the period, the minutes and the files used today. | — |
POST | /v1/api-keys | Create an API key. The value is shown once. | name |
GET | /v1/api-keys | The list of the keys of the account, without their values. | — |
DELETE | /v1/api-keys/{key_id} | Revoke a key. It stops working at once. | — |
GET | /v1/asr/endpoints | The engine behind the service: the address, the state, the capabilities. | — |
GET | /v1/me | The current account, its plan and its usage. | — |
POST | /v1/auth/register | Create an account and get a session token. | email, password |
POST | /v1/auth/login | Sign in and get a session token. | email, password |
| What | Value |
|---|---|
| Size of one file | 64 MB |
| Length of one file | 120 minutes (two hours) |
| Length on the free plan | 30 minutes |
| Free plan | $0: 3 files a day, no card |
| Pro fair use | 1,500 minutes of audio a month |
| One part of a chunked upload | 8 MB |
| Format | What comes out |
|---|---|
| TXT | plain text, one line per segment |
| Markdown | the same text as headings and lists |
| SRT | subtitles with start and end timecodes |
| VTT | web subtitles with start and end timecodes |
| CSV | one row per segment, with the time and the speaker |
| DOCX | a Word document with the transcript — Pro only |
| Plan | Price |
|---|---|
| Free | $0 — 3 files a day, up to 30 minutes per file, no card |
| Pro, paid yearly | $10 a month ($120 a year) — 1,500 minutes of audio a month, DOCX export, REST API and MCP |
| Pro, paid monthly | $20 a month — the same allowance, billed every month |
| Team | on request — a committed volume, written down |
| API | metered — billed on the audio you send |
The prices and the limits are on the pricing page.
| What | Value |
|---|---|
| Text | one segment per line |
| Timecodes | the start and the end time of every segment |
| Speakers | named separately, on request |
| Languages | Russian and English — set by you or detected automatically |
| Speed | 0.84 s to transcribe a short file, 0.39 s to detect its language (our measurement of 21 October 2026) |
Where the errors come from: unauthorized (401), limit_exceeded (402 for the daily limit and the monthly allowance, 413 for a file over the limit), forbidden (403), not_found (404), invalid_request (400 and 422), provider_error (502), billing_disabled and not_ready (503). A resource of another account is not found as well: the answer there is 404, not 403. The body of every error is the same: {"error": {"code": "…", "message": "…"}}.
Or put the file on the page and read the first lines.
The widget below is the same one as on the home page: file → transcript with timecodes and speakers → export. The transcript is saved to your account.
Drop an audio or video file
or — mp3, wav, m4a, mp4, up to 64 MB and two hours
Transcription runs under your account: sign in or create a free account.
No account yet? The free plan needs no card. Create a free account or sign in.
Questions this page answers.
Do I need an account to try the playground?
No. The button «Run the demo without a key» works against the local stand of the repository, where the recogniser is replaced by a stub. To try the real service, paste your own key: it is created in the app on the Pro or Team plan.
Where do I get an API key?
In the app, on the Pro or Team plan. The value is shown once at creation and we store only its hash, so it cannot be shown again. The keys live under your account.
Is it safe to paste a key on this page?
The key stays in the memory of the page. It is not printed, it does not go into the console, and it is written to the storage of your browser only if you tick the consent box. It is sent to one address only: the base URL written in the field above, and to nowhere else.
Which formats can I take out?
Six: TXT, Markdown, SRT, VTT, CSV and DOCX. The DOCX export is on the Pro plan only. The chain of the page ends with the export in the format you chose.
What does it cost?
The free plan is $0: 3 files a day, up to 30 minutes per file, no card. Pro is $10 a month when paid yearly and $20 a month when paid monthly, with 1,500 minutes of audio a month. The API itself is metered — you are billed on the audio you send. The prices are on the pricing page.
Related pages.
The full reference: the endpoints, the errors, the keys, the MCP server.
The same documentation in one Markdown file, for your editor.
The MCP server and the plugins for Claude and ChatGPT.
The plans, the limits and the metered API.
Where the keys are created and the files are transcribed.
What the service is and what it costs.
Mark Vesyoly, Founder.
Every number on this page comes from the service contract, the pricing page or our own measurements. The author of the page and the publisher of the site are the same person. Questions and corrections: support@transcrib.si.