Transcribe an audio file into text.To request successfully, it is mandatory to enter a Personal API Key (e.g. flp_XXX) value in the Bearer Token field.
Refer to the authentication section on our introduction page to learn how to acquire this variable and visit here to generate your API Key.
ID of target endpoint. If you want to send request to specific adapter, use the format "YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE". Otherwise, you can just use "YOUR_ENDPOINT_ID" alone.
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":"6aed53e7c5ca48f8240a4b05","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Guides","count":44},{"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":"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},{"name":"comment-mode","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/dedicated/inference/audio-transcriptions","slug":"/openapi/dedicated/inference/audio-transcriptions","pageMetadata":{"title":"Dedicated Audio Transcriptions","description":"Transcribe an audio file into text.","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","og:title":"Dedicated Audio Transcriptions","og:description":"Transcribe an audio file into text.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/audio/transcriptions","href":"/openapi/dedicated/inference/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{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Transcribe an audio file into text.`}),`\n`,_jsxs(_components.p,{children:[`To request successfully, it is mandatory to enter a `,_jsx(_components.strong,{children:`Personal API Key`}),` (e.g. flp_XXX) value in the `,_jsx(_components.strong,{children:`Bearer Token`}),` field.\nRefer to the `,_jsx(_components.a,{href:`/openapi/introduction#authentication`,children:`authentication section`}),` on our introduction page to learn how to acquire this variable and `,_jsx(_components.a,{href:`https://friendli.ai/suite/~/setting/keys`,children:`visit here`}),` to generate your API Key.`]})]})}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":"Dedicated Audio Transcriptions","description":"Transcribe an audio file into text.","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","og:title":"Dedicated Audio Transcriptions","og:description":"Transcribe an audio file into text.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/audio/transcriptions","href":"/openapi/dedicated/inference/audio-transcriptions","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/friendliai/13360a4393f88fc7/script.js"],"openApiReferenceData":{"operation":{"tags":["Dedicated.Audio"],"summary":"Audio transcriptions","description":"Transcribe an audio file into text.","operationId":"dedicatedAudioTranscriptions","security":["7f58f4b0-bf40-4d5a-a31c-27b9f6db7858"],"parameters":["56f60260-3e81-406a-9cc8-a83bdb31b17a"],"requestBody":"ded523d6-30e1-4a08-ac44-d071fa3ca451","responses":{"200":"0daabe52-070b-4d19-8e84-b153c405b075","422":"350c0555-2c42-4607-bce8-3ec6f05dc166"},"x-speakeasy-name-override":"transcribe","x-mint":{"metadata":{"title":"Dedicated Audio Transcriptions","sidebarTitle":"Audio Transcriptions","og:title":"Dedicated Audio Transcriptions","description":"Transcribe an audio file into text.","og:description":"Transcribe an audio file into text."},"href":"/openapi/dedicated/inference/audio-transcriptions","content":"Transcribe an audio file into text.\n\nTo request successfully, it is mandatory to enter a **Personal API Key** (e.g. flp_XXX) value in the **Bearer Token** field.\nRefer to the [authentication section](/openapi/introduction#authentication) on our introduction page to learn how to acquire this variable and [visit here](https://friendli.ai/suite/~/setting/keys) to generate your API Key."},"method":"post","type":"path","servers":["6573dcb9-f1c7-4004-bf30-f967cb86a2a1"],"path":"/dedicated/v1/audio/transcriptions","baseUrlOptions":["https://api.friendli.ai"],"title":"Audio transcriptions","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.model":"(endpoint-id)","body.file":"@/path/to/file/audio.mp3"}]},"dependencies":{"parameters":{"56f60260-3e81-406a-9cc8-a83bdb31b17a":{"name":"X-Friendli-Team","in":"header","required":false,"schema":{"description":"ID of team to run requests as (optional parameter).","title":"X-Friendli-Team","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"},"description":"ID of team to run requests as (optional parameter)."}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"properties":{"model":{"type":"string","title":"Model","description":"ID of target endpoint. If you want to send request to specific adapter, use the format \"YOUR_ENDPOINT_ID:YOUR_ADAPTER_ROUTE\". Otherwise, you can just use \"YOUR_ENDPOINT_ID\" alone.","examples":["(endpoint-id)"],"isRequired":true,"uniqueKey":"model","typeLabel":"string"},"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"},"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":["model","file"],"title":"DedicatedAudioTranscriptionBody","example":{"file":"@/path/to/file/audio.mp3","model":"(endpoint-id)"},"uniqueKey":"","typeLabel":"DedicatedAudioTranscriptionBody · object"},"examples":{"Example":{"title":"Example","value":{"file":"@/path/to/file/audio.mp3","model":"(endpoint-id)"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0daabe52-070b-4d19-8e84-b153c405b075":{"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":"DedicatedAudioTranscriptionSuccess","uniqueKey":"","typeLabel":"DedicatedAudioTranscriptionSuccess · 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"},"350c0555-2c42-4607-bce8-3ec6f05dc166":{"description":"Unprocessable Entity","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"7f58f4b0-bf40-4d5a-a31c-27b9f6db7858":{"token":{"type":"http","description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","scheme":"bearer","scopes":[],"schemeName":"token"}}},"servers":{"6573dcb9-f1c7-4004-bf30-f967cb86a2a1":{"url":"https://api.friendli.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","scheme":"bearer","scopes":[],"schemeName":"token"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"When using Friendli Suite API, you need to provide a **Personal API Key** (e.g. flp_XXX) as a Bearer token for authentication and authorization purposes.\n\nFor more detailed information, please refer [here](https://friendli.ai/docs/openapi/introduction#authentication).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"token","name":"Authorization"}],"title":"token"}]},"originalFileLocation":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml"},"subdomain":"friendliai","siteName":"FriendliAI Docs","title":"Dedicated Audio Transcriptions","contextualStarterQuestions":[{"_id":"69fd749768c9a4a0bb4ed26d","deploymentId":"66d1620afd71f66abaace95b","questionText":"Where do I get my API key?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/audio-transcriptions","createdAt":"2026-05-08T05:28:55.623Z","updatedAt":"2026-05-08T05:28:55.623Z","__v":0},{"_id":"69fd749768c9a4a0bb4ed26c","deploymentId":"66d1620afd71f66abaace95b","questionText":"How do I transcribe audio files?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/audio-transcriptions","createdAt":"2026-05-08T05:28:55.623Z","updatedAt":"2026-05-08T05:28:55.623Z","__v":0},{"_id":"69fd749768c9a4a0bb4ed26e","deploymentId":"66d1620afd71f66abaace95b","questionText":"What format should audio be in?","status":"active","generatedBy":"contextual","path":"openapi/dedicated/inference/audio-transcriptions","createdAt":"2026-05-08T05:28:55.623Z","updatedAt":"2026-05-08T05:28:55.623Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T03:11:20.309Z","gitLastModified":"2026-06-09T01:14:16.000Z","originalFileLocation":"openapi/dedicated/inference/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=\"Dedicated 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/dedicated/inference/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=Dedicated+Audio+Transcriptions\u0026amp;description=Transcribe+an+audio+file+into+text.\u0026amp;theme=8d0579d800ace9672a43ac47\u0026amp;signature=2bbfc8178d6f78d156e8139dc0ae8d21fb992e0136138e7a8d84c191d7b65817\">\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=\"Dedicated 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=Dedicated+Audio+Transcriptions\u0026amp;description=Transcribe+an+audio+file+into+text.\u0026amp;theme=8d0579d800ace9672a43ac47\u0026amp;signature=2bbfc8178d6f78d156e8139dc0ae8d21fb992e0136138e7a8d84c191d7b65817\">\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/dedicated/inference/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/dedicated/inference/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/dedicated/inference/audio-transcriptions#webpage\",\"url\":\"https://friendli.ai/docs/openapi/dedicated/inference/audio-transcriptions\",\"name\":\"Dedicated 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/dedicated/inference/audio-transcriptions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/audio-transcriptions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dedicated\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Inference\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/inference/chat-completions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Dedicated Audio Transcriptions\",\"item\":\"https://friendli.ai/docs/openapi/dedicated/inference/audio-transcriptions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/audio-transcriptions#apireference\",\"headline\":\"Dedicated Audio Transcriptions\",\"name\":\"Dedicated Audio Transcriptions\",\"description\":\"Transcribe an audio file into text.\",\"url\":\"https://friendli.ai/docs/openapi/dedicated/inference/audio-transcriptions\",\"mainEntityOfPage\":{\"@id\":\"https://friendli.ai/docs/openapi/dedicated/inference/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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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","groups":[{"group":"API Reference","pages":[{"title":"API Reference","sidebarTitle":"Introduction","href":"/openapi/introduction"}]},{"group":"Model APIs","pages":[{"title":"Model APIs Overview","sidebarTitle":"Overview","href":"/openapi/model-apis/overview"},{"group":"Inference","pages":[{"title":"Model APIs Chat Completions","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/chat/completions","href":"/openapi/model-apis/chat-completions"},{"title":"Model APIs Responses","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/responses","href":"/openapi/model-apis/responses"},{"title":"Model APIs Messages","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/messages","href":"/openapi/model-apis/messages"},{"title":"Model APIs Chat Render","deprecated":null,"version":null,"sidebarTitle":"Chat Render","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/chat/render","href":"/openapi/model-apis/chat-render"},{"title":"Model APIs Completions","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/completions","href":"/openapi/model-apis/completions"},{"title":"Model APIs Tokenization","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/tokenize","href":"/openapi/model-apis/tokenization"},{"title":"Model APIs Detokenization","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/detokenize","href":"/openapi/model-apis/detokenization"},{"title":"Model APIs Audio Transcriptions","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /serverless/v1/audio/transcriptions","href":"/openapi/model-apis/audio-transcriptions"}]}]},{"group":"Dedicated","pages":[{"title":"Dedicated Overview","sidebarTitle":"Overview","href":"/openapi/dedicated/overview"},{"group":"Inference","pages":[{"title":"Dedicated Chat Completions","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/chat/completions","href":"/openapi/dedicated/inference/chat-completions"},{"title":"Dedicated Responses","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/responses","href":"/openapi/dedicated/inference/responses"},{"title":"Dedicated Messages","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/messages","href":"/openapi/dedicated/inference/messages"},{"title":"Dedicated Chat Render","deprecated":null,"version":null,"sidebarTitle":"Chat Render","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/chat/render","href":"/openapi/dedicated/inference/chat-render"},{"title":"Dedicated Completions","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/completions","href":"/openapi/dedicated/inference/completions"},{"title":"Dedicated Embeddings","deprecated":null,"version":null,"sidebarTitle":"Embeddings","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/embeddings","href":"/openapi/dedicated/inference/embeddings"},{"title":"Dedicated Text Classification","deprecated":null,"version":null,"sidebarTitle":"Text Classification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/classify","href":"/openapi/dedicated/inference/text-classification"},{"title":"Dedicated Tokenization","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/tokenize","href":"/openapi/dedicated/inference/tokenization"},{"title":"Dedicated Detokenization","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/detokenize","href":"/openapi/dedicated/inference/detokenization"},{"title":"Dedicated Image Generations","deprecated":null,"version":null,"sidebarTitle":"Image Generations","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/images/generations","href":"/openapi/dedicated/inference/image-generations"},{"title":"Dedicated 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 /dedicated/v1/images/edits","href":"/openapi/dedicated/inference/image-edits"},{"title":"Dedicated Audio Transcriptions","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/v1/audio/transcriptions","href":"/openapi/dedicated/inference/audio-transcriptions"}]},{"group":"Endpoint","tag":"Beta","pages":[{"title":"Dedicated List Endpoints","description":"List all Friendli Dedicated Endpoint deployments in your project. Returns endpoint IDs, statuses, model names, and GPU configurations.","deprecated":null,"version":null,"sidebarTitle":"List Endpoints","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint","href":"/openapi/dedicated/endpoint/list"},{"title":"Dedicated Get Endpoint","deprecated":null,"version":null,"sidebarTitle":"Retrieve an Endpoint Specification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/get-spec"},{"title":"Dedicated Get Endpoint Version","deprecated":null,"version":null,"sidebarTitle":"Retrieve Endpoint Version History","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}/version","href":"/openapi/dedicated/endpoint/get-version"},{"title":"Dedicated Get Endpoint Status","deprecated":null,"version":null,"sidebarTitle":"Retrieve an Endpoint Status","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /dedicated/beta/endpoint/{endpoint_id}/status","href":"/openapi/dedicated/endpoint/get-status"},{"title":"Dedicated Create Endpoint","deprecated":null,"version":null,"sidebarTitle":"Create an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /dedicated/beta/endpoint","href":"/openapi/dedicated/endpoint/create"},{"title":"Dedicated Update Endpoint","deprecated":null,"version":null,"sidebarTitle":"Update an Endpoint with New Configuration","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/update"},{"title":"Dedicated Terminate Endpoint","deprecated":null,"version":null,"sidebarTitle":"Terminate an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/terminate","href":"/openapi/dedicated/endpoint/terminate"},{"title":"Dedicated Restart Endpoint","deprecated":null,"version":null,"sidebarTitle":"Restart an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/restart","href":"/openapi/dedicated/endpoint/restart"},{"title":"Dedicated Sleep Endpoint","deprecated":null,"version":null,"sidebarTitle":"Sleep an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/sleep","href":"/openapi/dedicated/endpoint/sleep"},{"title":"Dedicated Wake Endpoint","deprecated":null,"version":null,"sidebarTitle":"Wake Up an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml put /dedicated/beta/endpoint/{endpoint_id}/wake","href":"/openapi/dedicated/endpoint/wake"},{"title":"Dedicated Delete Endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete an Endpoint","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml delete /dedicated/beta/endpoint/{endpoint_id}","href":"/openapi/dedicated/endpoint/delete"}]}]},{"group":"Administration","tag":"Beta","pages":[{"title":"Cost","deprecated":null,"version":null,"sidebarTitle":"Cost","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /v1/team/cost","href":"/openapi/administration/cost"},{"title":"Usage","deprecated":null,"version":null,"sidebarTitle":"Usage","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml get /v1/team/usage","href":"/openapi/administration/usage"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Archive","hidden":true,"searchable":true,"pages":[{"title":"Archive","href":"/archive/container/guides/introduction"}]}]},"basePath":"","title":"Dedicated Audio Transcriptions","buildId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","deploymentId":"dpl_BSPUBxEoKhhK7HzXVDPxdPvWx4xc","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown--rjwFo9x.js","dist-qmLwQyWY.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-apD-Q0Oo.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-Do6EtGSl.js","utils-id4tQ6My.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-Byrixac4.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-nakYa3Zl.js","snippetPresets-Bq-pUS7h.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CujTC_9K.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-FneVUsVu.js","shallow-DY9WpUCz.js","getApiPlaygroundDisplay-Bz8WpPfA.js","CodeSnippet-DgCuJg4G.js","CodeSnippets-Dub9c4T0.js","Page-CePXnjd1.js","getPastedJson-xdI8y2XB.js","icon--yVw5vkr.js","MethodPill-C47t7MdS.js","DuplicateIcon-BzwJ2LeC.js","createIcon-BzggGy84.js","DynamicMarkdown-AlxJK8VR.js","SectionHeading-CMlwFxdK.js","axios-vUo_bRtp.js","Markdown-BNgNrPsi.js","AssistantPageLink-Dc4qTkWx.js"]}