Speech to Text Launch Job

post

https://api.edenai.run/v2/audio/speech_to_text_async/

Available Providers

Provider	Model	Version	Price	Billing unit
amazon	-	`boto3 (v1.15.18)`	0.024 (per 60 seconde)	15 seconde
google	-	`v1p1beta1`	0.024 (per 60 seconde)	1 seconde
microsoft	-	`v1.0`	0.0168 (per 60 seconde)	1 seconde
assembly	-	`v2`	0.011 (per 60 seconde)	1 seconde
deepgram	nova-3	`v1`	0.0052 (per 60 seconde)	1 seconde
deepgram	enhanced	`v1`	0.0189 (per 60 seconde)	1 seconde
deepgram	-	`v1`	0.0189 (per 60 seconde)	1 seconde
deepgram	base	`v1`	0.0169 (per 60 seconde)	1 seconde
openai	-	`boto3 (v1.15.18)`	0.006 (per 60 seconde)	1 seconde
gladia	-	`v1`	0.0102 (per 60 seconde)	1 seconde

Supported Languages

Name	Value
Afrikaans	`af`
Albanian	`sq`
Amharic	`am`
Arabic	`ar`
Armenian	`hy`
Azerbaijani	`az`
Bashkir	`ba`
Basque	`eu`
Belarusian	`be`
Bengali	`bn`
Bosnian	`bs`
Breton	`br`
Bulgarian	`bg`
Burmese	`my`
Catalan	`ca`
Chinese	`zh`
Croatian	`hr`
Czech	`cs`
Danish	`da`
Dutch	`nl`
English	`en`
Esperanto	`eo`
Estonian	`et`
Filipino	`fil`
Finnish	`fi`
French	`fr`
Galician	`gl`
Georgian	`ka`
German	`de`
Gujarati	`gu`
Haitian	`ht`
Hausa	`ha`
Hebrew	`he`
Hebrew	`iw`
Hindi	`hi`
Hungarian	`hu`
Icelandic	`is`
Indonesian	`id`
Interlingua (International Auxiliary Language Association)	`ia`
Irish	`ga`
Italian	`it`
Japanese	`ja`
Javanese	`jv`
Kannada	`kn`
Kazakh	`kk`
Khmer	`km`
Korean	`ko`
Lao	`lo`
Latvian	`lv`
Lingala	`ln`
Lithuanian	`lt`
Luxembourgish	`lb`
Macedonian	`mk`
Malagasy	`mg`
Malay (macrolanguage)	`ms`
Malayalam	`ml`
Maltese	`mt`
Mandarin Chinese	`cmn`
Maori	`mi`
Marathi	`mr`
Modern Greek (1453-)	`el`
Mongolian	`mn`
Nepali (macrolanguage)	`ne`
Norwegian	`no`
Norwegian Bokmål	`nb`
Occitan (post 1500)	`oc`
Panjabi	`pa`
Persian	`fa`
Polish	`pl`
Portuguese	`pt`
Pushto	`ps`
Romanian	`mo`
Romanian	`ro`
Russian	`ru`
Serbian	`sr`
Sindhi	`sd`
Sinhala	`si`
Slovak	`sk`
Slovenian	`sl`
Somali	`so`
Spanish	`es`
Sundanese	`su`
Swahili (macrolanguage)	`sw`
Swedish	`sv`
Tagalog	`tl`
Tamil	`ta`
Telugu	`te`
Thai	`th`
Turkish	`tr`
Uighur	`ug`
Ukrainian	`uk`
Urdu	`ur`
Uzbek	`uz`
Vietnamese	`vi`
Welsh	`cy`
Wu Chinese	`wuu`
Yiddish	`yi`
Yoruba	`yo`
Yue Chinese	`yue`
Zulu	`zu`
at	`at`
jp	`jp`
mymr	`mymr`

Supported Detailed Languages

Name	Value
Auto detection	`auto-detect`
Afrikaans (South Africa)	`af-ZA`
Albanian (Albania)	`sq-AL`
Amharic (Ethiopia)	`am-ET`
Arabic (Algeria)	`ar-DZ`
Arabic (Bahrain)	`ar-BH`
Arabic (Egypt)	`ar-EG`
Arabic (Iraq)	`ar-IQ`
Arabic (Israel)	`ar-IL`
Arabic (Jordan)	`ar-JO`
Arabic (Kuwait)	`ar-KW`
Arabic (Lebanon)	`ar-LB`
Arabic (Libya)	`ar-LY`
Arabic (Mauritania)	`ar-MR`
Arabic (Morocco)	`ar-MA`
Arabic (Oman)	`ar-OM`
Arabic (Palestinian Territories)	`ar-PS`
Arabic (Qatar)	`ar-QA`
Arabic (Saudi Arabia)	`ar-SA`
Arabic (Syria)	`ar-SY`
Arabic (Tunisia)	`ar-TN`
Arabic (United Arab Emirates)	`ar-AE`
Arabic (Yemen)	`ar-YE`
Armenian (Armenia)	`hy-AM`
Azerbaijani (Azerbaijan)	`az-AZ`
Bangla (Bangladesh)	`bn-BD`
Bangla (India)	`bn-IN`
Basque (Spain)	`eu-ES`
Bosnian (Bosnia & Herzegovina)	`bs-BA`
Bulgarian (Bulgaria)	`bg-BG`
Burmese (Myanmar (Burma))	`my-MM`
Cantonese (China)	`yue-CN`
Cantonese (Traditional, Hong Kong SAR China)	`yue-Hant-HK`
Catalan (Spain)	`ca-ES`
Chinese (China)	`zh-CN`
Chinese (Hong Kong SAR China)	`zh-HK`
Chinese (Taiwan)	`zh-TW`
Croatian (Croatia)	`hr-HR`
Czech (Czechia)	`cs-CZ`
Danish (Denmark)	`da-DK`
Dutch (Belgium)	`nl-BE`
Dutch (Netherlands)	`nl-NL`
English (Australia)	`en-AU`
English (Canada)	`en-CA`
English (Ghana)	`en-GH`
English (Hong Kong SAR China)	`en-HK`
English (India)	`en-IN`
English (Ireland)	`en-IE`
English (Kenya)	`en-KE`
English (New Zealand)	`en-NZ`
English (Nigeria)	`en-NG`
English (Pakistan)	`en-PK`
English (Philippines)	`en-PH`
English (Singapore)	`en-SG`
English (South Africa)	`en-ZA`
English (Tanzania)	`en-TZ`
English (United Kingdom)	`en-GB`
English (United Kingdom)	`en-UK`
English (United States)	`en-US`
Estonian (Estonia)	`et-EE`
Filipino (Philippines)	`fil-PH`
Finnish (Finland)	`fi-FI`
French (Belgium)	`fr-BE`
French (Canada)	`fr-CA`
French (France)	`fr-FR`
French (Switzerland)	`fr-CH`
Galician (Spain)	`gl-ES`
Georgian (Georgia)	`ka-GE`
German (Austria)	`de-AT`
German (Germany)	`de-DE`
German (Switzerland)	`de-CH`
Greek (Greece)	`el-GR`
Gujarati (India)	`gu-IN`
Hebrew (Israel)	`he-IL`
Hebrew (Israel)	`iw-IL`
Hindi (India)	`hi-IN`
Hindi (Latin)	`hi-Latn`
Hungarian (Hungary)	`hu-HU`
Icelandic (Iceland)	`is-IS`
Indonesian (Indonesia)	`id-ID`
Irish (Ireland)	`ga-IE`
Italian (Italy)	`it-IT`
Italian (Switzerland)	`it-CH`
Japanese (Japan)	`ja-JP`
Javanese (Indonesia)	`jv-ID`
Kannada (India)	`kn-IN`
Kazakh (Kazakhstan)	`kk-KZ`
Khmer (Cambodia)	`km-KH`
Korean (South Korea)	`ko-KR`
Lao (Laos)	`lo-LA`
Latvian (Latvia)	`lv-LV`
Lithuanian (Lithuania)	`lt-LT`
Macedonian (North Macedonia)	`mk-MK`
Malay (Malaysia)	`ms-MY`
Malayalam (India)	`ml-IN`
Maltese (Malta)	`mt-MT`
Marathi (India)	`mr-IN`
Mongolian (Mongolia)	`mn-MN`
Nepali (Nepal)	`ne-NP`
Norwegian (Norway)	`no-NO`
Norwegian Bokmål (Norway)	`nb-NO`
Pashto (Afghanistan)	`ps-AF`
Persian (Iran)	`fa-IR`
Polish (Poland)	`pl-PL`
Portuguese (Brazil)	`pt-BR`
Portuguese (Portugal)	`pt-PT`
Punjabi (India)	`pa-Guru-IN`
Romanian (Romania)	`ro-RO`
Russian (Russia)	`ru-RU`
Serbian (Serbia)	`sr-RS`
Sinhala (Sri Lanka)	`si-LK`
Slovak (Slovakia)	`sk-SK`
Slovenian (Slovenia)	`sl-SI`
Somali (Somalia)	`so-SO`
Spanish (Argentina)	`es-AR`
Spanish (Bolivia)	`es-BO`
Spanish (Chile)	`es-CL`
Spanish (Colombia)	`es-CO`
Spanish (Costa Rica)	`es-CR`
Spanish (Cuba)	`es-CU`
Spanish (Dominican Republic)	`es-DO`
Spanish (Ecuador)	`es-EC`
Spanish (El Salvador)	`es-SV`
Spanish (Equatorial Guinea)	`es-GQ`
Spanish (Guatemala)	`es-GT`
Spanish (Honduras)	`es-HN`
Spanish (Latin America)	`es-419`
Spanish (Mexico)	`es-MX`
Spanish (Nicaragua)	`es-NI`
Spanish (Panama)	`es-PA`
Spanish (Paraguay)	`es-PY`
Spanish (Peru)	`es-PE`
Spanish (Puerto Rico)	`es-PR`
Spanish (Spain)	`es-ES`
Spanish (United States)	`es-US`
Spanish (Uruguay)	`es-UY`
Spanish (Venezuela)	`es-VE`
Sundanese (Indonesia)	`su-ID`
Swahili (Kenya)	`sw-KE`
Swahili (Tanzania)	`sw-TZ`
Swedish (Sweden)	`sv-SE`
Tamil (India)	`ta-IN`
Tamil (Malaysia)	`ta-MY`
Tamil (Singapore)	`ta-SG`
Tamil (Sri Lanka)	`ta-LK`
Telugu (India)	`te-IN`
Thai (Thailand)	`th-TH`
Turkish (Türkiye)	`tr-TR`
Ukrainian (Ukraine)	`uk-UA`
Urdu (India)	`ur-IN`
Urdu (Pakistan)	`ur-PK`
Uzbek (Uzbekistan)	`uz-UZ`
Vietnamese (Vietnam)	`vi-VN`
Welsh (United Kingdom)	`cy-GB`
Wu Chinese (China)	`wuu-CN`
Zulu (South Africa)	`zu-ZA`

Supported Models

Default Models

Name	Value
deepgram	`enhanced`

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

settings

string

Defaults to [object Object]

A dictionnary or a json object to specify specific models to use for some providers.
It can be in the following format: {"google" : "google_model", "ibm": "ibm_model"...}.

providers

array of strings

required

It can be one (ex: 'amazon' or 'google') or multiple provider(s) (ex: 'amazon,microsoft,google') that the data will be redirected to in order to get the processed results.
Providers can also be invoked with specific models (ex: providers: 'amazon/model1, amazon/model2, google/model3')

providers*

fallback_providers

array of strings

length ≤ 5

Defaults to

Providers in this list will be used as fallback if the call to provider in providers parameter fails. To use this feature, you must input only one provider in the providers parameter. but you can put up to 5 fallbacks.

They will be tried in the same order they are input, and it will stop to the first provider who doesn't fail.

Doesn't work with async subfeatures.

fallback_providers

show_original_response

boolean

Defaults to false

Optional : Shows the original response of the provider.
When set to true, a new attribute original_response will appear in the response object.

webhook_receiver

uri

length ≥ 1

Webhook receiver should be a valid https URL (ex : https://your.listner.com/endpoint). After the processing is done, the webhook endpoint will receive a POST request with the result.

users_webhook_parameters

string

Json data that contains of additional parameters that will be sent back to the webhook receiver (ex: api key for security or client's data ID to link the result internally). Will only be used when webhook_receiver is set.

send_webhook_data

boolean

Defaults to true

If set to false the webhook will not contain the result data. Use if your webhook receiver has a request size limit.

show_base_64

boolean

Defaults to true

provider_params

string

Parameters specific to the provider that you want to send along the request.

it should take a provider name as key and an object of parameters as value.

Example:

{
  "deepgram": {
    "filler_words": true,
    "smart_format": true,
    "callback": "https://webhook.site/0000"
  },
  "assembly": {
    "webhook_url": "https://webhook.site/0000"
  }
}

Please refer to the documentation of each provider to see which parameters to send.

file

File to analyse in binary format to be used with content-type: multipart/form-data
Does not work with application/json !

file_url

uri | null

File URL to analyse to be used with with content-type: application/json.

language

string | null

Language code expected (ex: en, fr)

speakers

integer | null

Defaults to 2

Number of speakers in the file audio

profanity_filter

boolean | null

Defaults to false

Boolean value to specify weather or not the service will filter profanity and replace inappropriate words with a series of asterisks

custom_vocabulary

string

List of words or composed words to be detected by the speech to text engine. (Ex: Word, Mike, Draw, Los Angeles,...)

convert_to_wav

boolean | null

Defaults to false

Boolean value to specify weather to convert the audio/video file to wav format to be accepted by a majority of the providers

Response

200