developer.learngual.com
Open in
urlscan Pro
54.225.80.196
Public Scan
URL:
https://developer.learngual.com/
Submission: On February 24 via api from US — Scanned from US
Submission: On February 24 via api from US — Scanned from US
Form analysis 0 forms found in the DOM
Text Content
* Body
* Headers (19)
* Body
* Headers (19)
Public
Documentation Settings
ENVIRONMENT
No Environment
LAYOUT
Double Column
LANGUAGE
cURL - cURL
Developer Requests
Introduction
Learngual API Integration
DEVELOPER REQUESTS
A collection of API requests for interacting with the Learngual Speech Analysis
service. Retrieve task results, assess pronunciation, fluency, and overall
speech quality.
Don't have an account? Click to get Started
LEARNGUAL API INTEGRATION
POSTDEMO WITH TASK
https://dev-117782726-api.learngual.com/iam/v1/accounts/demo_with_task/?_lang=Catalan
Purpose:
This API request directly submits audio data, along with other parameters, to
our speech service for analysis or transcription. The scripted parameter
controls the specific processing mode. The response includes a task_id for
tracking the status of the asynchronous process.
Authentication:
* The API requires an API key passed in the api-key header.
Parameters:
* reference_text (FormData, optional): A word or phrase to guide the
processing. Include this parameter when you want the analysis to compare the
audio against this reference.
* audio_data (FormData): Audio file for analysis.
* language (FormData): Specifies the language of the audio file.
* scripted (FormData): A boolean value controlling the analysis mode:
* Set to true for audio comparison against the reference_text.
* Set to false to analyze the audio without a reference.
* _lang (URL Query Parameter): This parameter is appended to the endpoint URL.
Available Languages
Our speech service supports analysis of the following languages:
* Arabic
* Chinese
* English
* French
* German
* Hindi
* Italian
* Japanese
* Polish
* Portuguese
* Turkish
* Russian
* Spanish
Important Note: Always specify the correct language in your requests to ensure
the best possible analysis results.
HEADERS
api-key
api_key_-p7BFE8nyqsYAwC0NFhwrNNElQDptv9AqqcXIWwGGeE
PARAMS
_lang
Catalan
api-key
api_key_-p7BFE8nyqsYAwC0NFhwrNNElQDptv9AqqcXIWwGGeE
Bodyformdata
reference_text
administration
only optional if unscripted is false
audio_data
language
English
optional:
scripted
true
optional:
prompt
Tell me about your holiday.
optional:
callback_url
http://marlee.org
Example Request
demo with task
View More
curl
curl --location 'https://dev-117782726-api.learngual.com/iam/v1/accounts/demo_with_task/?_lang=Portugal' \
--header 'api-key: api_key_-p7BFE8nyqsYAwC0NFhwrNNElQDptv9AqqcXIWwGGeE' \
--form 'reference_text="administration"' \
--form 'audio_data=@"/Users/user/Downloads/administration.wav"' \
--form 'language="Azerbaijani"' \
--form 'scripted="true"' \
--form 'prompt="Tell me about your holiday."'
200 OK
Example Response
* Body
* Headers (19)
json
{
"task_id": "PVpQEb3RWIlxNCl8r8TLvZ3VFfvZNKZMJw-l0YKUvdK46lhj76MRqw",
"detail": "Process is running asynchronously."
}
Date
Fri, 22 Sep 2023 13:14:37 GMT
Content-Type
application/json
Transfer-Encoding
chunked
Connection
keep-alive
vary
Accept, Accept-Language, Cookie, origin
allow
POST, OPTIONS
x-frame-options
DENY
content-language
en
strict-transport-security
max-age=15724800; includeSubDomains
x-content-type-options
nosniff
referrer-policy
same-origin
cross-origin-opener-policy
same-origin
CF-Cache-Status
DYNAMIC
Report-To
{"endpoints":[{"url":"https:\/\/a.nel.cloudflare.com\/report\/v3?s=CpuGlT7rkdWYhJ5ZflfoDQRNIO4DHgBFs%2F5UJ1sLjkcpsS8X%2BdKYc4zlTvmuF3C90WkpD3tHN4SLV8kIzTZZJH3D%2BAx6SlGu8nN9bKpNyjlbd0c7eAn5x9pnuNpJBI1GVylQh9Dh4WoGlDJtdZJJKBFO"}],"group":"cf-nel","max_age":604800}
NEL
{"success_fraction":0,"report_to":"cf-nel","max_age":604800}
Server
cloudflare
CF-RAY
80aacfde9b06b784-AMS
Content-Encoding
br
alt-svc
h3=":443"; ma=86400
GETDEMO TASK RESULT
https://dev-117782726-api.learngual.com/iam/v1/accounts/:task_id/task_result/
Purpose:
This API request retrieves the results of a specific speech analysis task from
our speech service. The endpoint URL includes a unique task ID, indicating that
the task has been previously submitted for processing.
PATH VARIABLES
task_id
Example Request
demo task result
View More
curl
curl --location 'https://dev-117782726-api.learngual.com/iam/v1/accounts/:task_id/task_result/?_lang=Portugal' \
--header 'api-key: api_key_-p7BFE8nyqsYAwC0NFhwrNNElQDptv9AqqcXIWwGGeE'
200 OK
Example Response
* Body
* Headers (19)
View More
json
{
"id": "PVpQEb3RWIlxNCl8r8TLvZ3VFfvZNKZMJw-l0YKUvdK46lhj76MRqw",
"status": "successful",
"data": {
"Reference": "administration",
"Hypothesis": "administration",
"Translated Reference": "Hüquq",
"General Score": 100,
"Speech Rate": 55.555555555555564,
"Audibility": 86.36001383635842,
"Word Phonetic Evaluation": {
"1": {
"Word": "ADMINISTRATION",
"Word Language Translation": "Hüquq",
"Word Meaning": [
{
"Metonym": "administration",
"Part of Speech": "Noun",
"Meaning": "a method of tending to or managing the affairs of a some group of people (especially the group's business affairs)",
"Meaning Language Translation": "Bir çox insan qrupunun işlərinin işlərinə və ya idarə edilməsinin təşkil edilməsi üsulu (başa qrup iş işləri)",
"Similar Usage Examples": [],
"Similar Usage Examples Translation": []
},
{
"Metonym": "administration",
"Part of Speech": "Noun",
"Meaning": "the persons (or committees or departments etc.) who make up a body for the purpose of administering something",
"Meaning Language Translation": "Bir şey idarə etmək üçün bir bərpa etmək istəyirlər (yağda kompüter və s.)",
"Similar Usage Examples": [
"he claims that the present administration is corrupt",
"the governance of an association is responsible to its members",
"he quickly became recognized as a member of the establishment"
],
"Similar Usage Examples Translation": [
"O, cari idarənin yozlaşmış olduğunu iddia edir",
"Bir əməkdaşlığın idarə edilməsi onun üzvlərindən qəbul edir",
"O, həyata keçirilib"
]
},
{
"Metonym": "administration",
"Part of Speech": "Noun",
"Meaning": "the act of administering medication",
"Meaning Language Translation": "Əməliyyatın təhlükəsizliyi",
"Similar Usage Examples": [],
"Similar Usage Examples Translation": []
},
{
"Metonym": "presidency",
"Part of Speech": "Noun",
"Meaning": "the tenure of a president",
"Meaning Language Translation": "Prezidentin onure",
"Similar Usage Examples": [
"things were quiet during the Eisenhower administration"
],
"Similar Usage Examples Translation": [
"Avtomobilin idarə edilməsi"
]
},
{
"Metonym": "government",
"Part of Speech": "Noun",
"Meaning": "the act of governing; exercising authority",
"Meaning Language Translation": "Mühüm hüquququ",
"Similar Usage Examples": [
"regulations for the governing of state prisons",
"he had considerable experience of government"
],
"Similar Usage Examples Translation": [
"Dövlət zavodlarının müqaviləsi",
"O, haqqında məlumata malik idi"
]
},
{
"Metonym": "administration",
"Part of Speech": "Noun",
"Meaning": "the act of meting out justice according to the law",
"Meaning Language Translation": "Hüquq məsləhətin hüquqına uyğun həyata keçirilib",
"Similar Usage Examples": [],
"Similar Usage Examples Translation": []
}
],
"Synonyms": [
"disposal",
"governance",
"governing body",
"establishment",
"brass",
"organization",
"organisation",
"giving medication",
"presidency",
"presidential term",
"government",
"governing",
"governance",
"government activity",
"judicature"
],
"Antonyms": [],
"Syllables": [
{
"Onset": "EMPTY",
"Nucleus": "AE",
"Coda": "D",
"isShort": true,
"isLight": false,
"Stress": "No",
"Syllabic Score": 100
},
{
"Onset": "M",
"Nucleus": "IH",
"Coda": "EMPTY",
"isShort": true,
"isLight": true,
"Stress": "Secondary",
"Syllabic Score": 99
},
{
"Onset": "N",
"Nucleus": "IH",
"Coda": "EMPTY",
"isShort": true,
"isLight": true,
"Stress": "No",
"Syllabic Score": 100
},
{
"Onset": "STR",
"Nucleus": "EY",
"Coda": "EMPTY",
"isShort": false,
"isLight": false,
"Stress": "Primary",
"Syllabic Score": 100
},
{
"Onset": "SH",
"Nucleus": "AH",
"Coda": "N",
"isShort": true,
"isLight": false,
"Stress": "No",
"Syllabic Score": 99
}
],
"Word Score": 100,
"Number Of Syllables": 5,
"Phoneme Phonetic Evaluation": {
"1": {
"Phoneme (Grapheme)": "AE",
"Score": 100,
"Duration": "0.07 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "AE",
"IPA": "æ",
"Example": "at",
"Translation": "AE T",
"Class": "VOWEL",
"Voice": "VOICED",
"Articulator": "",
"Airstream Mechanism": "",
"Other Examples": [
"palpitations",
"ballin",
"camco",
"notepads",
"allardt",
"appalachian",
"finances",
"zanger",
"classactions",
"shaffner"
]
},
"2": {
"Phoneme (Grapheme)": "D",
"Score": 100,
"Duration": "0.05 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "D",
"IPA": "d",
"Example": "dee",
"Translation": "D IY",
"Class": "STOP (CONSONANT)",
"Voice": "VOICED",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "PLOSIVE",
"Other Examples": [
"hebda",
"drafts",
"davalos",
"der",
"dynasty",
"aldric",
"dweck",
"barreled",
"disavowed",
"hyundai"
]
},
"3": {
"Phoneme (Grapheme)": "M",
"Score": 100,
"Duration": "0.03 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "M",
"IPA": "m",
"Example": "me",
"Translation": "M IY",
"Class": "NASAL (CONSONANT)",
"Voice": "VOICED",
"Articulator": "BILABIAL",
"Airstream Mechanism": "NASAL",
"Other Examples": [
"unscom",
"helmbrecht",
"concomitant",
"oldsmobiles",
"ransom's",
"ormes",
"locomotion",
"ferromagnet",
"mcever",
"problem's"
]
},
"4": {
"Phoneme (Grapheme)": "IH",
"Score": 98,
"Duration": "0.13 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "IH",
"IPA": "i",
"Example": "it",
"Translation": "IH T",
"Class": "VOWEL",
"Voice": "VOICED",
"Articulator": "",
"Airstream Mechanism": "",
"Other Examples": [
"tourniquet",
"noninterest",
"indivisible",
"anatomist",
"sheathbills",
"lennig",
"brocklin",
"competencies",
"reportage",
"fitzgibbon"
]
},
"5": {
"Phoneme (Grapheme)": "N",
"Score": 100,
"Duration": "0.04 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "N",
"IPA": "n",
"Example": "knee",
"Translation": "N IY",
"Class": "NASAL (CONSONANT)",
"Voice": "VOICED",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "NASAL",
"Other Examples": [
"northwood",
"appendage",
"winward",
"intends",
"elliman",
"rangel",
"chinnici",
"flanders",
"chapnick",
"infringe"
]
},
"6": {
"Phoneme (Grapheme)": "IH",
"Score": 100,
"Duration": "0.06 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "IH",
"IPA": "i",
"Example": "it",
"Translation": "IH T",
"Class": "VOWEL",
"Voice": "VOICED",
"Articulator": "",
"Airstream Mechanism": "",
"Other Examples": [
"repel",
"glendinning",
"klipfel",
"frisked",
"dinovo",
"bitching",
"paleontologist",
"internationals",
"localities",
"gingrich"
]
},
"7": {
"Phoneme (Grapheme)": "S",
"Score": 100,
"Duration": "0.09 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "S",
"IPA": "s",
"Example": "sea",
"Translation": "S IY",
"Class": "FRICATIVE (CONSONANT)",
"Voice": "VOICELESS",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "FRICATIVE",
"Other Examples": [
"lawsuits",
"macinnes",
"discolors",
"bielecki",
"quest",
"synthetics",
"westford",
"reduced",
"scampering",
"elsesser"
]
},
"8": {
"Phoneme (Grapheme)": "T",
"Score": 100,
"Duration": "0.06 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "T",
"IPA": "t",
"Example": "tea",
"Translation": "T IY",
"Class": "STOP (CONSONANT)",
"Voice": "VOICELESS",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "PLOSIVE",
"Other Examples": [
"metering",
"hypocritical",
"tanqueray",
"mosaicked",
"sferrazza",
"sated",
"pockets",
"encompassed",
"intertribal",
"stimulant"
]
},
"9": {
"Phoneme (Grapheme)": "R",
"Score": 100,
"Duration": "0.07 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "R",
"IPA": "ɹ",
"Example": "read",
"Translation": "R IY D",
"Class": "LIQUID (CONSONANT)",
"Voice": "VOICED",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "CENTRAL",
"Other Examples": [
"archduke",
"purported",
"mccorvey",
"crochetiere",
"prominently",
"functionaries",
"substrates",
"programs'",
"freedom's",
"parachutes"
]
},
"10": {
"Phoneme (Grapheme)": "EY",
"Score": 99,
"Duration": "0.06 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "EY",
"IPA": "eɪ",
"Example": "ate",
"Translation": "EY T",
"Class": "VOWEL",
"Voice": "VOICED",
"Articulator": "",
"Airstream Mechanism": "",
"Other Examples": [
"percolate",
"braking",
"bahrainis",
"microage",
"sedates",
"statecraft",
"merenda",
"angulate",
"dumais",
"mayday"
]
},
"11": {
"Phoneme (Grapheme)": "SH",
"Score": 100,
"Duration": "0.14 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "SH",
"IPA": "ʃ",
"Example": "she",
"Translation": "SH IY",
"Class": "FRICATIVE (CONSONANT)",
"Voice": "VOICELESS",
"Articulator": "POSTALVEOLAR",
"Airstream Mechanism": "FRICATIVE",
"Other Examples": [
"sherick",
"risch",
"esham",
"galoshes",
"circumspection",
"receptionists",
"hyphenation",
"auditioning",
"devonshire",
"mashed"
]
},
"12": {
"Phoneme (Grapheme)": "AH",
"Score": 99,
"Duration": "0.12 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "AH",
"IPA": "ʌ",
"Example": "hut",
"Translation": "HH AH T",
"Class": "VOWEL",
"Voice": "VOICED",
"Articulator": "",
"Airstream Mechanism": "",
"Other Examples": [
"guevara's",
"travolta",
"semicylindrical",
"embezzlers",
"concurred",
"exigencies",
"sweatman",
"gentleman",
"lemonade",
"copilot"
]
},
"13": {
"Phoneme (Grapheme)": "N",
"Score": 99,
"Duration": "0.16 secs",
"Grade": "Excellent",
"Phoneme Feedback Summary": "",
"Phoneme Feedback": "",
"Phoneme": "N",
"IPA": "n",
"Example": "knee",
"Translation": "N IY",
"Class": "NASAL (CONSONANT)",
"Voice": "VOICED",
"Articulator": "ALVEOLAR",
"Airstream Mechanism": "NASAL",
"Other Examples": [
"guerin",
"displacements",
"bemoan",
"roughton",
"extinctions",
"endeavour",
"reinspection",
"suspension",
"noncontroversial",
"margin"
]
}
}
}
},
"TOEFL iBT Score": 30,
"IELTS Score": 9,
"PTE Score": 90,
"CEFR Score": "C2",
"TOEIC Score": 200,
"TOEFL iBT Feedback": "Your speech is very clear generally and follows a fluid, sustained, coherent discourse. There might still be very minor issues with the pronunciation and intonation but generally, it is very intelligible. This is an excellent effort! Excellent display of coherent and clear speech! You made very proper use of your stresses. The flow and pace of your speech is perfect! There might still be little pronunciation issues but it is more intelligible and fluent and the pace is consistent. Even though there might be a few very short pauses, these are needed to maintain a flow or end a sentence or clause.",
"IELTS Feedback": "Very intelligible and properly executed speech. Remember to keep enunciating properly and speak clearly and loud enough. You speak more fluently due to very little or no unnecessary pauses! You might have some pronunciation issues but you maintain a remarkable flow!",
"PTE Feedback": "An excellently executed speech! You are exhibiting proper mastery of pronunciation in this task. There might still be some minor issues but you can perfect it with more practice. This is an excellent effort on your speech clarity and syllabic stresses! Remember, the key to having a high PTE score is to speak in a manner and flow that allows the listener to clearly understand you, regardless of your accent. Impeccable flow and control! No unnatural pauses or hesitation. Good job!",
"CEFR Feedback": "A great display of mastery in your pronunciation! Perfect your skill with more practice!",
"TOEIC Feedback": "An excellent effort in your fluency, intonation, and general pronunciation! Practice more to make this second nature.",
"Fluency": 100,
"Intonation": 100,
"Scripted": true,
"Prompt": "Tell me about your holiday.",
"Translated Language": "Azerbaijani"
},
"expired_at": "3600.0"
}
Date
Fri, 22 Sep 2023 13:14:57 GMT
Content-Type
application/json
Transfer-Encoding
chunked
Connection
keep-alive
vary
Accept, Accept-Language, Cookie, origin
allow
GET, HEAD, OPTIONS
x-frame-options
DENY
content-language
en
strict-transport-security
max-age=15724800; includeSubDomains
x-content-type-options
nosniff
referrer-policy
same-origin
cross-origin-opener-policy
same-origin
CF-Cache-Status
DYNAMIC
Report-To
{"endpoints":[{"url":"https:\/\/a.nel.cloudflare.com\/report\/v3?s=LBMz6312qGsci449QTTPAovyERiSc41lBFeKQ1LFtBZumf%2BC0arsOUUtrr9CfmR7HlyoyVGovfnAdhLs0sRPzknWfJZ5jmgCDE0TurnBE2fLWyRPAqr7IQpcv7NRKxDISJnx2hh7pKwwPDvCaT07Q2SX"}],"group":"cf-nel","max_age":604800}
NEL
{"success_fraction":0,"report_to":"cf-nel","max_age":604800}
Server
cloudflare
CF-RAY
80aad05d6c48b784-AMS
Content-Encoding
br
alt-svc
h3=":443"; ma=86400