{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Gladia","description":"Gladia is a state-of-the-art audio transcription and intelligence provider. We offer a simple API to get transcription from your audios and videos, in both Real-time and asynchronous ways, with audio intelligence tools to extract, analyze and understand data from your audios.","colors":{"primary":"#2e343e","light":"#FFFFFF","dark":"#2e343e"},"logo":{"light":"https://mintcdn.com/gladia-95/7AxFDxWc-Kx9YrXI/assets/images/logos/text-black.svg?fit=max\u0026auto=format\u0026n=7AxFDxWc-Kx9YrXI\u0026q=85\u0026s=859e5353abd40a9847f9e2c7484fed6e","dark":"https://mintcdn.com/gladia-95/7AxFDxWc-Kx9YrXI/assets/images/logos/text-white.svg?fit=max\u0026auto=format\u0026n=7AxFDxWc-Kx9YrXI\u0026q=85\u0026s=a5aa26d03764480054c8d3b955451fd4"},"favicon":"https://mintcdn.com/gladia-95/7AxFDxWc-Kx9YrXI/assets/icons/favicon.svg?fit=max\u0026auto=format\u0026n=7AxFDxWc-Kx9YrXI\u0026q=85\u0026s=9efa7a64cbd6179dba2bb8f9a9281c83","api":{"openapi":"https://api.gladia.io/openapi.json"},"appearance":{"default":"system","strict":false},"background":{"image":{"light":"","dark":""},"color":{"light":"#FFFFFF","dark":"#15181d"}},"navbar":{"links":[{"icon":"comment-question","href":"https://support.gladia.io/","label":"Support"},{"icon":"discord","href":"https://discord.gg/T22a4ETUQp","label":"Community"},{"icon":"newspaper","href":"https://www.gladia.io/blog","label":"Blog"}],"primary":{"type":"button","label":"Signup","href":"https://app.gladia.io/?utm_campaign=197609689-Website\u0026utm_source=documentation\u0026utm_content=sign-up"}},"footer":{"socials":{"twitter":"https://twitter.com/gladia_io","github":"https://github.com/gladiaio","linkedin":"https://www.linkedin.com/company/gladia-io"}},"seo":{"indexing":"all"},"fonts":{"family":"Inter"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"gtm":{"tagId":"GTM-MKBBGXGP"},"hotjar":{"hjid":"5197599","hjsv":"6"},"intercom":{"appId":"zkqf4zax"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gladia-95","hasAudioNarration":false,"actualSubdomain":"gladia-95","customDomains":["docs.gladia.io"],"gitSource":{"type":"github","owner":"gladiaio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":false,"edits":false,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aed96cfe36b681e5080173c","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":55},{"language":"default","tag":"API Reference","count":43},{"language":"default","tag":"Live endpoints","count":25},{"language":"default","tag":"Callbacks","count":17},{"language":"default","tag":"Audio Intelligence","count":12},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"Pre-recorded endpoints","count":11},{"language":"default","tag":"Speech-to-Text","count":9},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Realtime messages","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@media (min-width: 1280px){.prose{max-width:88ch}main [class*=\"max-w-\"]{max-width:1180px!important}#content-area,#mintlify-content{max-width:1180px!important}#content-container{padding-left:5rem;padding-right:3rem}}.prose pre{max-width:100%;overflow:auto}"}]}
{"page":{"pagePath":"api-reference/v2/live/message/translation","slug":"/api-reference/v2/live/message/translation","pageMetadata":{"title":"Translation","description":"Payload definition for the message `translation`.","openapi-schema":"TranslationMessage","href":"/api-reference/v2/live/message/translation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Payload definition for the message \", _jsx(_components.code, {\n children: \"translation\"\n }), \".\"]\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Translation","description":"Payload definition for the message `translation`.","openapi-schema":"TranslationMessage","href":"/api-reference/v2/live/message/translation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/gladia-95/e75c57c68c49919f/vox-widget.js"],"openApiReferenceData":{"schemaData":{"type":"object","properties":{"session_id":{"type":"string","description":"Id of the live session","example":"4a39145c-2844-4557-8f34-34883f7be7d9","isRequired":true,"uniqueKey":"session_id","typeLabel":"string"},"created_at":{"type":"string","description":"Date of creation of the message. The date is formatted as an ISO 8601 string","example":"2021-09-01T12:00:00.123Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string"},"error":{"oneOf":[{"type":"object","description":"Error message if the addon failed","required":["message"],"example":null,"properties":{"message":{"type":"string","description":"The error message","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"type":{"type":"string","enum":["translation"],"example":"translation","default":"translation","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"data":{"oneOf":[{"type":"object","description":"The message data. \"null\" if the addon failed","required":["utterance_id","utterance","original_language","target_language","translated_utterance"],"properties":{"utterance_id":{"type":"string","description":"Id of the utterance used for this result","example":"00-00000011","isRequired":true,"uniqueKey":"data.oneOf.0.utterance_id","typeLabel":"string"},"utterance":{"type":"object","description":"The transcribed utterance","required":["start","end","confidence","channel","words","text","language"],"properties":{"start":{"type":"number","description":"Start timestamp in seconds of this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.start","typeLabel":"number"},"end":{"type":"number","description":"End timestamp in seconds of this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.end","typeLabel":"number"},"confidence":{"type":"number","description":"Confidence on the transcribed utterance (1 = 100% confident)","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.confidence","typeLabel":"number"},"channel":{"type":"integer","description":"Audio channel of where this utterance has been transcribed from","minimum":0,"isRequired":true,"uniqueKey":"data.oneOf.0.utterance.channel","typeLabel":"integer"},"words":{"description":"List of words of the utterance, split by timestamp","type":"array","items":{"type":"object","properties":{"word":{"type":"string","description":"Spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.words.items.[INDEX].word","typeLabel":"string"},"start":{"type":"number","description":"Start timestamps in seconds of the spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.words.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","description":"End timestamps in seconds of the spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.words.items.[INDEX].end","typeLabel":"number"},"confidence":{"type":"number","description":"Confidence on the transcribed word (1 = 100% confident)","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.words.items.[INDEX].confidence","typeLabel":"number"}},"required":["word","start","end","confidence"],"uniqueKey":"data.oneOf.0.utterance.words.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.oneOf.0.utterance.words","typeLabel":"object[]"},"text":{"type":"string","description":"Transcription for this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.text","typeLabel":"string"},"language":{"type":"string","description":"Spoken language in this utterance","enum":["af","am","ar","as","az","ba","be","bg","bn","bo","br","bs","ca","cs","cy","da","de","el","en","es","et","eu","fa","fi","fo","fr","gl","gu","ha","haw","he","hi","hr","ht","hu","hy","id","is","it","ja","jw","ka","kk","km","kn","ko","la","lb","ln","lo","lt","lv","mg","mi","mk","ml","mn","mr","ms","mt","my","ne","nl","nn","no","oc","pa","pl","ps","pt","ro","ru","sa","sd","si","sk","sl","sn","so","sq","sr","su","sv","sw","ta","te","tg","th","tk","tl","tr","tt","uk","ur","uz","vi","yi","yo","zh"],"example":"en","isRequired":true,"uniqueKey":"data.oneOf.0.utterance.language","typeLabel":"enum\u003cstring>"},"speaker":{"type":"integer","description":"If `diarization` enabled, speaker identification number","minimum":0,"uniqueKey":"data.oneOf.0.utterance.speaker","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"data.oneOf.0.utterance","typeLabel":"object"},"original_language":{"type":"string","description":"The original language in `iso639-1` or `iso639-2` format depending on the language","enum":["af","am","ar","as","az","ba","be","bg","bn","bo","br","bs","ca","cs","cy","da","de","el","en","es","et","eu","fa","fi","fo","fr","gl","gu","ha","haw","he","hi","hr","ht","hu","hy","id","is","it","ja","jw","ka","kk","km","kn","ko","la","lb","ln","lo","lt","lv","mg","mi","mk","ml","mn","mr","ms","mt","my","ne","nl","nn","no","oc","pa","pl","ps","pt","ro","ru","sa","sd","si","sk","sl","sn","so","sq","sr","su","sv","sw","ta","te","tg","th","tk","tl","tr","tt","uk","ur","uz","vi","yi","yo","zh"],"isRequired":true,"uniqueKey":"data.oneOf.0.original_language","typeLabel":"enum\u003cstring>"},"target_language":{"type":"string","description":"The target language in `iso639-1` or `iso639-2` format depending on the language","enum":["af","am","ar","as","az","ba","be","bg","bn","bo","br","bs","ca","cs","cy","da","de","el","en","es","et","eu","fa","fi","fo","fr","gl","gu","ha","haw","he","hi","hr","ht","hu","hy","id","is","it","ja","jw","ka","kk","km","kn","ko","la","lb","ln","lo","lt","lv","mg","mi","mk","ml","mn","mr","ms","mt","my","ne","nl","nn","no","oc","pa","pl","ps","pt","ro","ru","sa","sd","si","sk","sl","sn","so","sq","sr","su","sv","sw","ta","te","tg","th","tk","tl","tr","tt","uk","ur","uz","vi","wo","yi","yo","zh"],"isRequired":true,"uniqueKey":"data.oneOf.0.target_language","typeLabel":"enum\u003cstring>"},"translated_utterance":{"type":"object","description":"The translated utterance","required":["start","end","confidence","channel","words","text","language"],"properties":{"start":{"type":"number","description":"Start timestamp in seconds of this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.start","typeLabel":"number"},"end":{"type":"number","description":"End timestamp in seconds of this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.end","typeLabel":"number"},"confidence":{"type":"number","description":"Confidence on the transcribed utterance (1 = 100% confident)","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.confidence","typeLabel":"number"},"channel":{"type":"integer","description":"Audio channel of where this utterance has been transcribed from","minimum":0,"isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.channel","typeLabel":"integer"},"words":{"description":"List of words of the utterance, split by timestamp","type":"array","items":{"type":"object","properties":{"word":{"type":"string","description":"Spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.words.items.[INDEX].word","typeLabel":"string"},"start":{"type":"number","description":"Start timestamps in seconds of the spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.words.items.[INDEX].start","typeLabel":"number"},"end":{"type":"number","description":"End timestamps in seconds of the spoken word","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.words.items.[INDEX].end","typeLabel":"number"},"confidence":{"type":"number","description":"Confidence on the transcribed word (1 = 100% confident)","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.words.items.[INDEX].confidence","typeLabel":"number"}},"required":["word","start","end","confidence"],"uniqueKey":"data.oneOf.0.translated_utterance.words.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.words","typeLabel":"object[]"},"text":{"type":"string","description":"Transcription for this utterance","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.text","typeLabel":"string"},"language":{"type":"string","description":"Spoken language in this utterance","enum":["af","am","ar","as","az","ba","be","bg","bn","bo","br","bs","ca","cs","cy","da","de","el","en","es","et","eu","fa","fi","fo","fr","gl","gu","ha","haw","he","hi","hr","ht","hu","hy","id","is","it","ja","jw","ka","kk","km","kn","ko","la","lb","ln","lo","lt","lv","mg","mi","mk","ml","mn","mr","ms","mt","my","ne","nl","nn","no","oc","pa","pl","ps","pt","ro","ru","sa","sd","si","sk","sl","sn","so","sq","sr","su","sv","sw","ta","te","tg","th","tk","tl","tr","tt","uk","ur","uz","vi","yi","yo","zh"],"example":"en","isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance.language","typeLabel":"enum\u003cstring>"},"speaker":{"type":"integer","description":"If `diarization` enabled, speaker identification number","minimum":0,"uniqueKey":"data.oneOf.0.translated_utterance.speaker","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"data.oneOf.0.translated_utterance","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"object | null"}},"required":["session_id","created_at","error","type","data"],"uniqueKey":"","typeLabel":"object","example":{"title":"Example","value":{"session_id":"4a39145c-2844-4557-8f34-34883f7be7d9","created_at":"2021-09-01T12:00:00.123Z","error":null,"type":"translation","data":{"utterance_id":"00-00000011","utterance":{"start":123,"end":123,"confidence":123,"channel":1,"words":[{"word":"\u003cstring>","start":123,"end":123,"confidence":123}],"text":"\u003cstring>","language":"en","speaker":1},"translated_utterance":{"start":123,"end":123,"confidence":123,"channel":1,"words":[{"word":"\u003cstring>","start":123,"end":123,"confidence":123}],"text":"\u003cstring>","language":"en","speaker":1}}}}},"originalFileLocation":"https://api.gladia.io/openapi.json"},"subdomain":"gladia-95","siteName":"Gladia","title":"Translation - Gladia","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-11T10:09:25.798Z","originalFileLocation":"api-reference/v2/live/message/translation.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=\"Payload definition for the message translation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gladia\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_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/gladia-95/C6Kx4RCj0cgFXBjD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Translation - Gladia\">\u003cmeta data-mint-head property=\"og:description\" content=\"Payload definition for the message translation.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gladia\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gladia.io/api-reference/v2/live/message/translation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gladia-95.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Translation\u0026amp;description=Payload+definition+for+the+message+%60translation%60.\u0026amp;theme=e0e1724ef500c8bc024a3a3d\u0026amp;signature=e484ba125fdd9857c5ebb3e99289c16304cc682d0087080450f9cec49a40bbb5\">\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=\"Translation - Gladia\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Payload definition for the message translation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gladia-95.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Translation\u0026amp;description=Payload+definition+for+the+message+%60translation%60.\u0026amp;theme=e0e1724ef500c8bc024a3a3d\u0026amp;signature=e484ba125fdd9857c5ebb3e99289c16304cc682d0087080450f9cec49a40bbb5\">\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/gladia-95/C6Kx4RCj0cgFXBjD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gladia\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2e343e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gladia.io/api-reference/v2/live/message/translation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/live/message/translation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gladia.io/#organization\",\"name\":\"Gladia\",\"url\":\"https://docs.gladia.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gladia-95/7AxFDxWc-Kx9YrXI/assets/images/logos/text-black.svg?fit=max\u0026auto=format\u0026n=7AxFDxWc-Kx9YrXI\u0026q=85\u0026s=859e5353abd40a9847f9e2c7484fed6e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gladia.io#website\",\"name\":\"Gladia\",\"url\":\"https://docs.gladia.io\",\"publisher\":{\"@id\":\"https://docs.gladia.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gladia.io/api-reference/v2/live/message/translation#webpage\",\"url\":\"https://docs.gladia.io/api-reference/v2/live/message/translation\",\"name\":\"Translation\",\"description\":\"Payload definition for the message translation.\",\"dateModified\":\"2025-08-11T10:09:25.798Z\",\"isPartOf\":{\"@id\":\"https://docs.gladia.io#website\"}},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gladia.io/api-reference/v2/live/message/translation#apireference\",\"headline\":\"Translation\",\"name\":\"Translation\",\"description\":\"Payload definition for the message translation.\",\"url\":\"https://docs.gladia.io/api-reference/v2/live/message/translation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gladia.io/api-reference/v2/live/message/translation#webpage\"},\"dateModified\":\"2025-08-11T10:09:25.798Z\",\"publisher\":{\"@id\":\"https://docs.gladia.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gladia.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gladia\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gladia\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v2/live/message/translation.md","siteName":"Gladia","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Introduction","pages":[{"title":"Welcome to Gladia","mode":"wide","href":"/chapters/introduction"},{"title":"Getting started","mode":"wide","href":"/chapters/introduction/getting-started"},{"title":"Models","href":"/chapters/introduction/models"}]},{"group":"How to use Gladia","pages":[{"title":"SDK","href":"/chapters/how-to-use-gladia/sdk"},{"title":"Playground","mode":"wide","href":"/chapters/how-to-use-gladia/playground"},{"title":"CLI","href":"/chapters/how-to-use-gladia/cli"},{"title":"Gladia MCP","url":"https://github.com/gladiaio/gladia-mcp","href":"/chapters/how-to-use-gladia/mcp"},{"title":"Benchmarking","href":"/chapters/how-to-use-gladia/benchmarking"},{"title":"GladiaFlow","href":"/chapters/how-to-use-gladia/gladia-flow"}]},{"group":"Speech-to-Text","pages":[{"group":"Pre-recorded Transcription","expanded":true,"pages":[{"title":"Quickstart","href":"/chapters/pre-recorded-stt/quickstart"},{"title":"Transcription process \u0026 retry policy","sidebarTitle":"Process \u0026 retries","href":"/chapters/pre-recorded-stt/transcription-process"},{"title":"Audio Intelligence","href":"/chapters/pre-recorded-stt/audio-intelligence"},{"title":"Recommended Parameters by Use Case","sidebarTitle":"Recommended Parameters","href":"/chapters/pre-recorded-stt/recommended-parameters"}]},{"group":"Live Transcription","expanded":false,"pages":[{"title":"Streaming speech-to-text quickstart","sidebarTitle":"Quickstart","href":"/chapters/live-stt/quickstart"},{"title":"Audio Intelligence","href":"/chapters/live-stt/audio-intelligence"},{"title":"Endpointing","sidebarTitle":"Endpointing","href":"/chapters/live-stt/features/endpointing"},{"title":"Partial transcripts","href":"/chapters/live-stt/features/partial-transcripts"},{"title":"Recommended Parameters by Use Case","sidebarTitle":"Recommended Parameters","href":"/chapters/live-stt/recommended-parameters"}]}]},{"group":"Language","pages":[{"title":"Automatic language detection for audio","sidebarTitle":"Automatic language detection","href":"/chapters/language/language-detection"},{"title":"Code switching in multilingual audio","sidebarTitle":"Code switching","href":"/chapters/language/code-switching"},{"title":"Supported languages","mode":"wide","href":"/chapters/language/supported-languages"}]},{"group":"Audio Intelligence","pages":[{"title":"Speaker diarization for pre-recorded audio","sidebarTitle":"Diarization","href":"/chapters/audio-intelligence/speaker-diarization"},{"title":"Translation","href":"/chapters/audio-intelligence/translation"},{"title":"Export subtitles (SRT/VTT)","sidebarTitle":"Subtitles","href":"/chapters/audio-intelligence/subtitles"},{"title":"Sentences","href":"/chapters/audio-intelligence/sentences"},{"title":"Custom vocabulary","href":"/chapters/audio-intelligence/custom-vocabulary"},{"title":"Custom spelling","href":"/chapters/audio-intelligence/custom-spelling"},{"title":"Named Entity Recognition","href":"/chapters/audio-intelligence/named-entity-recognition"},{"title":"PII Redaction","href":"/chapters/audio-intelligence/pii-redaction"},{"title":"Sentiment and Emotion Analysis","sidebarTitle":"Sentiment Analysis","href":"/chapters/audio-intelligence/sentiment-analysis"},{"title":"Summarization","href":"/chapters/audio-intelligence/summarization"},{"title":"Audio-to-LLM","href":"/chapters/audio-intelligence/audio-to-llm"},{"title":"Custom metadata","href":"/chapters/audio-intelligence/custom-metadata"}]},{"group":"Integrations","pages":[{"title":"Pipecat","href":"/chapters/integrations/pipecat"},{"title":"Livekit","href":"/chapters/integrations/livekit"},{"title":"Vapi","url":"https://docs.vapi.ai/providers/transcriber/gladia","href":"/chapters/integrations/vapi"},{"title":"Recall","href":"/chapters/integrations/recall"},{"title":"Meeting BaaS","href":"/chapters/integrations/meeting-baas"},{"title":"Attendee","href":"/chapters/integrations/attendee"},{"title":"Twilio","href":"/chapters/integrations/twilio"},{"title":"VideoSDK","href":"/chapters/integrations/videosdk"},{"title":"Composio","href":"/chapters/integrations/composio"},{"title":"Zapier","href":"/chapters/integrations/zapier"},{"title":"Make","href":"/chapters/integrations/make"},{"title":"n8n","href":"/chapters/integrations/n8n"}]},{"group":"Developer tools","pages":[{"title":"Gladia CLI","href":"/chapters/developer-tools/gladia-cli"},{"title":"Gladia Skills","url":"https://github.com/gladiaio/skills","href":"/chapters/developer-tools/gladia-skills"}]},{"group":"Limits \u0026 Specifications","pages":[{"title":"API rate limits and transcription concurrency","sidebarTitle":"Concurrency","href":"/chapters/limits-and-specifications/concurrency"},{"title":"Multiple channels","href":"/chapters/limits-and-specifications/multiple-channels"},{"title":"Supported files \u0026 duration","href":"/chapters/limits-and-specifications/supported-formats"},{"title":"Data retention and zero data retention","sidebarTitle":"Data retention","href":"/chapters/limits-and-specifications/data-retention"}]},{"group":"Migrations","pages":[{"title":"Quick migration guide: realtime STT from Deepgram to Gladia","sidebarTitle":"From Deepgram","href":"/chapters/migrations/from-deepgram"},{"title":"Quick migration guide: realtime STT from AssemblyAI to Gladia","sidebarTitle":"From AssemblyAI","href":"/chapters/migrations/from-assembly"},{"group":"Gladia V2","expanded":true,"pages":[{"title":"Live transcription - Migration guide from V1 to V2","sidebarTitle":"Live transcription - V1 to V2","href":"/chapters/live-stt/migration-from-v1"},{"title":"Pre-recorded - Migration guide from V1 to V2","sidebarTitle":"Pre-recorded - V1 to V2","href":"/chapters/pre-recorded-stt/migration-from-v1"}]}]}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Live endpoints","pages":[{"title":"Initiate a session","openapi":"POST /v2/live","href":"/api-reference/v2/live/init"},{"title":"Live WebSocket","asyncapi":"asyncapi.yaml liveTranscription","href":"/api-reference/v2/live/websocket"},{"title":"Get result","openapi":"GET /v2/live/{id}","href":"/api-reference/v2/live/get"},{"title":"List transcriptions","openapi":"GET /v2/live","href":"/api-reference/v2/live/list"},{"title":"Download audio file","openapi":"GET /v2/live/{id}/file","href":"/api-reference/v2/live/get-audio"},{"title":"Delete transcription","openapi":"delete /v2/live/{id}","href":"/api-reference/v2/live/delete"},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Start session","href":"/api-reference/v2/live/webhook/start-session"},{"title":"Start recording","href":"/api-reference/v2/live/webhook/start-recording"},{"title":"End recording","href":"/api-reference/v2/live/webhook/end-recording"},{"title":"End session","href":"/api-reference/v2/live/webhook/end-session"}]},{"group":"Callbacks","icon":"reply-all","pages":[{"group":"Realtime messages","pages":[{"title":"Transcript","href":"/api-reference/v2/live/callback/transcript"},{"title":"Speech Start","href":"/api-reference/v2/live/callback/speech-start"},{"title":"Speech End","href":"/api-reference/v2/live/callback/speech-end"},{"title":"Translation","href":"/api-reference/v2/live/callback/translation"},{"title":"Named Entity Recognition","href":"/api-reference/v2/live/callback/named-entity-recognition"},{"title":"Sentiment Analysis","href":"/api-reference/v2/live/callback/sentiment-analysis"}]},{"group":"Post-processing messages","pages":[{"title":"Post Transcript","href":"/api-reference/v2/live/callback/post-transcript"},{"title":"Final transcript","href":"/api-reference/v2/live/callback/post-final-transcript"},{"title":"Summarization","href":"/api-reference/v2/live/callback/post-summarization"}]},{"group":"Acknowledgment messages","pages":[{"title":"Audio chunk acknowledge (ack)","href":"/api-reference/v2/live/callback/audio-chunk-ack"},{"title":"Stop recording acknowledge (ack)","href":"/api-reference/v2/live/callback/stop-recording-ack"}]},{"group":"Lifecycle messages","pages":[{"title":"Start session","href":"/api-reference/v2/live/callback/start-session"},{"title":"Start recording","href":"/api-reference/v2/live/callback/start-recording"},{"title":"End recording","href":"/api-reference/v2/live/callback/end-recording"},{"title":"End session","href":"/api-reference/v2/live/callback/end-session"}]}]}]},{"group":"Pre-recorded endpoints","pages":[{"title":"Upload a file","openapi":"post /v2/upload","href":"/api-reference/v2/upload/audio-file"},{"title":"Initiate a transcription","openapi":"POST /v2/pre-recorded","href":"/api-reference/v2/pre-recorded/init"},{"title":"Get result","openapi":"GET /v2/pre-recorded/{id}","href":"/api-reference/v2/pre-recorded/get"},{"title":"List transcriptions","openapi":"GET /v2/pre-recorded","href":"/api-reference/v2/pre-recorded/list"},{"title":"Download audio file","openapi":"GET /v2/pre-recorded/{id}/file","href":"/api-reference/v2/pre-recorded/get-audio"},{"title":"Delete transcription","openapi":"delete /v2/pre-recorded/{id}","href":"/api-reference/v2/pre-recorded/delete"},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Created","href":"/api-reference/v2/pre-recorded/webhook/created"},{"title":"Success","href":"/api-reference/v2/pre-recorded/webhook/success"},{"title":"Error","href":"/api-reference/v2/pre-recorded/webhook/error"}]},{"group":"Callbacks","icon":"reply-all","pages":[{"title":"Success","href":"/api-reference/v2/pre-recorded/callback/success"},{"title":"Error","href":"/api-reference/v2/pre-recorded/callback/error"}]}]},{"group":"Transcription (deprecated)","pages":[{"title":"Initiate a transcription","openapi":"POST /v2/transcription","href":"/api-reference/v2/transcription/init"},{"title":"Get result","openapi":"GET /v2/transcription/{id}","href":"/api-reference/v2/transcription/get"},{"title":"List transcriptions","openapi":"GET /v2/transcription","href":"/api-reference/v2/transcription/list"},{"title":"Download audio file","openapi":"GET /v2/transcription/{id}/file","href":"/api-reference/v2/transcription/get-audio"},{"title":"Delete transcription","openapi":"delete /v2/transcription/{id}","href":"/api-reference/v2/transcription/delete"}]}]}]},"basePath":"","title":"Translation - Gladia","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}