Languages

VoiceBase supports several spoken languages and dialects.

Languages supported in the V3 API:

Language Code Supported Frequencies (kHz)
Dutch nl-NL 8, 11
English US en-US 8, 16
English UK en-UK 8, 16
English Australian en-AU 8, 16
French fr-FR 8, 11
German de-DE 8, 16
Italian it-IT 8, 16
Portuguese, Brazil pt-BR 8
Spanish, Latin Am. es-LA 8, 16
Spanish, Spain es-ES 8, 11

Feature Support by Language:

Note: en-UK and en-AU use the en-US functions for Keywords, Topics, Number Formatting and PCI.

Configuring Language Support

Use the language configuration parameter to set the language. Omitting the parameter defaults the language to U.S. English (en-US).

For example, to transcribe a recording in Australian English:

{
  "speechModel" : {
    "language" : "en-US"
  }
}
  • language : The language code. Refer to the table above.

Disabling Semantic Keywords and Topics

Semantic keywords and topics are not currently supported with Spanish and Portuguese. When transcribing in these languages, don’t enable these options in your configuration.

{
  "knowledge": {
    "enableDiscovery" : false
}

Examples

** Note: Export your api TOKEN prior to running any of the following examples.

export TOKEN='Your Api Token'

U.S. English

curl https://apis.voicebase.com/v3/media \
    --form media=@recording.mp3 \
    --form configuration='{
      "speechModel" : {
        "language" : "en-US"
      }
    }' \
    --header "Authorization: Bearer ${TOKEN}"

U.S. English for Voicemail

curl https://apis.voicebase.com/v3/media \
    --form media=@recording.mp3 \
    --form configuration='{
      "speechModel" : {
        "language" : "en-US"
        "extensions" : [ "voicemail" ]
      }
    }' \
    --header "Authorization: Bearer ${TOKEN}"

U.K. English

curl https://apis.voicebase.com/v3/media \
    --form media=@recording.mp3 \
    --form configuration='{
     "speechModel" : {
        "language" : "en-UK"
      }
    }' \
    --header "Authorization: Bearer ${TOKEN}"

Australian English

curl https://apis.voicebase.com/v3/media \
    --form media=@recording.mp3 \
    --form configuration='{
       "speechModel" : {
          "language" : "en-AU"
        }
     }' \
    --header "Authorization: Bearer ${TOKEN}"

Latin American Spanish

curl https://apis.voicebase.com/v3/media  \
    --form media=@recording.mp3 \
    --form configuration='{
      "speechModel" : {
        "language" : "es-LA"
      }
    }' \
    --header "Authorization: Bearer ${TOKEN}"

Brazilian Portuguese

curl https://apis.voicebase.com/v3/media  \
    --form media=@recording.mp3 \
    --form configuration='{
      "speechModel" : {
        "language" : "pt-BR"
      }
    }' \
    --header "Authorization: Bearer ${TOKEN}"