{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Best Practices for the Rev AI APIs","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"best-practices-for-the-rev-ai-apis","__idx":0},"children":["Best Practices for the Rev AI APIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["By Chance Shiflett, Solutions Engineering Manager - Feb 11, 2022"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":1},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial recommends best practices to follow when working with the various Rev AI APIs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"assumptions","__idx":2},"children":["Assumptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial assumes that you have a Rev AI account and access token. If not, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.rev.ai/auth/signup"},"children":["sign up for a free account"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/get-started#step-1-get-your-access-token"},"children":["generate an access token"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":3},"children":["Best practices"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use-a-supported-file-format","__idx":4},"children":["Use a supported file format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rev AI supports most common media formats. For best results, use a lossless format such as FLAC or ALAC, or a lossy format like MP3 or AAC with a bitrate of 192 Kbps or above."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use-a-high-sample-rate","__idx":5},"children":["Use a high sample rate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you control the audio source, record at 16kHz sample rate or higher. We can transcribe audio as low as 8kHz as well. Submit the audio in its original format."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use-multiple-channels-for-multiple-speakers","__idx":6},"children":["Use multiple channels for multiple speakers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For perfect speaker separation (speaker diarization), record each speaker on their own channel and submit the job using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["speaker_channels_count"]}," parameter. If the speakers are recorded on a single channel, do not attempt to modify the recording; submit the file as is."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dont-pre-process-audio","__idx":7},"children":["Don't pre-process audio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Don't pre-process, up-sample or down-sample audio. This can distort the audio and reduce the transcript accuracy. The Rev AI speech engine is very robust and has been designed to handle a large variety of audio recordings."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-custom-vocabulary-for-unusual-words","__idx":8},"children":["Create custom vocabulary for unusual words"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To improve recognition of uncommon words, such as proper names and special technical terms, submit a list of these words as custom vocabulary along with your request. Read the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/custom-vocabulary"},"children":["Custom Vocabulary API documentation"]}," for more details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":9},"children":["Next steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more about the topics discussed in this tutorial by visiting the following links:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/asynchronous"},"children":["Asynchronous Speech-to-Text API documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/custom-vocabulary"},"children":["Custom Vocabulary API documentation"]}]}]}]},"headings":[{"value":"Best Practices for the Rev AI APIs","id":"best-practices-for-the-rev-ai-apis","depth":1},{"value":"Introduction","id":"introduction","depth":2},{"value":"Assumptions","id":"assumptions","depth":2},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Use a supported file format","id":"use-a-supported-file-format","depth":3},{"value":"Use a high sample rate","id":"use-a-high-sample-rate","depth":3},{"value":"Use multiple channels for multiple speakers","id":"use-multiple-channels-for-multiple-speakers","depth":3},{"value":"Don't pre-process audio","id":"dont-pre-process-audio","depth":3},{"value":"Create custom vocabulary for unusual words","id":"create-custom-vocabulary-for-unusual-words","depth":3},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Best Practices for the Rev AI APIs","description":"Learn the best practices to obtain higher-quality ASR results from the Rev AI APIs","date":"2022-02-11T00:00:00.000Z","byline":"Chance Shiflett, Solutions Engineering Manager","disableLastModified":false,"toc":{"enable":true},"seo":{"title":"Best Practices for the Rev AI APIs"}},"lastModified":"2026-02-24T14:47:49.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/resources/tutorials/api-best-practices","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}