调用API提交口语评价任务后查询结果-智能科教内容生成平台-阿里云

警告

口语评价目前仅针对白名单客户开放。非白名单客户调用无效

接口用于查询基于大语言模型对用户口语评测录音生成的评价结果。通过提供应用标识（app_id）、录音记录标识（record_id）、用户标识（user_id）以及授权凭证（warrant_id），系统可返回与该次口语评测对应的评语。

提交评价任务

请求类型：POST

格式: form-data

1.1 请求地址

https://aiservice.ssapi.cn/api/v1/oralEvaluation/classTaskSubmit

1.2 请求体

名称	类型	是否必需	描述
app_id	string	是	应用ID
user_id	string	是	用户ID
warrant_id	string	是	权限凭证ID
record_ids	list<string>	是	record id list

curl -X POST 'https://aiservice.ssapi.cn/api/v1/oralEvaluation/classTaskSubmit' \
--form 'app_id="YOUR_APP_ID"' \
--form 'user_id="YOUR_USER_ID"' \
--form 'warrant_id="YOUR_WARRANT_ID"' \
--form 'record_ids="[\"record_id_1\",\"record_id_2\"]"'

1.3 返回值

名称	类型	示例	描述
success	boolean	true	请求是否成功
err_code	string	PARAMETER_ERROR_PARAM	错误code
err_message	string	参数非法	错误信息
data	Object
-task_id	string	TASK_20231012_ABCD1234	任务返回id

{
  "success": true,
  "data": {
    "task_id": "TASK_20231012_ABCD1234"
  }
}

{
  "success": false,
  "err_code": "PARAMETER_ERROR_PARAM",
  "err_message": "请求参数中部分必传参数丢失"
}

查询评价结果

请求类型：POST

格式: form-data

2.1 请求地址

https://aiservice.ssapi.cn/api/v1/oralEvaluation/classTaskQuery

1.2 请求体

名称	类型	是否必须	描述
app_id	string	是	应用ID
user_id	string	是	用户ID
warrant_id	string	是	权限凭证ID
task_id	string	是	任务id

curl -X POST "https://aiservice.ssapi.cn/api/v1/oralEvaluation/classTaskQuery" \
     -F "app_id=your_app_id" \
     -F "user_id=your_user_id" \
     -F "warrant_id=your_warrant_id" \
     -F "task_id=task1"

1.3 返回值

名称	类型	示例	描述
success	boolean	true	请求是否成功
err_code	string	PARAMETER_ERROR_PARAM	错误code
err_message	string	参数非法	错误信息
data	Object
- process_type	string	finish	process 处理中 finish 完成
- evaluation	Object
- - pronunciation_evaluation	string		发音评价
- - improvement_suggestions	string		改进建议
- - fluency_evaluation	string		流利度评价
- - integrity_evaluation	string		完整度评价
- - audio_quality_evaluation	string		音频质量评价
- - overall_evaluation	string		总体评价

{
    "success": true,
    "data": {
        "process_type": "finish",
        "evaluation": {
            "pronunciation_evaluation": "整体发音非常准确，多数单词和音素得分接近满分",
            "improvement_suggestions": "注意保持音量稳定",
            "fluency_evaluation": "朗读总体流畅，段落题中偶有停顿",
            "integrity_evaluation": "所有题目均完整朗读，无遗漏单词",
            "audio_quality_evaluation": "大部分录音的音频质量正常，但有一题音量偏低",
            "overall_evaluation": "整体表现优秀，多题接近满分"
        }
    }
}

{
  "success": false,
  "err_code": "PARAMETER_ERROR_PARAM",
  "err_message": "请求参数中部分必传参数丢失"
}