2022-11-15 01:03:58 +01:00
<!DOCTYPE html>
< html class = "" >
< head >
< meta charset = "utf-8" >
< title > Voice message transcription< / title >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< meta property = "description" content = " How to transcribe voice messages." >
< meta property = "og:title" content = "Voice message transcription" >
< meta property = "og:image" content = "" >
< meta property = "og:description" content = " How to transcribe voice messages." >
< link rel = "icon" type = "image/svg+xml" href = "/img/website_icon.svg?4" >
< link rel = "apple-touch-icon" sizes = "180x180" href = "/img/apple-touch-icon.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/img/favicon-32x32.png" >
< link rel = "icon" type = "image/png" sizes = "16x16" href = "/img/favicon-16x16.png" >
< link rel = "alternate icon" href = "/img/favicon.ico" type = "image/x-icon" / >
< link href = "/css/bootstrap.min.css?3" rel = "stylesheet" >
2023-03-20 12:08:32 +01:00
< link href = "/css/telegram.css?236" rel = "stylesheet" media = "screen" >
2022-11-15 01:03:58 +01:00
< style >
< / style >
< / head >
< body class = "preload" >
< div class = "dev_page_wrap" >
< div class = "dev_page_head navbar navbar-static-top navbar-tg" >
< div class = "navbar-inner" >
< div class = "container clearfix" >
< ul class = "nav navbar-nav navbar-right hidden-xs" > < li class = "navbar-twitter" > < a href = "https://twitter.com/telegram" target = "_blank" data-track = "Follow/Twitter" onclick = "trackDlClick(this, event)" > < i class = "icon icon-twitter" > < / i > < span > Twitter< / span > < / a > < / li > < / ul >
< ul class = "nav navbar-nav" >
< li > < a href = "//telegram.org/" > Home< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/apps" > Apps< / a > < / li >
< li class = "active" > < a href = "/api" > API< / a > < / li >
< li class = "" > < a href = "/mtproto" > Protocol< / a > < / li >
< li class = "" > < a href = "/schema" > Schema< / a > < / li >
< / ul >
< / div >
< / div >
< / div >
< div class = "container clearfix" >
< div class = "dev_page" >
< div id = "dev_page_content_wrap" class = " " >
< div class = "dev_page_bread_crumbs" > < ul class = "breadcrumb clearfix" > < li > < a href = "/api" > API< / a > < / li > < i class = "icon icon-breadcrumb-divider" > < / i > < li > < a href = "/api/transcribe" > Voice message transcription< / a > < / li > < / ul > < / div >
< h1 id = "dev_page_title" > Voice message transcription< / h1 >
< div id = "dev_page_content" > <!-- scroll_nav -->
< p > The API provides methods to transcribe voice messages. < / p >
< p > Schema: < / p >
< pre > < code > < a href = '/constructor/updateTranscribedAudio' > updateTranscribedAudio< / a > #84cd5a flags:< a href = '/type/%23' > #< / a > pending:flags.0?< a href = '/constructor/true' > true< / a > peer:< a href = '/type/Peer' > Peer< / a > msg_id:< a href = '/type/int' > int< / a > transcription_id:< a href = '/type/long' > long< / a > text:< a href = '/type/string' > string< / a > = < a href = '/type/Update' > Update< / a > ;
2024-02-10 15:36:22 +01:00
< a href = '/constructor/messages.transcribedAudio' > messages.transcribedAudio< / a > #cfb9d957 flags:< a href = '/type/%23' > #< / a > pending:flags.0?< a href = '/constructor/true' > true< / a > transcription_id:< a href = '/type/long' > long< / a > text:< a href = '/type/string' > string< / a > trial_remains_num:flags.1?< a href = '/type/int' > int< / a > trial_remains_until_date:flags.1?< a href = '/type/int' > int< / a > = < a href = '/type/messages.TranscribedAudio' > messages.TranscribedAudio< / a > ;
2022-11-15 01:03:58 +01:00
---functions---
< a href = '/method/messages.transcribeAudio' > messages.transcribeAudio< / a > #269e9a49 peer:< a href = '/type/InputPeer' > InputPeer< / a > msg_id:< a href = '/type/int' > int< / a > = < a href = '/type/messages.TranscribedAudio' > messages.TranscribedAudio< / a > ;
< a href = '/method/messages.rateTranscribedAudio' > messages.rateTranscribedAudio< / a > #7f1d072f peer:< a href = '/type/InputPeer' > InputPeer< / a > msg_id:< a href = '/type/int' > int< / a > transcription_id:< a href = '/type/long' > long< / a > good:< a href = '/type/Bool' > Bool< / a > = < a href = '/type/Bool' > Bool< / a > ;< / code > < / pre >
< p > Use < a href = "/method/messages.transcribeAudio" > messages.transcribeAudio< / a > to initiate transcription of a message.< br >
The returned < a href = "/constructor/messages.transcribedAudio" > messages.transcribedAudio< / a > constructor will have the < code > pending< / code > flag set if the transcription is still in progress and the transcribed text contained in < code > text< / code > will be updated in future with < a href = "/constructor/updateTranscribedAudio" > updateTranscribedAudio< / a > updates.< br >
These updates will contain the updated < code > text< / code > with the same < code > transcription_id< / code > returned in the first < a href = "/constructor/messages.transcribedAudio" > messages.transcribedAudio< / a > , and the < code > pending< / code > flag will be set if the transcription is still in progress. < / p >
2024-02-10 15:36:22 +01:00
< p > A transcription can then be rated as good or bad using < a href = "/method/messages.rateTranscribedAudio" > messages.rateTranscribedAudio< / a > . < / p >
< p > Users without a < a href = "/api/premium" > Telegram Premium< / a > subscription can only transcribe < a href = "/api/config#transcribe-audio-trial-weekly-number" > transcribe_audio_trial_weekly_number< / a > messages per week, each of maximum duration equal to < a href = "/api/config#transcribe-audio-trial-duration-max" > transcribe_audio_trial_duration_max< / a > seconds.< br >
For non-premium users, the < code > trial_remains_num< / code > and < code > trial_remains_until_date< / code > flags of < a href = "/constructor/messages.transcribedAudio" > messages.transcribedAudio< / a > will also be set, indicating the remaining transcriptions, and the date when the < code > trial_remains_num< / code > counter will be reset to the maximum value of < a href = "/api/config#transcribe-audio-trial-weekly-number" > transcribe_audio_trial_weekly_number< / a > .< / p > < / div >
2022-11-15 01:03:58 +01:00
< / div >
< / div >
< / div >
< div class = "footer_wrap" >
< div class = "footer_columns_wrap footer_desktop" >
< div class = "footer_column footer_column_telegram" >
< h5 > Telegram< / h5 >
< div class = "footer_telegram_description" > < / div >
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
< li > < a href = "//telegram.org/privacy" > Privacy< / a > < / li >
< li > < a href = "//telegram.org/press" > Press< / a > < / li >
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#mobile-apps" > Mobile Apps< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/dl/ios" > iPhone/iPad< / a > < / li >
< li > < a href = "//telegram.org/android" > Android< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Mobile Web< / a > < / li >
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#desktop-apps" > Desktop Apps< / a > < / h5 >
< ul >
< li > < a href = "//desktop.telegram.org/" > PC/Mac/Linux< / a > < / li >
< li > < a href = "//macos.telegram.org/" > macOS< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Web-browser< / a > < / li >
< / ul >
< / div >
< div class = "footer_column footer_column_platform" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< ul >
< li > < a href = "/api" > API< / a > < / li >
< li > < a href = "//translations.telegram.org/" > Translations< / a > < / li >
< li > < a href = "//instantview.telegram.org/" > Instant View< / a > < / li >
< / ul >
< / div >
< / div >
< div class = "footer_columns_wrap footer_mobile" >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/blog" > Blog< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps" > Apps< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< / div >
< div class = "footer_column" >
2024-02-15 09:45:05 +01:00
< h5 > < a href = "//telegram.org/press" > Press< / a > < / h5 >
2022-11-15 01:03:58 +01:00
< / div >
< / div >
< / div >
< / div >
2022-12-10 23:50:15 +01:00
< script src = "/js/main.js?47" > < / script >
2022-11-15 01:03:58 +01:00
< script src = "/js/jquery.min.js?1" > < / script >
< script src = "/js/bootstrap.min.js?1" > < / script >
< script > w i n d o w . i n i t D e v P a g e N a v & & i n i t D e v P a g e N a v ( ) ;
backToTopInit("Go up");
removePreloadInit();
< / script >
< / body >
< / html >