Overview

// // introduction about elevateai by nice elevateai apis leverage cutting edge research in artificial intelligence (ai), automatic speech recognition (asr), and natural language processing (nlp) to transcribe audio conversations into precise text that can be fed into any data lake or application using elevateai, you can access key data needed to understand conversations at scale our cx ai models provide objective insights into audio , transcription , and chat interactions, such as voice activity voice activity , out of the box behavioral models behavioral models – including sentiment analysis – and our elevateai generative ai api calls that includes autosummary, agent coaching, ask elevateai q\&a, and more echo by elevateai – our latest transcription model offers high accuracy speech recognition in over 50 languages and dialects, optimized for global, enterprise scale applications echo model supported languages ! elevateai api information flow just getting started? get started get started in under 60 seconds! each api endpoint api endpoint includes a detailed tutorial with required parameters, code samples, and response examples/schemas to help with your integration quickly and efficiently not a developer? you can transcribe and analyze audio interactions directly from the web based elevateai portal, with no code no code needed we're here to help! if you have any questions, our team of product experts and developers are available and eager to provide additional support https //docs elevateai com/#4zatw ! // // authentication your active api tokens authorize requests on behalf of your account and carry many privileges, so be sure to keep them secure do not share your api tokens in publicly accessible areas such as github, client side code, etc to ensure authentication, all api requests must be made over https requests made over plain http and/or api requests without an active api token will fail for your convenience and security, api tokens can be managed at any time in the manage tokens https //docs elevateai com/tutorials/elevateai dashboards# xqwv dashboard / / / / data retention & security your data is yours ! the elevateai api is secured with transport layer security (tls) 1 2 to secure and encrypt the communication as well as protect the data in transit the service also uses tls mutual authentication to ensure only legitimate users can access the api all source data is deleted promptly upon processing analysis output is stored in our us based data warehouse for up to 45 days, encrypted in transit and at rest, so that you may access your results note after 45 days, all associated data is deleted and irretrievable if you have retrieved the desired results and would like to permanently delete all analysis data from our database prior to the 45 day standard retention period, you may do so at any time using the delete delete api endpoint https //docs elevateai com/tutorials/delete data as a publicly traded company trusted by leading brands worldwide, we make data security a top priority want additional information? see elevateai privacy notice elevateai privacy notice // // processing times remember you can retrieve the processing status of your interaction at any time directly from a get get api endpoint https //docs elevateai com/tutorials/check the processing status or the interactions dashboard https //docs elevateai com/tutorials/elevateai dashboards#41su6 audio interaction files audio interactions are generally processed within 25 65% of the total file duration , but may vary by system integration and number of concurrent requests transcript and chat interaction files transcript https //docs elevateai com/tutorials/declare a transcript and chat https //docs elevateai com/tutorials/declare a chat interaction interactions are generally processed in seconds , but may vary by system integration and number of concurrent requests // // accepted file formats & sizes audio file formats elevateai supports virtually all unencrypted audio types, whether single or dual channel if you have any questions or would like to see a full list of supported audio files, reach out to us at support\@elevateai com support\@elevateai com pro tip for highest levels of accuracy, we suggest stereo g 729a audio files supported file size elevateai supports both uploads and downloads up to 450mb // // supported languages new echo model echo by elevateai is our newest and most accurate transcription model, posting 40% increases over previous performance measures echo offers automatic language detection, high accuracy speech recognition in over 50 languages and dialects, and is optimized for global, enterprise scale applications echo model supported languages ! echo is ideal for all media types, including interviews, podcasts, videos, calls, as well as contact center media and more purpose built cx model our cx model was purpose built for the contact center based on decades of industry experience and is ideal for use with all types of contact center media language tag pii redaction north american english en us social security numbers, credit card numbers, and cvv numbers international english en credit card numbers and cvv numbers latin american spanish es 419 social security numbers, credit card numbers, and cvv numbers french fr german de brazilian portuguese pt br japanese ja cantonese zh yue mandarin zh cmn cx ai our cx ai models generate reportable ai scores for useful contact center metrics and behavioral insights; see cx ai features docid\ zatcqmnsvapzs9wwkgecn for additional information languages supported by our custom cx ai models are noted below language tag cx ai models north american english en us behaviors for csat , https //docs elevateai com/cx ai features#nioo8 sales effectiveness international english en behaviors for csat and vulnerable customers https //docs elevateai com/cx ai features#nioo8 latin american spanish es 419 behaviors for csat https //docs elevateai com/cx ai features#nioo8 brazilian portuguese pt br behaviors for csat https //docs elevateai com/cx ai features#nioo8 language tag cx ai models north american english en us behaviors for csat , https //docs elevateai com/cx ai features#nioo8 sales effectiveness international english en behaviors for csat and vulnerable customers , https //docs elevateai com/cx ai features#nioo8 latin american spanish es 419 behaviors for csat https //docs elevateai com/cx ai features#nioo8 brazilian portuguese pt br behaviors for csat https //docs elevateai com/cx ai features#nioo8 language tag cx ai models north american english en us behaviors for csat , https //docs elevateai com/cx ai features#nioo8 sales effectiveness international english en behaviors for csat https //docs elevateai com/cx ai features#nioo8 latin american spanish es 419 behaviors for csat https //docs elevateai com/cx ai features#nioo8 generative ai our generative ai endpoints support all echo model supported languages docid 6umizpoxhj2fcfggarhy generative ai endpoints can be called in real time declare > immediately call generative ai for chats and transcripts audio files require processing to be completed // // error handling elevateai uses conventional http response codes for each api request codes in the 2xx range indicate the request was successfully executed codes in the 4xx range indicate a failure based on the information provided (e g , a required parameter was omitted) while rare, codes in the 5xx range may indicate an error with the elevateai service if a request is successful but an error occurs when uploading, downloading, or processing your interaction, a descriptive errormessage will be provided when checking the processing status https //docs elevateai com/tutorials/check the processing status of the interaction we're here to help! if you have any questions not addressed within this documentation, our team of product experts and developers are available and eager to provide additional support https //docs elevateai com/#4zatw ! http status code summary 400 bad request the api request does not contain the expected parameters (either missing a required parameter or providing an unexpected value for a parameter) prior to re requesting, review the parameters and code examples within the associated tutorial https //docs elevateai com/tutorials#e8prs 401 unauthorized the api request is missing or passed an invalid x api token in the header prior to re requesting, confirm or request your api token within the manage tokens https //docs elevateai com/tutorials/elevateai dashboards# xqwv dashboard 404 not found either the api request was made with an invalid/deleted interactionidentifer in the path, or analysis results have been requested prior to processing completion prior to re requesting, confirm your api token within the manage tokens https //docs elevateai com/tutorials/elevateai dashboards# xqwv dashboard, check the processing status https //docs elevateai com/tutorials/check the processing status 409 conflict the api request made can't be complete because you have previously uploaded an audio file https //docs elevateai com/tutorials/upload an audio file or provided a downloaduri when declaring the audio interaction https //docs elevateai com/tutorials/declare an audio interaction 413 payload too large the elevateai service couldn't retrieve the uploaded file or the file is larger than the maximum supported file size https //docs elevateai com/#iz75c confirm file size, re upload, and if you still receive the error, re declare the interaction 429 too many requests the api request to declare the interaction exceeds the monthly quota associated with your account to upgrade to a paid account or request your quota be increased, contact us at sales\@elevateai com // // daily quota free accounts free accounts have access to declare up to 1,000 interactions per day ! if you are interested in upgrading to a paid account for higher usage, please contact us at sales\@elevateai com sales\@elevateai com production (paid) accounts by default, paid accounts have access to declare up to 5,000 interactions per day if you require a higher limit, please reach out to us at support\@elevateai com to request a limit increase // // additional support our team of product experts and developers are on call and available to answer any questions you may have ! for the fastest response times, please direct your question to the following questions about upgrading to a paid account? contact us at sales\@elevateai com sales\@elevateai com questions about the terms of use, privacy policy, or the legal side of things? contact us at legal\@elevateai com legal\@elevateai com questions about our product roadmap or to request a feature? contact us at product\@elevateai com product\@elevateai com for any other support questions, contact us at support\@elevateai com support\@elevateai com