{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"2dfd3077-ca21-4629-a130-144f308ac911","name":"Speechace API","description":"![](\"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! Task Achievement and full PTE Speaking assessment\n\n## Introducing the Score Task API with support for Describe-Image, Retell-Lecture, and Answer-Question content scoring\n\nThe new [Score Task API](https://docs.speechace.com/#a9d386e2-c8fc-492f-a6b4-eefc24895aa5) now supports advanced evaluation of the content of a spontaneous response, and how well it accomplished the task set out in the question. The API supports scoring tasks with either audio or text only and provides a content score aligned with the PTE content score scale.\n\n---\n\n# NEW! French and Spanish Scripted and Spontaneous Speech Assessment with Task Achievment\n\n## Speechace Pronunciation Assessment API and Fluency Assessment API now support French and Spanish\n\nSpeechace API v9.9 now supports assessment of pronunciation and fluency in 4 new dialects: (fr-fr, fr-ca, es-es, es-mx):\n\n- Pronunciation assessment with utterance, word, syllable, and phoneme level scores\n \n- Fluency assessment with utterance and segment level scores\n \n- Scores provided on 0 to 100 scale and CEFR\n \n- Available today in all regions\n \n- Premium API support for Spontaneous Speech transcription + Scoring in French and Spanish\n \n- Premium API support for Task Achievment scoring in French and Spanish\n \n\nSee the API examples for details: \n[Score Pronunciation API](https://docs.speechace.com/#0d443b6f-56ae-4ce3-b25f-81d8fa189ec5)\n\n[Score Fluency API](https://docs.speechace.com/#fcfed32d-25e9-40a7-bddc-cca399489d65)\n\n[Transcribe & Score API](https://docs.speechace.com/#76089b5d-7e25-4744-8d32-f6c230acf217)\n\n[Score Task API](https://docs.speechace.com/#a9d386e2-c8fc-492f-a6b4-eefc24895aa5)\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**
Word and Sentence speaking activities
Multiple Choice speaking activities |\n| PRO | **Fluency Assessment** **API**
Read Aloud, Repeat Sentence
IELTS/PTE Fluency practice activities |\n| PREMIUM | **Spontaneous Speech Assessment** **API**
CEFR, IELTS, TOEIC, PTE Speaking Proficiency Assessment
Free speaking activities
Relevance Assessment
Comprehensive skill assessment: Grammar, Vocabulary, Coherence, Pronunciation, Fluency
Task Achievement |\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://)? | 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.0/json](https://)? | This request will explicitly use the minor version v9.0 |\n\n**Major version history:**\n\n| **version** | **url** | **notes** |\n| --- | --- | --- |\n| 1 | [https://api.speechace.co/api/scoring/text/v0.1/json](https://)? | v1 |\n| 2 | [https://api.speechace.co/api/scoring/text/v0.2/json](https://)? | v2 |\n| 3 | [https://api.speechace.co/api/scoring/text/v0.3/json](https://)? | v3 |\n| 5 | [https://api.speechace.co/api/scoring/text/v0.5/json](https://)? | v5 |\n| 7 | [https://api.speechace.co/api/scoring/text/v0.7/json](https://)? | v7 |\n| 9 | [https://api.speechace.co/api/scoring/text/v9/json](https://)? | current latest production major version |\n| 9.2 | [https://api.speechace.co/api/scoring/text/v9.2/json](https://)? | New minor version scoring models. |\n| 9.4 | [https://api.speechace.co/api/scoring/text/v9.4/json](https://)? | New minor version Transcription models |\n| 9.5 | [https://api.speechace.co/api/scoring/text/v9.5/json](https://)? | New noise reduction enhacement.
Beta Grammar, Coherence, Vocab feedback metrices.
Current latest production minor version |\n| 9.7 | [https://api.speechace.co/api/scoring/text/v9.7/json](https://api.speechace.co/api/scoring/text/v9.7/json)? | Noise and aligment updates.
New relevance scoring model
[Markup language support for letter to phoneme mapping](https://) |\n| 9.8 | [https://api.speechace.co/api/scoring/text/v9.8/json](https://api.speechace.co/api/scoring/text/v9.8/json)? | Pronunciation model update
Grammatical accuracy model update |\n| 9.9 | [https://api.speechace.co/api/scoring/text/v9.9/json](https://api.speechace.co/api/scoring/text/v9.9/json)? | Core model updates
Major performance enhancement |\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.10.1","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"}