Boosting accuracy for keywords or phrases

    This is a beta feature. If you run into any issues please email support@assemblyai.com, or use the chat window in the bottom right of the page.

    Here is an example cURL request showing how to boost accuracy for a list of keywords/phrases when transcribing an audio file.

    curl --request POST \
      --url https://api.assemblyai.com/v2/transcript \
      --header 'authorization: YOUR-API-TOKEN' \
      --header 'content-type: application/json' \
      --data '
        {
            "audio_url": "https://app.assemblyai.com/static/media/phone_demo_clip_1.wav",
            "word_boost": ["sally mcmanus", "jolimbo's deli", "the IQEZ iPhone app"]
        }'
    Word boosts work best when the output of the API is close to your expected transcription, for example "Joe Limo Deli" versus "Jolimbo's Deli".

    You can also include the optional boost_param parameter in your API call to control how much weight should be applied to your keywords/phrases. This value can be either "low", "default", or "high". For example:

    curl --request POST \
      --url https://api.assemblyai.com/v2/transcript \
      --header 'authorization: YOUR-API-TOKEN' \
      --header 'content-type: application/json' \
      --data '
        {
            "audio_url": "https://app.assemblyai.com/static/media/phone_demo_clip_1.wav",
            "word_boost": ["sally mcmanus", "jolimbo's deli", "the IQEZ iPhone app"],
            "boost_param": "high"
        }'

    Limitations

    You can pass a maximum of 1,000 unique keywords/phrases in your word_boost list. Each keyword/phrase in the list must be 6 words or less. Transcribing with this feature may slow transcription processing speed down by 10-15%.