Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key’s per-minute and per-day rate limits.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"OpenWhispr","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#3B82F6"},"logo":{"light":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","dark":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","href":"https://openwhispr.com"},"favicon":"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a","appearance":{"default":"system"},"background":{"color":{"light":"#F7F9FB","dark":"#080C16"}},"navbar":{"links":[{"href":"https://openwhispr.com","label":"Website"},{"href":"https://github.com/OpenWhispr/openwhispr","label":"GitHub"}],"primary":{"type":"button","label":"Contact support","href":"mailto:support@openwhispr.com"}},"footer":{"socials":{"github":"https://github.com/OpenWhispr/openwhispr","x":"https://x.com/openwhispr"}},"fonts":{"family":"Space Grotesk"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openwhispr","hasAudioNarration":false,"actualSubdomain":"openwhispr","customDomains":["docs.openwhispr.com"],"gitSource":{"type":"github","owner":"openwhispr","repo":"openwhispr-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad89592078d5ac10ac9883d","collectionId":"80e0c993-f1ba-4ec6-b2bd-e6b3ada2d45e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad89592078d5ac10ac9883d"},"entitlements":{},"buildId":"6ad89592078d5ac10ac9883d","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Help Center","count":100},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"Troubleshooting","count":19},{"language":"default","tag":"Account \u0026 billing","count":17},{"language":"default","tag":"Developers","count":14},{"language":"default","tag":"Dictation","count":10},{"language":"default","tag":"Platforms \u0026 compatibility","count":10},{"language":"default","tag":"Meetings","count":9},{"language":"default","tag":"Dictation problems","count":8},{"language":"default","tag":"Notes, search \u0026 sync","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"kbd{display:inline-block;white-space:nowrap;min-width:1.75em;text-align:center;line-height:1.5}"}],"page":{"pagePath":"api-reference/transcriptions/transcribe-audio-beta","slug":"/api-reference/transcriptions/transcribe-audio-beta","pageMetadata":{"title":"Transcribe audio (beta)","description":"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key's per-minute and per-day rate limits.","deprecated":null,"version":null,"openapi":"/openapi.json post /transcribe","href":"/api-reference/transcriptions/transcribe-audio-beta","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key’s per-minute and per-day rate limits.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Transcribe audio (beta)","description":"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key's per-minute and per-day rate limits.","deprecated":null,"version":null,"openapi":"/openapi.json post /transcribe","href":"/api-reference/transcriptions/transcribe-audio-beta","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Transcribe audio (beta)","description":"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key's per-minute and per-day rate limits.","operationId":"transcribeAudio","tags":["Transcriptions"],"requestBody":"f7903f57-d777-4610-88c6-c3f414ce833a","responses":{"200":"213113d2-ac48-4836-8329-8fd579e087c9","400":"9dad42c8-af41-4bb0-9073-9c07ae7cdd07","403":"db01b194-5518-427b-9efa-4967346af908","409":"3b308cc2-f0df-4c7c-bd16-c417f466d475","413":"b0f82219-5876-4f07-83e6-f03fc9090e01","429":"44c88674-589d-4513-bb7d-8586f3818a90","503":"03cf85ba-a04d-44e7-a344-bb6df7894462"},"method":"post","type":"path","servers":["21f576fd-328d-419a-a4fb-df4d39242746"],"security":["28779325-6c4b-44b2-8e77-c477df2c3f4e"],"path":"/transcribe","baseUrlOptions":["https://api.openwhispr.com/api/v1"],"title":"Transcribe audio (beta)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"Audio file: wav, mp3, m4a/mp4, ogg, flac, or webm. 4 MB max.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"language":{"type":"string","description":"Language code of the audio (e.g. 'en').","uniqueKey":"language","typeLabel":"string"},"prompt":{"type":"string","description":"Names and jargon to spell correctly, comma-separated.","uniqueKey":"prompt","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","language":"\u003cstring>","prompt":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"213113d2-ac48-4836-8329-8fd579e087c9":{"description":"The transcript.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"data.id","typeLabel":"string"},"text":{"type":"string","description":"The transcript.","uniqueKey":"data.text","typeLabel":"string"},"language":{"type":"string","description":"Language of the transcript (e.g. 'en').","uniqueKey":"data.language","typeLabel":"string"},"duration_ms":{"type":"integer","description":"Audio length in milliseconds, estimated from file size when the engine does not report it. Counts against the monthly quota.","uniqueKey":"data.duration_ms","typeLabel":"integer"},"words":{"type":"integer","description":"Word count of the transcript.","uniqueKey":"data.words","typeLabel":"integer"},"provider":{"type":"string","description":"Which transcription provider produced the result. Informational; may change during the beta.","uniqueKey":"data.provider","typeLabel":"string"},"model":{"type":"string","description":"Which model produced the result. Informational; may change during the beta.","uniqueKey":"data.model","typeLabel":"string"},"beta":{"type":"boolean","const":true,"description":"Always true while cloud transcription through the API is in beta.","uniqueKey":"data.beta","typeLabel":"boolean"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","text":"\u003cstring>","language":"\u003cstring>","duration_ms":123,"words":123,"provider":"\u003cstring>","model":"\u003cstring>","beta":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"9dad42c8-af41-4bb0-9073-9c07ae7cdd07":{"description":"validation_error — the file was not recognised as audio.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"db01b194-5518-427b-9efa-4967346af908":{"description":"plan_required — Pro or Business needed. Or forbidden — missing transcriptions:write, a workspace key, or an organization policy that blocks cloud transcription.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3b308cc2-f0df-4c7c-bd16-c417f466d475":{"description":"concurrency_limit — a transcription is already running on this key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b0f82219-5876-4f07-83e6-f03fc9090e01":{"description":"payload_too_large — the file exceeds 4 MB.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"44c88674-589d-4513-bb7d-8586f3818a90":{"description":"quota_exceeded — 600 audio minutes used this calendar month; the message includes the reset date. Or rate_limited — see Retry-After.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"03cf85ba-a04d-44e7-a344-bb6df7894462":{"description":"service_unavailable — the beta is paused. Retry later.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"28779325-6c4b-44b2-8e77-c477df2c3f4e":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]}}},"servers":{"21f576fd-328d-419a-a4fb-df4d39242746":{"url":"https://api.openwhispr.com/api/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key starting with owk_live_ (personal) or ow_wks_live_ (workspace — see space_id on the Notes/Folders endpoints below)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"openwhispr","siteName":"OpenWhispr","title":"Transcribe audio (beta) - OpenWhispr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-13T21:50:19.401Z","originalFileLocation":"api-reference/transcriptions/transcribe-audio-beta.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key\u0026#x27;s per-minute and per-day rate limits.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Transcribe audio (beta) - OpenWhispr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key\u0026#x27;s per-minute and per-day rate limits.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenWhispr\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Transcriptions\u0026amp;title=Transcribe+audio+%28beta%29\u0026amp;description=Upload+an+audio+file+and+get+its+transcript+back+in+the+same+response.+Cloud+transcription+through+the+API+is+in+beta.+Limits%2C+response+shape%2C+and+availability+\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=67b31a900a1d0f5bc6ebcd54a6956558fb6a8c12c57cd1fe1ad441a20742963e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Transcribe audio (beta) - OpenWhispr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key\u0026#x27;s per-minute and per-day rate limits.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openwhispr.mintlify.app/_mintlify/api/og/v2?division=Transcriptions\u0026amp;title=Transcribe+audio+%28beta%29\u0026amp;description=Upload+an+audio+file+and+get+its+transcript+back+in+the+same+response.+Cloud+transcription+through+the+API+is+in+beta.+Limits%2C+response+shape%2C+and+availability+\u0026amp;theme=6a9eec330f0aa7431277284c\u0026amp;signature=67b31a900a1d0f5bc6ebcd54a6956558fb6a8c12c57cd1fe1ad441a20742963e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/openwhispr/-JbKQO6qzVwxtMKU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenWhispr\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transcriptions/transcribe-audio-beta.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.openwhispr.com/#organization\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openwhispr/AruQy2K60UKy6SJT/images/logo.svg?fit=max\u0026auto=format\u0026n=AruQy2K60UKy6SJT\u0026q=85\u0026s=73ef2a1292e4c40bd5bccbabe1b0767a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.openwhispr.com#website\",\"name\":\"OpenWhispr\",\"url\":\"https://docs.openwhispr.com\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta#webpage\",\"url\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta\",\"name\":\"Transcribe audio (beta)\",\"description\":\"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key's per-minute and per-day rate limits.\",\"dateModified\":\"2026-09-13T21:50:19.401Z\",\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OpenWhispr\",\"item\":\"https://docs.openwhispr.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transcribe audio (beta)\",\"item\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta#apireference\",\"headline\":\"Transcribe audio (beta)\",\"name\":\"Transcribe audio (beta)\",\"description\":\"Upload an audio file and get its transcript back in the same response. Cloud transcription through the API is in beta. Limits, response shape, and availability may change, and there is no SLA. For long recordings or free, private transcription, use the OpenWhispr CLI with the desktop app running. Requires a Pro or Business plan and transcriptions:write on a personal key (owk_live_); workspace keys get 403. Files are capped at 4 MB per request, usage at 600 audio minutes per calendar month, and one transcription runs at a time per key. Each call counts as 5 requests against the key's per-minute and per-day rate limits.\",\"url\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta\",\"mainEntityOfPage\":{\"@id\":\"https://docs.openwhispr.com/api-reference/transcriptions/transcribe-audio-beta#webpage\"},\"dateModified\":\"2026-09-13T21:50:19.401Z\",\"publisher\":{\"@id\":\"https://docs.openwhispr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.openwhispr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenWhispr\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OpenWhispr","nav":{"global":null,"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":""}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/api/overview"}]},{"tab":"API Reference","groups":[{"group":"Notes","pages":[{"title":"List notes","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/list","href":"/api-reference/notes/list-notes"},{"title":"Get note","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}","href":"/api-reference/notes/get-note"},{"title":"Create note","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/create","href":"/api-reference/notes/create-note"},{"title":"Update note","deprecated":null,"version":null,"openapi":"/openapi.json patch /notes/{id}","href":"/api-reference/notes/update-note"},{"title":"Delete note","deprecated":null,"version":null,"openapi":"/openapi.json delete /notes/{id}","href":"/api-reference/notes/delete-note"},{"title":"Search notes","deprecated":null,"version":null,"openapi":"/openapi.json post /notes/search","href":"/api-reference/notes/search-notes"}]},{"group":"Folders","pages":[{"title":"List folders","deprecated":null,"version":null,"openapi":"/openapi.json get /folders/list","href":"/api-reference/folders/list-folders"},{"title":"Create folder","description":"Create a new folder. Max 50 folders per user.","deprecated":null,"version":null,"openapi":"/openapi.json post /folders/create","href":"/api-reference/folders/create-folder"}]},{"group":"Transcriptions","pages":[{"title":"Transcribe audio (beta)","deprecated":null,"version":null,"openapi":"/openapi.json post /transcribe","href":"/api-reference/transcriptions/transcribe-audio-beta"},{"title":"List transcriptions","description":"List transcription history with cursor pagination, newest first. Supports filtering by language or linked note.","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/list","href":"/api-reference/transcriptions/list-transcriptions"},{"title":"Get transcription","deprecated":null,"version":null,"openapi":"/openapi.json get /transcriptions/{id}","href":"/api-reference/transcriptions/get-transcription"},{"title":"Delete transcription","deprecated":null,"version":null,"openapi":"/openapi.json delete /transcriptions/{id}","href":"/api-reference/transcriptions/delete-transcription"},{"title":"Get note transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /notes/{id}/transcript","href":"/api-reference/transcriptions/get-note-transcript"}]},{"group":"Dictionary","pages":[{"title":"List dictionary words","deprecated":null,"version":null,"openapi":"/openapi.json get /dictionary/list","href":"/api-reference/dictionary/list-dictionary-words"},{"title":"Add dictionary words","deprecated":null,"version":null,"openapi":"/openapi.json post /dictionary/create","href":"/api-reference/dictionary/add-dictionary-words"},{"title":"Update dictionary word","deprecated":null,"version":null,"openapi":"/openapi.json patch /dictionary/{id}","href":"/api-reference/dictionary/update-dictionary-word"},{"title":"Delete dictionary word","deprecated":null,"version":null,"openapi":"/openapi.json delete /dictionary/{id}","href":"/api-reference/dictionary/delete-dictionary-word"}]},{"group":"Snippets","pages":[{"title":"List snippets","deprecated":null,"version":null,"openapi":"/openapi.json get /snippets/list","href":"/api-reference/snippets/list-snippets"},{"title":"Create snippet","deprecated":null,"version":null,"openapi":"/openapi.json post /snippets/create","href":"/api-reference/snippets/create-snippet"},{"title":"Update snippet","deprecated":null,"version":null,"openapi":"/openapi.json patch /snippets/{id}","href":"/api-reference/snippets/update-snippet"},{"title":"Delete snippet","deprecated":null,"version":null,"openapi":"/openapi.json delete /snippets/{id}","href":"/api-reference/snippets/delete-snippet"}]},{"group":"Usage","pages":[{"title":"Get usage","deprecated":null,"version":null,"openapi":"/openapi.json get /usage","href":"/api-reference/usage/get-usage"},{"title":"Get the current credential","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/usage/get-the-current-credential"}]},{"group":"Auth","pages":[{"title":"Request verification code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code","href":"/api-reference/auth/request-verification-code"},{"title":"Verify code","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/email-code/verify","href":"/api-reference/auth/verify-code"}]},{"group":"Keys","pages":[{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/create","href":"/api-reference/keys/create-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /keys/list","href":"/api-reference/keys/list-api-keys"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/openapi.json post /keys/{id}/revoke","href":"/api-reference/keys/revoke-api-key"}]},{"group":"Spaces","pages":[{"title":"List spaces","deprecated":null,"version":null,"openapi":"/openapi.json get /spaces/list","href":"/api-reference/spaces/list-spaces"}]}]}]},"basePath":"","title":"Transcribe audio (beta) - OpenWhispr","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BAvA99GL.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}