{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"2dfd3077-ca21-4629-a130-144f308ac911","name":"Speechace API","description":"<img src=\"https://s3-us-west-2.amazonaws.com/speechace-public/images/Speechace-API-Card.png\">\n\n[Speechace](https://www.speechace.com) is a Speech Recognition API for fluency and pronunciation assessment. Our patented technology is unique in its ability to score a learner's speech and pinpoint individual syllable and phoneme level mistakes in a user's pronunciation in real time.\n\n---\n\n# NEW! API v9.17 Score Word API with optimization for single word requests\n\n## Introducing the Score Word API with support for scoring words, custom words, MC targets with single word\n\nThe new [Score Word API](https://docs.speechace.com/#824b2e5a-4e68-4946-ab15-7c5bdf0e7084) is optimized for scoring the pronunciation of a single word. It supports scoring optimizations and model combinations targeted at utterances where the speaking is pronouncing a single word.\n\nA word can be:\n\n- A dictionary word (e.g. cat)\n    \n- A word specified with markup (e.g. read in present tense)\n    \n- A custom non-word specified with markup\n    \n- A Mutiple Choice (MC) combination where each target is a single word\n    \n- A Multuple Choice (MC) combination with markup\n    \n\n---\n\n# API SKUs and Use Cases\n\nThe Speechace API comes in 3 SKUs and can be used to assess and score a variety of speaking activities.\n\n| API SKU | Use Cases |\n| --- | --- |\n| BASIC | **Pronunciation Assessment** **API**  <br>Word and Sentence speaking activities  <br>Multiple Choice speaking activities |\n| PRO | **Fluency Assessment** **API**  <br>Read Aloud, Repeat Sentence  <br>IELTS/PTE Fluency practice activities |\n| PREMIUM | **Spontaneous Speech Assessment** **API**  <br>CEFR, IELTS, TOEIC, PTE Speaking Proficiency Assessment  <br>Free speaking activities  <br>Relevance Assessment  <br>Comprehensive skill assessment: Grammar, Vocabulary, Coherence, Pronunciation, Fluency  <br>Task Achievement  <br>Writing Assessment |\n\n# API Keys\n\nYou need a Speechace API Subscription to obtain a key. You can obtain a Speechace key at [https://www.speechace.com/api-plans](https://www.speechace.com/api-plans)\n\n# API Regions\n\nThe Speechace API currently supports the following regions. Your API Key is tied to a specific region. You can request additional API Keys under the same Subscription within other regions.\n\n| **Region** | **API Endpoint** |\n| --- | --- |\n| US West (Oregon) | [https://api.speechace.co](https://) |\n| AP Southeast (Singapore) | [https://api2.speechace.com](https://) |\n| EU West (Ireland) | [https://api4.speechace.com](https://) |\n| AP South (Mumbai) | [https://api5.speechace.com](https://) |\n\n# API Versioning\n\nThe Speechace API versioning is explicit in the request URL.\n\nUp to v9.0 Speechace API versioning was explicit with the caller specifying the exact version they use in the request url. From v9.0 onwards the API caller can choose to take silent minor version updates.\n\n| **Request url** | **Resulting** **version** |\n| --- | --- |\n| [https://api.speechace.co/scoring/text/v9/json](https://api.speechace.co/scoring/text/v9/json)? | This request will use the latest available minor version of v9 (e.g. v9.0 or v9.1 or v9.2 etc.) |\n| [https://api.speechace.co/scoring/text/v9.2/json](https://api.speechace.co/scoring/text/v9.2/json)? | This request will explicitly use the minor version v9.2 |\n\n**Version history:**\n\n| Version | URL | Description |\n| --- | --- | --- |\n| 9.17 | ​[https://api.speechace.co/api/scoring/text/v9.17/json?](https://api.speechace.co/api/scoring/text/v9.14/json?)​ | New scoring model updates for single word scoring  <br>[Score Word API](https://app.gitbook.com/o/8miq9EcDdZOxBexpQST9/s/KaDVy4leVobAfOfVNuic/api-reference/score-word). |\n| 9.16 | ​[https://api.speechace.co/api/scoring/text/v9.16/json?](https://api.speechace.co/api/scoring/text/v9.14/json?)​ | Improvements and fixes to Pitch and Intonation model |\n| 9.15 | ​[https://api.speechace.co/api/scoring/text/v9.15/json?](https://api.speechace.co/api/scoring/text/v9.14/json?)​ | Improvement and fixes to core scoring models. |\n| 9.14 | ​[https://api.speechace.co/api/scoring/text/v9.14/json?](https://api.speechace.co/api/scoring/text/v9.14/json?)​ | ​  <br>  <br>\\- Major Spontaneous Speech Transcription model update  <br>  <br>\\- Spontaneous Speech Scoring model updates  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.13 | ​[https://api.speechace.co/api/scoring/text/v9.13/json?](https://api.speechace.co/api/scoring/text/v9.13/json?)​ | ​  <br>  <br>\\- Core Pronunciation model update  <br>  <br>\\- Lexicon and alt Dictionary support  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.12 | ​[https://api.speechace.co/api/scoring/text/v9.12/json?](https://api.speechace.co/api/scoring/text/v9.12/json?)​ | ​  <br>  <br>\\- Core Pronunciation model update  <br>  <br>\\- Connected Speech expansion  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.11 | ​[https://api.speechace.co/api/scoring/text/v9.11/json?](https://api.speechace.co/api/scoring/text/v9.11/json?)​ | ​  <br>  <br>\\- Core Pronunciation model update  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.10 | ​[https://api.speechace.co/api/scoring/text/v9.10/json?](https://api.speechace.co/api/scoring/text/v9.10/json?)​ | ​  <br>  <br>\\- VAD model update scoring/text, scoring/speech  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.9 | ​[https://api.speechace.co/api/scoring/text/v9.9/json?](https://api.speechace.co/api/scoring/text/v9.9/json?)​ | \\- Core Pronunciation model updates  <br>  <br>\\- Major performance enhancement  <br>  <br>\\- Bug fixes and minor enhancements |\n| 9.8 | ​[https://api.speechace.co/api/scoring/text/v9.8/json?](https://api.speechace.co/api/scoring/text/v9.8/json?)​ | ​  <br>  <br>\\- Pronunciation model update  <br>  <br>\\- Grammatical accuracy model update |\n| 9.7 | ​[https://api.speechace.co/api/scoring/text/v9.7/json?](https://api.speechace.co/api/scoring/text/v9.7/json?)​ | ​  <br>  <br>\\- Noise and alignment updates  <br>  <br>\\- New relevance scoring model  <br>  <br>\\- Markup language support for letter to phoneme mapping |\n| 9.5 | ​[https://api.speechace.co/api/scoring/text/v9.5/json?](https://api.speechace.co/api/scoring/text/v9.5/json?)​ | ​  <br>  <br>\\- New noise reduction enhancement  <br>  <br>\\- Beta Grammar, Coherence, Vocab feedback metrics |\n| 9.4 | ​[https://api.speechace.co/api/scoring/text/v9.4/json?](https://api.speechace.co/api/scoring/text/v9.4/json?)​ | ​  <br>  <br>\\- New minor version Transcription models |\n| 9.2 | ​[https://api.speechace.co/api/scoring/text/v9.2/json?](https://api.speechace.co/api/scoring/text/v9.2/json?)​ | New minor version scoring models |\n| 9 | ​[https://api.speechace.co/api/scoring/text/v9/json?](https://api.speechace.co/api/scoring/text/v9/json?)​ | current latest production major version |\n\nYou can keep up with new version announcements by subscribing to the Speechace Blog at [https://www.speechace.com/blog/](https://www.speechace.com/blog/)\n\n# Samples\n\nYou can download samples showing both:\n\n- frontend (recording audio, passing to backend, showing scores)\n    \n- backend (calling speechace API, passing scores to frontend)\n    \n\nThe samples are available at [https://github.com/speechace/speechace-api-samples](https://github.com/speechace/speechace-api-samples)\n\n# API Limits\n\nThe Speechace API has the following limits per the API SKU license: Basic, Pro, or Premium.\n\n| Limit | API SKU (BASIC) | API SKU (PRO) | API SKU (PREMIUM) |\n| --- | --- | --- | --- |\n| Max Audio Length | 15 seconds | 45 seconds | 2 minutes |\n| Max File Size | 1.9MB | 2.5MB | 3.8MB |\n\n# Recording Audio\n\nSpeechace supports audio in most formats used on the web (e.g. wav, mp3, m4a, ogg, webm, aiff). We strongly recommend recording at the following settings to optimize your file size and increase performance:\n\n- _sample size_: 16-bit\n    \n- _sample rate_: 16Khz\n    \n- _channels_: 1 (i.e. mono)\n    \n\n# Terms of Service\n\nBy using the Speechace API you agree to the [Privacy Policy](https://www.speechace.com/api-privacy-policy/) and the [Terms of Service](https://www.speechace.com/terms-of-service/).\n\nSpeechace API is the Copyright © Speechace LLC, Seattle, WA, USA.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"2675436","team":335157,"collectionId":"2dfd3077-ca21-4629-a130-144f308ac911","publishedId":"S1ERuwiL","public":true,"publicUrl":"https://docs.speechace.com","privateUrl":"https://go.postman.co/documentation/2675436-2dfd3077-ca21-4629-a130-144f308ac911","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00ABE0"},"documentationLayout":"classic-single-column","customisation":null,"version":"8.12.3","publishDate":"2022-03-07T02:54:42.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/16d10a4018a334377edadca9ca63d18de4736e9513fddeb2bf41114a721370b9","favicon":"https://res.cloudinary.com/postman/image/upload/v1555608599/team/aappqfjoth3jj54ekfrf.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://docs.speechace.com/view/metadata/S1ERuwiL"}