口语发音评测

更新于 2026-09-04

对蒙古语朗读语音进行发音质量评测，返回多维度评分与逐词反馈。

能力与场景

口语发音评测对照指定文本对朗读语音打分，返回准确度、流利度、完整度等维度得分与单词级反馈。典型场景：语言学习 App 跟读打分、口语作业自动批改、播音训练辅助。

端点列表

方法	路径	说明
POST	`/v1/soe`	提交朗读文本与语音，返回评测结果

每个端点的请求参数、响应结构与可运行代码示例见本页下方「API 参考」（随接口定义自动生成，始终与线上一致）。

调用要点

请同时提交参考文本与朗读音频；音频建议 16kHz 单声道、时长上限以 API 参考为准。
评分维度与分制（如百分制）以 API 参考的响应结构为准，可按业务需要设定及格线。
按评测次数计费，一次提交计一次。

支持语种

传统蒙古文与西里尔蒙古文均支持，由 mode 指定参考文本的书写系统与发音标准。
参考文本请与所选书写系统一致：mw 传传统蒙古文，xle_mw 传西里尔蒙古文。

书写系统（参数 mode）：

代码	语种	说明
`mw`	传统蒙古文	内蒙古通用书写与发音标准
`xle_mw`	西里尔蒙古文	蒙古国喀尔喀标准

完整代码表与各产品对照见「语种与语言代码」。

计费

计费单位：次
每月免费额度于月初重置，优先于余额抵扣；超出部分按单价从智能云余额扣费。
仅对成功的调用计费；失败调用不扣费。
实时单价与免费额度见本页下方「当前价格」（后台调价即时生效），总规则见「计费与免费额度」。

当前价格

以下为实时生效价，与定价页同源；调价后此处立即同步。仅对成功调用计费，免费额度优先抵扣。

计费单位	单价	每月免费额度
按次计费	¥0.15 / 次	20 次 / 月

API 参考

本产品共 1 个接口，以下内容随接口定义自动生成。需要跨产品查找接口时可前往接口索引。

口语发音评测

POST/v1/soe/evaluate

对照参考文本评测蒙古语跟读发音。支持任意参考文本（≤500 字符）；音频须为 WAV 封装 16kHz 16bit 单声道 PCM（base64，时长 ≤60 秒、解码后 ≤2MB）。返回经跨语言校准的综合分、发音准确度、流利度与逐词得分。

请求参数application/json

参数	类型	说明
`refText`必填	string	参考文本（跟读目标，≤500 字符）：mode=mw 传传统蒙古文，mode=xle_mw 传西里尔蒙古文示例：`ᠰᠠᠶᠢᠨ ᠪᠠᠶᠢᠨ᠎ᠠ ᠤᠤ`
`audio`必填	string	录音音频 base64（WAV 封装 16kHz 16bit 单声道 PCM，时长 ≤60 秒、解码后 ≤2MB；可带 data: 前缀）示例：`UklGRiQAAABXQVZFZm10IBAAAAABAAEA...`
`mode`必填	string	书写系统：mw=传统蒙古文（内蒙古标准）/ xle_mw=西里尔蒙古文（喀尔喀标准），与全站语言代码一致可选值：`mwxle_mw` 示例：`mw`

响应示例200 · application/json

200 响应

{
  "overallScore": 82,
  "pronunciationScore": 79,
  "fluencyScore": 88,
  "integrityScore": 100,
  "words": [
    {
      "word": "sain",
      "score": 86
    }
  ],
  "rawProvider": {
    "suggestedScore": 61.2,
    "pronAccuracy": 58.4,
    "pronFluency": 88.1,
    "pronCompletion": 100
  }
}

代码示例

curl -X POST "https://cloud.heimori.cn/v1/soe/evaluate" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
  "refText": "ᠰᠠᠶᠢᠨ ᠪᠠᠶᠢᠨ᠎ᠠ ᠤᠤ",
  "audio": "UklGRiQAAABXQVZFZm10IBAAAAABAAEA...",
  "mode": "mw"
}'