Speech Evaluation

Speech Evaluation API

• Use this api to evaluate the speech of student

Path: /api/v1/exercises/speech/evaluate/

Method: POST

Request Data

{
    “student_answer”: <audio>, // audio recorded by student
    “correct_text”: <string>, // correct audio text which you got when created the speech exercises
}

Response Data

{
    "id": <ID>,
    "speech_evaluation_status_url": "/api/v1/exercises/speech/evaluate/<evaluation_id>/status/",
    "status": “pending”,
    "error": <None>,
    "data": <None>
}

Example

Request Data

{
    “student_answer”: <audio_data>, // audio recorded by student
    “correct_text”: <string>, correct audio text which you got when created the speech exercises
}

Response Data

{
    "id": 1,
    "speech_evaluation_status_url": "/api/v1/exercises/speech/evaluate/<evaluation_id>/status/",
    "status": “pending”,
    "error": <None>,
    "data": <None>
}

Check the status of the speech evaluation

Path: /api/v1/exercises/speech/evaluate/<evaluation_id>/status/

Method: GET

Request Data

{}

Response Data

{
  "reading_score": <number>,
  "feedback": {
    "message": <string>,
    "correct_words": <list_of_words>,
    "wrong_words": <list_of_words>
  },
}

Example

Request Data

{}

Response Data

{  
  "reading_score": 95,
  "feedback": {
    "message": "Perfect! Keep going.",
    "correct_words": ["wind", "blowing"],
    "wrong_words": []
  }
}