Controls how the audio is cut into chunks. When set to "auto", the server first normalizes loudness and then uses voice activity detection (VAD) to choose boundaries. server_vad object can be provided to tweak VAD detection parameters manually. If unset, the audio is transcribed as a single block.
The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.
Response
Audio transcription, or an SSE stream when stream is true.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"FriendliAI Docs","description":"Let your team focus on building great AI products. FriendliAI will make sure your AI runs fast, affordable, and reliable at scale. Leave the hassle of AI inference to FriendliAI.","colors":{"primary":"#2A62DB","light":"#4f87ff","dark":"#1e469b"},"logo":{"light":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0","dark":"https://mintcdn.com/friendliai/OmGyXdVnt91Gfn8z/static/svgs/logo-dark.svg?fit=max\u0026auto=format\u0026n=OmGyXdVnt91Gfn8z\u0026q=85\u0026s=7bc2b761b9c8da66973a9869b7de4f90"},"favicon":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/favicon.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=d425e1903adeb917593a54eb3d20c66b","api":{"openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"prefill":true,"autogenerate":true}},"background":{"color":{"light":"#FFFFFF","dark":"#0A101A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://friendli.ai/get-started/dedicated-endpoints"}},"footer":{"socials":{"website":"https://friendli.ai","linkedin":"https://www.linkedin.com/company/friendliai","youtube":"https://www.youtube.com/@friendliai","github":"https://github.com/friendliai","discord":"https://discord.gg/g53ByexhR","x":"https://x.com/friendliai","medium":"https://medium.com/friendliai","facebook":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","slack":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","instagram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","hacker-news":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","telegram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","x-twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","earth-americas":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","bluesky":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","threads":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","reddit":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","podcast":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css"}},"search":{"prompt":"Search FriendliAI Docs..."},"seo":{"metatags":{"og:site_name":"FriendliAI Docs","twitter:card":"summary_large_image"}},"integrations":{"gtm":{"tagId":"GTM-MVXVF29V"},"telemetry":{"enabled":true}},"banner":{"content":"Try [GLM-5.3](https://friendli.ai/models/zai-org/GLM-5.3) and [GLM-5.3-Flash](https://friendli.ai/models/zai-org/GLM-5.3-Flash) today. To learn more, see the [FriendliAI Blog](https://friendli.ai/blog)."},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"friendliai","hasAudioNarration":false,"actualSubdomain":"friendliai","customDomains":["friendli.ai"],"gitSource":{"type":"github","owner":"friendliai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4535af70ad676a5c58ff7","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Guides","count":45},{"language":"default","tag":"Examples","count":40},{"language":"default","tag":"Reference","count":36},{"language":"default","tag":"Inference","count":30},{"language":"default","tag":"Archive","count":24},{"language":"default","tag":"Dedicated","count":24},{"language":"default","tag":"Friendli Container","count":23},{"language":"default","tag":"Agents","count":14},{"language":"default","tag":"Friendli Dedicated Endpoints","count":12},{"language":"default","tag":"API Reference","count":12}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@friendli.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Z5ClqOw.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Q5ClqOw.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK7uxQxXAuk.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5b5ClqOw.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5a5ClqOw.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5U5Ck.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n@font-face{font-family:\"Saans-Light\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff\") format(\"woff\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Regular\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff\")\n\t\tformat(\"woff\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Medium\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff\")\n\t\tformat(\"woff\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-SemiBold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff\")\n\t\tformat(\"woff\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Bold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff\") format(\"woff\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Heavy\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff\") format(\"woff\");font-weight:800;font-style:normal;font-display:swap}:root{--gray-300: 159 179 200;--primary-accent: #0095ff}.border-gray-100{border-color:#d9e2ec}body{font-family:\"Saans-Regular\", sans-serif;letter-spacing:0.01em}.tracking-tighter{letter-spacing:-0.04em}.tracking-tight{letter-spacing:0.01em}.tracking-normal{letter-spacing:0.01em}.tracking-wide{letter-spacing:0.01em}.tracking-wider{letter-spacing:0.05em}.tracking-widest{letter-spacing:0.1em}.prose :where(h1,h2,h3):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)){letter-spacing:0}.font-medium:not(.font-mono):not(.font-mono *),.mint-font-medium:not(.font-mono):not(.font-mono *){font-family:\"Saans-Medium\", sans-serif}h1:not(.font-mono):not(.font-mono *),h2:not(.font-mono):not(.font-mono *),h3:not(.font-mono):not(.font-mono *),h4:not(.font-mono):not(.font-mono *),h5:not(.font-mono):not(.font-mono *),strong:not(.font-mono):not(.font-mono *),.font-semibold:not(.font-mono):not(.font-mono *),.mint-font-semibold:not(.font-mono):not(.font-mono *),.prose :where(a):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)):not(.font-mono):not(.font-mono *){font-family:\"Saans-SemiBold\", sans-serif}.prose :is(p,li,td,dd) svg.icon{vertical-align:-0.025em!important}.prose :is(p,li,td,dd) a[href^=\"http\"]:not([href*=\"friendli.ai\"]):not(:has(img))::after{content:\"\";display:inline-block;width:0.7em;height:0.7em;margin-left:0.2em;vertical-align:-0.05em;background-color:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain;mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain}code:not(.font-mono *),pre,kbd,.font-mono{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, monospace}#banner{background-color:var(--primary-accent);font-size:16px;box-shadow:none}#banner>div{margin-top:0.625rem;margin-bottom:0.625rem;p {\n\t\tcolor: #ffffff;\n\t}\n\n\ta {\n\t\tcolor: #ffffff;\n\t\tfont-weight: 600;\n\t\ttext-decoration: underline;\n\t\tpadding-left: 0.25rem;\n\t}}#topbar-cta-button,#topbar-cta-button a,#topbar-cta-button.bg-primary-dark,#topbar-cta-button .bg-primary-dark{background-color:#2a62db!important;color:#ffffff!important;border:none!important;border-radius:6px;box-shadow:none!important}#topbar-cta-button:hover,#topbar-cta-button:hover a,#topbar-cta-button:hover .bg-primary-dark,#topbar-cta-button a:hover,#topbar-cta-button a:hover .bg-primary-dark,#topbar-cta-button.bg-primary-dark:hover,#topbar-cta-button .bg-primary-dark:hover{background-color:#1a4ec4!important}#topbar-cta-button>.font-medium,#topbar-cta-button>.mint-font-medium{font-family:\"Saans-Medium\", sans-serif}#header>div:not(:first-child){display:none}.card>div>div:last-child>div{margin-top:0.5rem}.card [data-component-part=\"card-content\"]{font-family:\"Saans-Regular\", sans-serif}.card-group.columns{gap:1rem}.rounded-border-box{padding:28px 44px;border:1px solid #d9e2ec;border-radius:8px;overflow:hidden;img {\n\t\tmargin: 0 auto;\n\t\tborder: 1px solid #e7eef4;\n\t\tborder-radius: 8px;\n\t}\n\n\tp {\n\t\tmargin: 12px auto -12px;\n\t\ttext-align: center;\n\t\tword-break: break-all;\n\t}}.dark .rounded-border-box{border:1px solid #243b53}.dark .rounded-border-box img{border:1px solid #212832}html[data-current-path=\"/\"] .nav-tabs-item[data-active]{text-shadow:none}html[data-current-path=\"/\"] .nav-tabs-item[data-active]>div{display:none}html[data-current-path=\"/\"] #content-container{max-width:none;padding-inline:1rem}html[data-current-path=\"/\"] #header{display:none}html[data-current-path=\"/\"] #content{margin-top:0}#footer [href=\"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css\"]{display:none}"}],"page":{"pagePath":"openapi/container/audio-transcriptions","slug":"/openapi/container/audio-transcriptions","pageMetadata":{"title":"Container Audio Transcriptions","description":"Transcribe an audio file into text.","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","og:title":"Container Audio Transcriptions","og:description":"Transcribe an audio file into text.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/audio/transcriptions","href":"/openapi/container/audio-transcriptions","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: \"Transcribe an audio file into text.\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Transcribe an audio file into text.`})}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":"Container Audio Transcriptions","description":"Transcribe an audio file into text.","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","og:title":"Container Audio Transcriptions","og:description":"Transcribe an audio file into text.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/audio/transcriptions","href":"/openapi/container/audio-transcriptions","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/friendliai/13360a4393f88fc7/script.js"],"openApiReferenceData":{"operation":{"tags":["Container.Audio"],"summary":"Audio transcriptions","description":"Transcribe an audio file into text.","operationId":"containerAudioTranscriptions","requestBody":"c6994cb6-3853-4791-af2f-0bedbe5df0d1","responses":{"200":"2300f367-44ed-4fe3-a2bb-d6d43444d322","422":"a21cad42-0943-4527-918c-58488a9b3c13"},"x-speakeasy-name-override":"transcribe","x-mint":{"metadata":{"title":"Container Audio Transcriptions","sidebarTitle":"Audio Transcriptions","og:title":"Container Audio Transcriptions","description":"Transcribe an audio file into text.","og:description":"Transcribe an audio file into text."},"href":"/openapi/container/audio-transcriptions","content":"Transcribe an audio file into text."},"method":"post","type":"path","servers":["ce930cca-ca05-4f60-b500-2ea7d0b970d0"],"security":[],"path":"/v1/audio/transcriptions","baseUrlOptions":["http://localhost:8000"],"title":"Audio transcriptions","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.file":"@/path/to/file/audio.mp3"}]},"dependencies":{"parameters":{},"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"The audio file object (not file name) to transcribe, in one of these formats: mp3, wav, flac, ogg, and many other standard audio formats.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"model":{"oneOf":[{"type":"string","title":"Model","description":"Routes the request to a specific adapter.","example":"(adapter-route)","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","description":"Routes the request to a specific adapter.","example":"(adapter-route)","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"chunking_strategy":{"oneOf":[{"type":"string","title":"Chunking Strategy","description":"Controls how the audio is cut into chunks. When set to `\"auto\"`, the server first normalizes loudness and then uses voice activity detection (VAD) to choose boundaries. `server_vad` object can be provided to tweak VAD detection parameters manually. If unset, the audio is transcribed as a single block.","const":"auto","uniqueKey":"chunking_strategy.oneOf.0","typeLabel":"string"},{"type":"object","title":"ServerVadChunkingStrategy","description":"Controls how the audio is cut into chunks. When set to `\"auto\"`, the server first normalizes loudness and then uses voice activity detection (VAD) to choose boundaries. `server_vad` object can be provided to tweak VAD detection parameters manually. If unset, the audio is transcribed as a single block.","required":["type"],"properties":{"type":{"type":"string","const":"server_vad","title":"Type","description":"Must be set to `server_vad` to enable manual chunking using server side VAD.","isRequired":true,"uniqueKey":"chunking_strategy.oneOf.1.type","typeLabel":"string"},"prefix_padding_ms":{"oneOf":[{"type":"integer","title":"Prefix Padding Ms","description":"Amount of audio to include before the VAD detected speech (in milliseconds).","default":300,"uniqueKey":"chunking_strategy.oneOf.1.prefix_padding_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Prefix Padding Ms","description":"Amount of audio to include before the VAD detected speech (in milliseconds).","default":300,"uniqueKey":"chunking_strategy.oneOf.1.prefix_padding_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"chunking_strategy.oneOf.1.prefix_padding_ms","typeLabel":"integer | null"},"silence_duration_ms":{"oneOf":[{"type":"integer","title":"Silence Duration Ms","description":"Duration of silence to detect speech stop (in milliseconds). With shorter values the model will respond more quickly, but may jump in on short pauses from the user.","default":200,"uniqueKey":"chunking_strategy.oneOf.1.silence_duration_ms.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Silence Duration Ms","description":"Duration of silence to detect speech stop (in milliseconds). With shorter values the model will respond more quickly, but may jump in on short pauses from the user.","default":200,"uniqueKey":"chunking_strategy.oneOf.1.silence_duration_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"chunking_strategy.oneOf.1.silence_duration_ms","typeLabel":"integer | null"},"threshold":{"oneOf":[{"type":"number","title":"Threshold","description":"Sensitivity threshold (0.0 to 1.0) for voice activity detection. A higher threshold will require louder audio to activate the model, and thus might perform better in noisy environments.","default":0.5,"uniqueKey":"chunking_strategy.oneOf.1.threshold.oneOf.0","typeLabel":"number"},{"type":"null","title":"Threshold","description":"Sensitivity threshold (0.0 to 1.0) for voice activity detection. A higher threshold will require louder audio to activate the model, and thus might perform better in noisy environments.","default":0.5,"uniqueKey":"chunking_strategy.oneOf.1.threshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"chunking_strategy.oneOf.1.threshold","typeLabel":"number | null"}},"uniqueKey":"chunking_strategy.oneOf.1","typeLabel":"ServerVadChunkingStrategy · object"},{"type":"null","title":"Chunking Strategy","description":"Controls how the audio is cut into chunks. When set to `\"auto\"`, the server first normalizes loudness and then uses voice activity detection (VAD) to choose boundaries. `server_vad` object can be provided to tweak VAD detection parameters manually. If unset, the audio is transcribed as a single block.","uniqueKey":"chunking_strategy.oneOf.2","typeLabel":"null"}],"uniqueKey":"chunking_strategy","typeLabel":"string | ServerVadChunkingStrategy · object | null"},"language":{"oneOf":[{"type":"string","title":"Language","description":"The language of the input audio. Supplying the input language in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`) format will improve accuracy and latency.","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","title":"Language","description":"The language of the input audio. Supplying the input language in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) (e.g. `en`) format will improve accuracy and latency.","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"stream":{"type":"boolean","title":"Stream","description":"Whether to stream the transcription result. When set to `true`, the transcription is sent as [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#event_stream_format) once generated.","default":false,"uniqueKey":"stream","typeLabel":"boolean"},"temperature":{"oneOf":[{"type":"number","title":"Temperature","description":"The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.","uniqueKey":"temperature.oneOf.0","typeLabel":"number"},{"type":"null","title":"Temperature","description":"The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.","uniqueKey":"temperature.oneOf.1","typeLabel":"null"}],"uniqueKey":"temperature","typeLabel":"number | null"}},"type":"object","required":["file"],"title":"ContainerAudioTranscriptionBody","example":{"file":"@/path/to/file/audio.mp3"},"uniqueKey":"","typeLabel":"ContainerAudioTranscriptionBody · object"},"examples":{"Example":{"title":"Example","value":{"file":"@/path/to/file/audio.mp3"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"2300f367-44ed-4fe3-a2bb-d6d43444d322":{"description":"Audio transcription, or an SSE stream when `stream` is true.","content":{"application/json":{"schema":{"properties":{"text":{"type":"string","title":"Text","description":"The transcribed text.","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"usage":{"properties":{"type":{"type":"string","const":"tokens","title":"Type","description":"The type of the usage object. Always `tokens` for this variant.","isRequired":true,"uniqueKey":"usage.type","typeLabel":"string"},"input_tokens":{"type":"integer","title":"Input Tokens","description":"Number of input tokens billed for this request.","isRequired":true,"uniqueKey":"usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","title":"Output Tokens","description":"Number of output tokens generated.","isRequired":true,"uniqueKey":"usage.output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total number of tokens used (input + output).","isRequired":true,"uniqueKey":"usage.total_tokens","typeLabel":"integer"},"input_audio_length_ms":{"type":"integer","title":"Input Audio Length Ms","description":"The length of the input audio in milliseconds.","isRequired":true,"uniqueKey":"usage.input_audio_length_ms","typeLabel":"integer"},"processed_audio_length_ms":{"type":"integer","title":"Processed Audio Length Ms","description":"The length of the processed audio in milliseconds.","isRequired":true,"uniqueKey":"usage.processed_audio_length_ms","typeLabel":"integer"},"input_token_details":{"oneOf":[{"type":"object","title":"AudioTranscriptionInputTokenDetails","description":"Details about the input tokens billed for this request.","required":["audio_tokens","text_tokens"],"properties":{"audio_tokens":{"type":"integer","title":"Audio Tokens","description":"Number of audio tokens billed for this request.","isRequired":true,"uniqueKey":"usage.input_token_details.oneOf.0.audio_tokens","typeLabel":"integer"},"text_tokens":{"type":"integer","title":"Text Tokens","description":"Number of text tokens billed for this request.","isRequired":true,"uniqueKey":"usage.input_token_details.oneOf.0.text_tokens","typeLabel":"integer"}},"uniqueKey":"usage.input_token_details.oneOf.0","typeLabel":"AudioTranscriptionInputTokenDetails · object"},{"type":"null","description":"Details about the input tokens billed for this request.","uniqueKey":"usage.input_token_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.input_token_details","typeLabel":"AudioTranscriptionInputTokenDetails · object | null"}},"type":"object","required":["type","input_tokens","output_tokens","total_tokens","input_audio_length_ms","processed_audio_length_ms"],"title":"AudioTranscriptionUsage","isRequired":true,"uniqueKey":"usage","typeLabel":"AudioTranscriptionUsage · object"}},"type":"object","required":["text","usage"],"title":"ContainerAudioTranscriptionSuccess","uniqueKey":"","typeLabel":"ContainerAudioTranscriptionSuccess · object"},"examples":{"Example":{"title":"Example","value":{"text":"Hello, how are you?","usage":{"type":"tokens","input_tokens":20,"output_tokens":10,"total_tokens":30,"input_audio_length_ms":18000,"processed_audio_length_ms":24000,"input_token_details":{"audio_tokens":10,"text_tokens":10}}}}},"exampleType":"examples"},"text/event-stream":{"schema":{"properties":{"data":{"properties":{"type":{"type":"string","enum":["transcript.text.delta","transcript.text.done"],"title":"Type","description":"The event type, which is `transcript.text.delta` or `transcript.text.done`.","isRequired":true,"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"delta":{"oneOf":[{"type":"string","title":"Delta","description":"The incremental transcript text.","uniqueKey":"data.delta.oneOf.0","typeLabel":"string"},{"type":"null","title":"Delta","description":"The incremental transcript text.","uniqueKey":"data.delta.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.delta","typeLabel":"string | null"},"text":{"oneOf":[{"type":"string","title":"Text","description":"The transcribed text.","uniqueKey":"data.text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Text","description":"The transcribed text.","uniqueKey":"data.text.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.text","typeLabel":"string | null"},"usage":{"oneOf":[{"type":"object","title":"AudioTranscriptionUsage","required":["type","input_tokens","output_tokens","total_tokens","input_audio_length_ms","processed_audio_length_ms"],"properties":{"type":{"type":"string","const":"tokens","title":"Type","description":"The type of the usage object. Always `tokens` for this variant.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.type","typeLabel":"string"},"input_tokens":{"type":"integer","title":"Input Tokens","description":"Number of input tokens billed for this request.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","title":"Output Tokens","description":"Number of output tokens generated.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.output_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","title":"Total Tokens","description":"Total number of tokens used (input + output).","isRequired":true,"uniqueKey":"data.usage.oneOf.0.total_tokens","typeLabel":"integer"},"input_audio_length_ms":{"type":"integer","title":"Input Audio Length Ms","description":"The length of the input audio in milliseconds.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.input_audio_length_ms","typeLabel":"integer"},"processed_audio_length_ms":{"type":"integer","title":"Processed Audio Length Ms","description":"The length of the processed audio in milliseconds.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.processed_audio_length_ms","typeLabel":"integer"},"input_token_details":{"oneOf":[{"type":"object","title":"AudioTranscriptionInputTokenDetails","description":"Details about the input tokens billed for this request.","required":["audio_tokens","text_tokens"],"properties":{"audio_tokens":{"type":"integer","title":"Audio Tokens","description":"Number of audio tokens billed for this request.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.input_token_details.oneOf.0.audio_tokens","typeLabel":"integer"},"text_tokens":{"type":"integer","title":"Text Tokens","description":"Number of text tokens billed for this request.","isRequired":true,"uniqueKey":"data.usage.oneOf.0.input_token_details.oneOf.0.text_tokens","typeLabel":"integer"}},"uniqueKey":"data.usage.oneOf.0.input_token_details.oneOf.0","typeLabel":"AudioTranscriptionInputTokenDetails · object"},{"type":"null","description":"Details about the input tokens billed for this request.","uniqueKey":"data.usage.oneOf.0.input_token_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.usage.oneOf.0.input_token_details","typeLabel":"AudioTranscriptionInputTokenDetails · object | null"}},"uniqueKey":"data.usage.oneOf.0","typeLabel":"AudioTranscriptionUsage · object"},{"type":"null","uniqueKey":"data.usage.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.usage","typeLabel":"AudioTranscriptionUsage · object | null"}},"type":"object","required":["type"],"title":"StreamedAudioTranscriptionData","isRequired":true,"uniqueKey":"data","typeLabel":"StreamedAudioTranscriptionData · object"}},"type":"object","required":["data"],"title":"StreamedAudioTranscriptionResult","uniqueKey":"","typeLabel":"StreamedAudioTranscriptionResult · object"},"examples":{"Example":{"title":"Example","value":"data: {\"type\":\"transcript.text.delta\",\"delta\":\"The\"}\n\ndata: {\"type\":\"transcript.text.delta\",\"delta\":\" quick\"}\n\n...\n\ndata: {\"type\":\"transcript.text.done\",\"text\":\"The quick brown fox jumps over the lazy dog.\",\"usage\":{\"type\":\"tokens\",\"input_tokens\":20,\"output_tokens\":10,\"total_tokens\":30,\"input_audio_length_ms\":18000,\"processed_audio_length_ms\":24000,\"input_token_details\":{\"audio_tokens\":10,\"text_tokens\":10}}}\n\ndata: [DONE]\n"}},"x-speakeasy-sse-sentinel":"[DONE]","exampleType":"examples"}},"exampleType":"examples"},"a21cad42-0943-4527-918c-58488a9b3c13":{"description":"Unprocessable Entity","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"ce930cca-ca05-4f60-b500-2ea7d0b970d0":{"url":"http://localhost:8000"}}},"originalFileLocation":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml"},"subdomain":"friendliai","siteName":"FriendliAI Docs","title":"Container Audio Transcriptions","contextualStarterQuestions":[{"_id":"69fd749368c9a4a0bb4ed0fd","deploymentId":"66d1620afd71f66abaace95b","questionText":"How do I transcribe audio files?","status":"active","generatedBy":"contextual","path":"openapi/container/audio-transcriptions","createdAt":"2026-05-08T05:28:51.227Z","updatedAt":"2026-05-08T05:28:51.227Z","__v":0},{"_id":"69fd749368c9a4a0bb4ed0fe","deploymentId":"66d1620afd71f66abaace95b","questionText":"What models support transcription?","status":"active","generatedBy":"contextual","path":"openapi/container/audio-transcriptions","createdAt":"2026-05-08T05:28:51.227Z","updatedAt":"2026-05-08T05:28:51.227Z","__v":0},{"_id":"69fd749368c9a4a0bb4ed0ff","deploymentId":"66d1620afd71f66abaace95b","questionText":"Can I run this on my GPU?","status":"active","generatedBy":"contextual","path":"openapi/container/audio-transcriptions","createdAt":"2026-05-08T05:28:51.227Z","updatedAt":"2026-05-08T05:28:51.227Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T03:11:20.576Z","gitLastModified":"2026-06-09T01:14:16.000Z","originalFileLocation":"openapi/container/audio-transcriptions.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=\"Transcribe an audio file into text.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_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=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Container Audio Transcriptions\">\u003cmeta data-mint-head property=\"og:description\" content=\"Transcribe an audio file into text.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://friendli.ai/docs/openapi/container/audio-transcriptions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Container+Audio+Transcriptions\u0026amp;description=Transcribe+an+audio+file+into+text.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=f5239d3536c326beca322c5aa841b15bea43f7e54863f5ab7a2c5ee9104f1b9c\">\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=\"Container Audio Transcriptions\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Transcribe an audio file into text.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Container+Audio+Transcriptions\u0026amp;description=Transcribe+an+audio+file+into+text.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=f5239d3536c326beca322c5aa841b15bea43f7e54863f5ab7a2c5ee9104f1b9c\">\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=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2A62DB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://friendli.ai/docs/openapi/container/audio-transcriptions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/openapi/container/audio-transcriptions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://friendli.ai/#organization\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://friendli.ai/docs#website\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai/docs\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions#webpage\",\"url\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions\",\"name\":\"Container Audio Transcriptions\",\"description\":\"Transcribe an audio file into text.\",\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Friendli Container\",\"item\":\"https://friendli.ai/docs/archive/container/guides/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://friendli.ai/docs/openapi/container/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Inference\",\"item\":\"https://friendli.ai/docs/openapi/container/chat-completions\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Container Audio Transcriptions\",\"item\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions#apireference\",\"headline\":\"Container Audio Transcriptions\",\"name\":\"Container Audio Transcriptions\",\"description\":\"Transcribe an audio file into text.\",\"url\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions\",\"mainEntityOfPage\":{\"@id\":\"https://friendli.ai/docs/openapi/container/audio-transcriptions#webpage\"},\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FriendliAI Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FriendliAI Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/openapi/container/audio-transcriptions.md","siteName":"FriendliAI Docs","nav":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"tabs":[{"tab":"Home","hidden":true,"searchable":true,"pages":[{"title":"Home","href":""}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction/overview"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/models/overview"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/openapi/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Archive","hidden":true,"searchable":true,"groups":[{"group":"Friendli Container","pages":[{"group":"Guides","icon":"book-open","expanded":true,"pages":[{"title":"Introducing Friendli Container","sidebarTitle":"Introduction","description":"Deploy generative AI models on your own infrastructure with Friendli Container. Full control over GPU resources, networking, and scaling.","href":"/archive/container/guides/introduction"},{"title":"QuickStart: Friendli Container Trial","sidebarTitle":"QuickStart","description":"Get started with Friendli Container trial. Access the registry, configure your secret, launch the container, and monitor with Grafana.","href":"/archive/container/guides/quickstart"},{"title":"Configuration","sidebarTitle":"Configuration","description":"Configuration reference for Friendli Container: how to pass launch options, serve across multiple GPUs, enable quantization, and run MoE models.","href":"/archive/container/guides/configuration"},{"title":"CUDA Compatibility","sidebarTitle":"CUDA Compatibility","description":"The Friendli Engine supports CUDA-enabled NVIDIA GPUs, which means it relies on a specific version of CUDA and necessitates proper CUDA compute compatibilities.","href":"/archive/container/guides/cuda-compatibility"},{"title":"Serving Multi-LoRA Models","sidebarTitle":"Multi-LoRA Serving","description":"Serve multiple LoRA-adapted LLMs simultaneously with Friendli Container without additional GPU resources. No retraining needed for task-specific models.","href":"/archive/container/guides/serving-multi-lora-models"},{"title":"Serving MoE Models","sidebarTitle":"MoE Models Serving","description":"Serve Mixture of Experts (MoE) models like Mixtral 8x7B with Friendli Container. Covers policy search setup and multi-GPU Docker configuration.","href":"/archive/container/guides/serving-moe-models"},{"title":"Quantization","sidebarTitle":"Quantization","description":"Learn how to serve pre-quantized models or perform online quantization with Friendli Container to reduce memory and speed up inference.","href":"/archive/container/guides/quantization"},{"title":"Optimize with Policy Search","sidebarTitle":"Optimize with Policy Search","description":"Boost inference throughput by up to 2x for MoE and quantized models by running execution policy search in Friendli Container for production.","href":"/archive/container/guides/optimizing-inference-with-policy-search"},{"title":"Running Friendli Container on SageMaker","sidebarTitle":"SageMaker Integration","description":"Create a real-time inference endpoint in Amazon SageMaker with Friendli Container. Use Friendli Engine for faster, cost-efficient serving.","href":"/archive/container/guides/sagemaker-integration"},{"title":"Deploy Friendli Container as Amazon EKS Add-On","sidebarTitle":"AWS EKS Add-On","description":"Deploy Friendli Container on Amazon EKS using the official AWS EKS Add-On. Set up GPU nodes, install the add-on, and run model inference.","href":"/archive/container/guides/eks-quickstart"},{"title":"Inference with gRPC","sidebarTitle":"Inference with gRPC","description":"Run a gRPC inference server with Friendli Container and send requests using the Friendli Python SDK. Includes setup, configuration, and code examples.","href":"/archive/container/guides/inference-with-grpc"},{"title":"Observability for Friendli Container","sidebarTitle":"Monitoring","description":"Observability is an integral part of DevOps. To support this, Friendli Container exports internal metrics in a Prometheus text format.","href":"/archive/container/guides/monitoring"}]},{"group":"API Reference","icon":"code","expanded":true,"pages":[{"title":"Container Overview","sidebarTitle":"Overview","description":"API reference for Friendli Container. Browse self-hosted inference endpoints for chat, responses, completions, messages, tokenization, images, and audio transcription.","href":"/openapi/container/overview"},{"group":"Inference","pages":[{"title":"Container Chat Completions","description":"Generate a model response from a list of messages comprising a conversation. Compatible with the OpenAI Chat Completions API, with support for streaming, tool calls, and structured outputs.","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/chat/completions","href":"/openapi/container/chat-completions"},{"title":"Container Responses","description":"Generate a model response from text or image inputs. Follows the OpenAI Responses API format, with support for streaming, function and custom tool calls, structured outputs, and reasoning controls.","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/responses","href":"/openapi/container/responses"},{"title":"Container Messages","description":"Generate a model response from a conversation using the Anthropic Messages API format. Supports streaming, function tool calls, and extended thinking.","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/messages","href":"/openapi/container/messages"},{"title":"Container Completions","description":"Generate a text completion from a prompt or token sequence. Supports streaming and configurable generation parameters.","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/completions","href":"/openapi/container/completions"},{"title":"Container Text Classification","description":"Classify text input into categories with per-class probabilities.","deprecated":null,"version":null,"sidebarTitle":"Text Classification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /classify","href":"/openapi/container/text-classification"},{"title":"Container Tokenization","description":"Convert text input into token IDs.","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/tokenize","href":"/openapi/container/tokenization"},{"title":"Container Detokenization","description":"Convert a list of token IDs back into text.","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/detokenize","href":"/openapi/container/detokenization"},{"title":"Container Image Generations","description":"Generate an image from a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Generations","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/generations","href":"/openapi/container/image-generations"},{"title":"Container Image Edits","description":"Edit an image based on a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Edits","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/edits","href":"/openapi/container/image-edits"},{"title":"Container Audio Transcriptions","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/audio/transcriptions","href":"/openapi/container/audio-transcriptions"}]}]}]},{"group":"Friendli Python SDK","pages":[{"title":"Friendli Python SDK","sidebarTitle":"How-To","icon":"file-lines","description":"Install and use the Friendli Python SDK to access Model APIs, Dedicated Endpoints, and Container. Covers chat, completions, streaming, and async usage.","href":"/archive/python-sdk/how-to"}]}]}]},"basePath":"","title":"Container Audio Transcriptions","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-CK-IGkvh.js","dist-PCbBHBTv.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-Y_UC780V.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","Page-DCFaZE46.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","AssistantPageLink-D4q_oRML.js"]}