Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Maybloc API","description":"Maybloc is a speech-to-text API for recordings with more than one voice. Every speaker separated, overlapping speech kept, every word timed.","colors":{"primary":"#2f7fab","light":"#8ecae6","dark":"#121212"},"logo":{"light":"https://mintcdn.com/o-nn/eAIjl1JfYJdjAbyi/logo/light.webp?fit=max\u0026auto=format\u0026n=eAIjl1JfYJdjAbyi\u0026q=85\u0026s=137306f9cb6b2646bc22047565523de4","dark":"https://mintcdn.com/o-nn/eAIjl1JfYJdjAbyi/logo/dark.webp?fit=max\u0026auto=format\u0026n=eAIjl1JfYJdjAbyi\u0026q=85\u0026s=a1aede1fd1937b9e2db7e9714db38c38"},"favicon":"https://mintcdn.com/o-nn/eAIjl1JfYJdjAbyi/logo/favicon.png?fit=max\u0026auto=format\u0026n=eAIjl1JfYJdjAbyi\u0026q=85\u0026s=ac4b1137a5dacb098510bb89ae18cf3f","api":{"openapi":"https://app.maybloc.com/openapi.json","playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python"]}},"appearance":{"default":"system"},"navbar":{"links":[{"href":"https://maybloc.com","label":"Website"}],"primary":{"type":"button","label":"Open console","href":"https://app.maybloc.com/transcripts"}},"footer":{"links":[{"header":"Product","items":[{"label":"Website","href":"https://maybloc.com"},{"label":"Pricing","href":"https://maybloc.com/pricing"},{"label":"Benchmarks","href":"https://maybloc.com/benchmarks"}]},{"header":"Legal","items":[{"label":"Terms","href":"https://maybloc.com/terms"},{"label":"Privacy","href":"https://maybloc.com/privacy"}]}]},"seo":{"metatags":{"og:site_name":"Maybloc API","twitter:card":"summary_large_image"},"organization":{"name":"Maybloc","url":"https://maybloc.com"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode","mcp"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"o-nn","hasAudioNarration":false,"actualSubdomain":"o-nn","customDomains":["docs.maybloc.com"],"gitSource":{"type":"artifacts","owner":"prod","repo":"6adf41c78d250d16df279c75","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6adf4203d9bc4ba6afb6f86a"},"chroma":{"latestBuiltDeploymentHistoryId":"6adf683c6ae6925741e3af33","collectionId":"b95784e4-35af-4f79-8495-b21ad60f4dd9","liveDeploymentHistoryId":"6adf683c6ae6925741e3af33","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adf683c6ae6925741e3af33","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Guides","count":20},{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"Transcripts","count":9},{"language":"default","tag":"Uploads","count":2},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Account","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-a-transcript","slug":"/api-reference/create-a-transcript","pageMetadata":{"title":"Create a transcript","openapi":"POST /transcripts","description":"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.","href":"/api-reference/create-a-transcript"},"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: \"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\"\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":"Create a transcript","openapi":"POST /transcripts","description":"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.","href":"/api-reference/create-a-transcript"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transcripts"],"summary":"Create a transcript","operationId":"createTranscript","description":"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.","parameters":["08b61ab9-95ef-4fcd-9c19-f6525e6fa264"],"requestBody":"23bf40a5-3d22-413f-84bd-ccba7d23397c","responses":{"202":"e054b718-fce1-4b06-b547-13ca944b3f60","400":"5a1162b6-5d5b-4c90-bac6-afe25d4ad354","401":"9d9d9cd7-3fae-486a-8f16-e87e15696e67","402":"dd9b4b12-2c59-4384-83d9-d44436daa61c","403":"b74fc4f2-257b-428e-b2cd-d84dbb70f7e9","409":"3e835c3f-3b32-472b-bf72-a57140a27fbb","429":"9e8a65bb-1ac1-4f43-9053-32d53a54309f"},"method":"post","type":"path","servers":["9e209da8-d962-4cce-82bd-0b12f31fc69c"],"security":["f7bcd0d3-e93d-41fc-80fe-19d97d2a5537"],"path":"/transcripts","baseUrlOptions":["https://app.maybloc.com/api/v1"],"title":"Create a transcript","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"08b61ab9-95ef-4fcd-9c19-f6525e6fa264":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160,"isRequired":true,"description":"A unique key per transcript you want. Reuse it only to retry the same request.","uniqueKey":"","typeLabel":"string"},"description":"A unique key per transcript you want. Reuse it only to retry the same request."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["upload_id","duration_ms"],"properties":{"upload_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"upload_id","typeLabel":"string\u003cuuid>"},"duration_ms":{"type":"integer","minimum":20000,"maximum":10800000,"description":"The recording's length (20 seconds to 3 hours). The price is based on it, and it is checked against the file.","isRequired":true,"uniqueKey":"duration_ms","typeLabel":"integer"},"config":{"type":"object","additionalProperties":false,"description":"How the transcript is made. Unknown fields are rejected. The playground's Export config writes this object.","properties":{"model":{"type":"string","enum":["calico-1-flash"],"default":"calico-1-flash","uniqueKey":"config.model","typeLabel":"enum\u003cstring>"},"language":{"type":"string","enum":["auto","en","es","fr","de","it","pt","nl","pl","ru","uk","tr","ar","fa","he","hi","ur","bn","ta","te","mr","gu","pa","kn","ml","zh","ja","ko","th","vi","id","ms","tl","sv","da","no","fi","cs","ro","hu","el","bg","hr","sk","sl","sr"],"default":"auto","description":"ISO 639-1 code of the spoken language, or auto to detect one language for the recording.","uniqueKey":"config.language","typeLabel":"enum\u003cstring>"},"addons":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["redact_pii","smart_format","subtitles","insights","identify_speakers","sentiment","topics","keywords","custom_fields","translation"],"uniqueKey":"config.addons.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Made from the transcript and priced per minute on top of the model: redact_pii (PII redaction, +$0.0005/min), smart_format (Smart formatting, +$0.0005/min), subtitles (Subtitles, free), insights (Insights, +$0.001/min), identify_speakers (Speaker names, +$0.0005/min), sentiment (Sentiment, +$0.0005/min), topics (Topics and entities, +$0.0005/min), keywords (Key terms, +$0.0005/min), custom_fields (Custom fields, +$0.0005/min), translation (Translation, +$0.0015/min per language).","uniqueKey":"config.addons","typeLabel":"enum\u003cstring>[]"},"translate_to":{"type":"array","uniqueItems":true,"maxItems":5,"items":{"type":"string","enum":["en","es","fr","de","it","pt","nl","pl","ru","uk","tr","ar","fa","he","hi","ur","bn","ta","te","mr","gu","pa","kn","ml","zh","ja","ko","th","vi","id","ms","tl","sv","da","no","fi","cs","ro","hu","el","bg","hr","sk","sl","sr"],"uniqueKey":"config.translate_to.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"With translation: 1 to 5 languages to translate into, each charged per minute.","uniqueKey":"config.translate_to","typeLabel":"enum\u003cstring>[]"},"custom_fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["key","question"],"properties":{"key":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$","description":"Names the answer in the result.","isRequired":true,"uniqueKey":"config.custom_fields.items.[INDEX].key","typeLabel":"string"},"question":{"type":"string","maxLength":500,"isRequired":true,"uniqueKey":"config.custom_fields.items.[INDEX].question","typeLabel":"string"},"type":{"type":"string","enum":["text","number","boolean","list","speaker","choice"],"default":"text","description":"boolean is yes or no; speaker answers with a speaker id; choice answers with one of options.","uniqueKey":"config.custom_fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","items":{"type":"string","uniqueKey":"config.custom_fields.items.[INDEX].options.items.[INDEX]","typeLabel":"string"},"minItems":2,"maxItems":50,"description":"With type choice.","uniqueKey":"config.custom_fields.items.[INDEX].options","typeLabel":"string[]"}},"uniqueKey":"config.custom_fields.items.[INDEX]","typeLabel":"object"},"description":"With custom_fields: 1 to 20 questions answered from the recording.","uniqueKey":"config.custom_fields","typeLabel":"object[]"}},"uniqueKey":"config","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"upload_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","duration_ms":5410000,"config":{"model":"calico-1-flash","language":"auto","addons":[],"translate_to":[],"custom_fields":[{"key":"\u003cstring>","question":"\u003cstring>","type":"text","options":["\u003cstring>"]}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e054b718-fce1-4b06-b547-13ca944b3f60":{"description":"Transcript queued","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"object":{"type":"string","const":"transcript","uniqueKey":"object","typeLabel":"string"},"model":{"type":"string","uniqueKey":"model","typeLabel":"string"},"status":{"type":"string","enum":["queued","processing","completed","failed","canceled"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"file_name":{"type":"string","uniqueKey":"file_name","typeLabel":"string"},"speaker_names":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"speaker_names.additionalProperties","typeLabel":"string"},"uniqueKey":"speaker_names","typeLabel":"object"},"config":{"type":"object","additionalProperties":false,"description":"How the transcript is made. Unknown fields are rejected. The playground's Export config writes this object.","properties":{"model":{"type":"string","enum":["calico-1-flash"],"default":"calico-1-flash","uniqueKey":"config.model","typeLabel":"enum\u003cstring>"},"language":{"type":"string","enum":["auto","en","es","fr","de","it","pt","nl","pl","ru","uk","tr","ar","fa","he","hi","ur","bn","ta","te","mr","gu","pa","kn","ml","zh","ja","ko","th","vi","id","ms","tl","sv","da","no","fi","cs","ro","hu","el","bg","hr","sk","sl","sr"],"default":"auto","description":"ISO 639-1 code of the spoken language, or auto to detect one language for the recording.","uniqueKey":"config.language","typeLabel":"enum\u003cstring>"},"addons":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["redact_pii","smart_format","subtitles","insights","identify_speakers","sentiment","topics","keywords","custom_fields","translation"],"uniqueKey":"config.addons.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Made from the transcript and priced per minute on top of the model: redact_pii (PII redaction, +$0.0005/min), smart_format (Smart formatting, +$0.0005/min), subtitles (Subtitles, free), insights (Insights, +$0.001/min), identify_speakers (Speaker names, +$0.0005/min), sentiment (Sentiment, +$0.0005/min), topics (Topics and entities, +$0.0005/min), keywords (Key terms, +$0.0005/min), custom_fields (Custom fields, +$0.0005/min), translation (Translation, +$0.0015/min per language).","uniqueKey":"config.addons","typeLabel":"enum\u003cstring>[]"},"translate_to":{"type":"array","uniqueItems":true,"maxItems":5,"items":{"type":"string","enum":["en","es","fr","de","it","pt","nl","pl","ru","uk","tr","ar","fa","he","hi","ur","bn","ta","te","mr","gu","pa","kn","ml","zh","ja","ko","th","vi","id","ms","tl","sv","da","no","fi","cs","ro","hu","el","bg","hr","sk","sl","sr"],"uniqueKey":"config.translate_to.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"With translation: 1 to 5 languages to translate into, each charged per minute.","uniqueKey":"config.translate_to","typeLabel":"enum\u003cstring>[]"},"custom_fields":{"type":"array","maxItems":20,"items":{"type":"object","required":["key","question"],"properties":{"key":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$","description":"Names the answer in the result.","isRequired":true,"uniqueKey":"config.custom_fields.items.[INDEX].key","typeLabel":"string"},"question":{"type":"string","maxLength":500,"isRequired":true,"uniqueKey":"config.custom_fields.items.[INDEX].question","typeLabel":"string"},"type":{"type":"string","enum":["text","number","boolean","list","speaker","choice"],"default":"text","description":"boolean is yes or no; speaker answers with a speaker id; choice answers with one of options.","uniqueKey":"config.custom_fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"options":{"type":"array","items":{"type":"string","uniqueKey":"config.custom_fields.items.[INDEX].options.items.[INDEX]","typeLabel":"string"},"minItems":2,"maxItems":50,"description":"With type choice.","uniqueKey":"config.custom_fields.items.[INDEX].options","typeLabel":"string[]"}},"uniqueKey":"config.custom_fields.items.[INDEX]","typeLabel":"object"},"description":"With custom_fields: 1 to 20 questions answered from the recording.","uniqueKey":"config.custom_fields","typeLabel":"object[]"}},"uniqueKey":"config","typeLabel":"object"},"duration_ms":{"type":"integer","uniqueKey":"duration_ms","typeLabel":"integer"},"error":{"oneOf":[{"type":"string","description":"Why it failed or was canceled.","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Why it failed or was canceled.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"cost":{"type":"object","properties":{"currency":{"type":"string","const":"usd","uniqueKey":"cost.currency","typeLabel":"string"},"estimated_micro_usd":{"type":"integer","description":"Held from your balance when the transcript is created.","uniqueKey":"cost.estimated_micro_usd","typeLabel":"integer"},"charged_micro_usd":{"oneOf":[{"type":"integer","description":"Set when it completes. Failed and canceled transcripts are not charged.","uniqueKey":"cost.charged_micro_usd.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Set when it completes. Failed and canceled transcripts are not charged.","uniqueKey":"cost.charged_micro_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"cost.charged_micro_usd","typeLabel":"integer | null"}},"uniqueKey":"cost","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","object":"transcript","model":"\u003cstring>","status":"queued","file_name":"\u003cstring>","speaker_names":{},"config":{"model":"calico-1-flash","language":"auto","addons":["redact_pii"],"translate_to":["en"],"custom_fields":[{"key":"\u003cstring>","question":"\u003cstring>","type":"text","options":["\u003cstring>"]}]},"duration_ms":123,"error":"\u003cstring>","cost":{"currency":"usd","estimated_micro_usd":123,"charged_micro_usd":123},"created_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"5a1162b6-5d5b-4c90-bac6-afe25d4ad354":{"description":"Invalid request, or a recording outside 20 seconds to 3 hours","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9d9d9cd7-3fae-486a-8f16-e87e15696e67":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"dd9b4b12-2c59-4384-83d9-d44436daa61c":{"description":"Your balance is too low","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b74fc4f2-257b-428e-b2cd-d84dbb70f7e9":{"description":"Read-only API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3e835c3f-3b32-472b-bf72-a57140a27fbb":{"description":"Upload not completed, or Idempotency-Key reused for a different request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9e8a65bb-1ac1-4f43-9053-32d53a54309f":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","examples":["invalid_request","insufficient_credit","rate_limited"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support.","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f7bcd0d3-e93d-41fc-80fe-19d97d2a5537":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key: Authorization: Bearer mbk_live_...","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"9e209da8-d962-4cce-82bd-0b12f31fc69c":{"url":"https://app.maybloc.com/api/v1","description":"Maybloc v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key: Authorization: Bearer mbk_live_...","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key: Authorization: Bearer mbk_live_...","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://app.maybloc.com/openapi.json"},"subdomain":"o-nn","siteName":"Maybloc API","title":"Create a transcript - Maybloc API","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T14:25:40.337Z","originalFileLocation":"api-reference/create-a-transcript.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=\"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Maybloc API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_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/o-nn/vP_Xsg3dHH9czeLE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a transcript - Maybloc API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Maybloc API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.maybloc.com/api-reference/create-a-transcript\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://o-nn.mintlify.app/_mintlify/api/og/v2?division=Transcripts\u0026amp;title=Create+a+transcript\u0026amp;description=Queues+a+completed+upload+for+transcription+and+holds+its+price+from+your+balance.+Repeating+the+request+with+the+same+Idempotency-Key+returns+the+same+transcri\u0026amp;theme=b7290ed73f6a6320c1c027b0\u0026amp;signature=36e0e7d53a58c3bf410c6cac7c69c82b6bd5e6be45cb0d3c0232b887b3d00360\">\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=\"Create a transcript - Maybloc API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://o-nn.mintlify.app/_mintlify/api/og/v2?division=Transcripts\u0026amp;title=Create+a+transcript\u0026amp;description=Queues+a+completed+upload+for+transcription+and+holds+its+price+from+your+balance.+Repeating+the+request+with+the+same+Idempotency-Key+returns+the+same+transcri\u0026amp;theme=b7290ed73f6a6320c1c027b0\u0026amp;signature=36e0e7d53a58c3bf410c6cac7c69c82b6bd5e6be45cb0d3c0232b887b3d00360\">\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/o-nn/vP_Xsg3dHH9czeLE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Maybloc API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2f7fab\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.maybloc.com/api-reference/create-a-transcript\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-a-transcript.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://maybloc.com/#organization\",\"name\":\"Maybloc\",\"url\":\"https://maybloc.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/o-nn/eAIjl1JfYJdjAbyi/logo/light.webp?fit=max\u0026auto=format\u0026n=eAIjl1JfYJdjAbyi\u0026q=85\u0026s=137306f9cb6b2646bc22047565523de4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.maybloc.com#website\",\"name\":\"Maybloc API\",\"url\":\"https://docs.maybloc.com\",\"publisher\":{\"@id\":\"https://maybloc.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.maybloc.com/api-reference/create-a-transcript#webpage\",\"url\":\"https://docs.maybloc.com/api-reference/create-a-transcript\",\"name\":\"Create a transcript\",\"description\":\"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\",\"dateModified\":\"2026-10-26T14:25:40.337Z\",\"isPartOf\":{\"@id\":\"https://docs.maybloc.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.maybloc.com/api-reference/create-a-transcript#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.maybloc.com/api-reference/create-a-transcript#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transcripts\",\"item\":\"https://docs.maybloc.com/api-reference/list-transcripts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a transcript\",\"item\":\"https://docs.maybloc.com/api-reference/create-a-transcript\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.maybloc.com/api-reference/create-a-transcript#apireference\",\"headline\":\"Create a transcript\",\"name\":\"Create a transcript\",\"description\":\"Queues a completed upload for transcription and holds its price from your balance. Repeating the request with the same Idempotency-Key returns the same transcript and charges once.\",\"url\":\"https://docs.maybloc.com/api-reference/create-a-transcript\",\"mainEntityOfPage\":{\"@id\":\"https://docs.maybloc.com/api-reference/create-a-transcript#webpage\"},\"dateModified\":\"2026-10-26T14:25:40.337Z\",\"publisher\":{\"@id\":\"https://maybloc.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.maybloc.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Maybloc API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Maybloc API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Account","pages":[{"title":"Retrieve the account","openapi":"GET /account","href":"/api-reference/retrieve-the-account"}]},{"group":"Uploads","pages":[{"title":"Create an upload","openapi":"POST /uploads","href":"/api-reference/create-an-upload"},{"title":"Complete an upload","openapi":"POST /uploads/{id}/complete","href":"/api-reference/complete-an-upload"}]},{"group":"Transcripts","pages":[{"title":"List transcripts","openapi":"GET /transcripts","description":"Transcripts newest first, up to limit per page. To read the next page, pass the last id as starting_after while has_more is true.","href":"/api-reference/list-transcripts"},{"title":"Create a transcript","openapi":"POST /transcripts","href":"/api-reference/create-a-transcript"},{"title":"Retrieve a transcript","openapi":"GET /transcripts/{id}","description":"Returns the transcript's status, configuration, duration and cost. Poll it until status is completed, failed or canceled, then read the result.","href":"/api-reference/retrieve-a-transcript"},{"title":"Rename a transcript or its speakers","openapi":"PATCH /transcripts/{id}","href":"/api-reference/rename-a-transcript-or-its-speakers"},{"title":"Delete a transcript","openapi":"DELETE /transcripts/{id}","href":"/api-reference/delete-a-transcript"},{"title":"Retrieve the result","openapi":"GET /transcripts/{id}/result","href":"/api-reference/retrieve-the-result"},{"title":"Export subtitles or text","openapi":"GET /transcripts/{id}/export","href":"/api-reference/export-subtitles-or-text"},{"title":"Add add-ons","openapi":"POST /transcripts/{id}/addons","href":"/api-reference/add-add-ons"},{"title":"Cancel a transcript","openapi":"POST /transcripts/{id}/cancel","href":"/api-reference/cancel-a-transcript"}]}]}]},"title":"Create a transcript - Maybloc API","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DKJwRUt2.js","utils-CWD_VS3u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-oFjciODD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C76WsxC3.js","snippetPresets-DvPMxpX_.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CuNQfndH.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BVFpVUoF.js","shallow-t59Jg5Kr.js","getApiPlaygroundDisplay-C_JZ4amX.js","CodeSnippet-CLRDnx_h.js","CodeSnippets-C2myU4kc.js","Page-7TwLLapg.js","getPastedJson-B-JaVXw7.js","icon-BA-iDhH3.js","MethodPill-D4qZABFp.js","DuplicateIcon-THIDKO1O.js","createIcon-CYYJwgFd.js","DynamicMarkdown-UGQuxDKp.js","SectionHeading-jYELb23h.js","axios-vUo_bRtp.js","Markdown-DKsLa3wy.js","clsx-CefdjKz2.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BaREnp3o.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-sgx_0XzF.js"]}