{
  "name": "soe",
  "display_name": "智聆口语评测",
  "description": "介绍如何使用API对智聆口语评测进行操作，包括发音数据传输、发音评估初始化等。",
  "domain": "other",
  "api_version": "2018-07-24",
  "endpoint": "soe.tencentcloudapi.com",
  "actions": [
    {
      "name": "InitOralProcess",
      "description": "初始化发音评估过程，每一轮评估前进行调用。语音输入模式分为流式模式和非流式模式，流式模式支持数据分片传输，可以加快评估响应速度。评估模式分为词模式和句子模式，词模式会标注每个音节的详细信息；句子模式会有完整度和流利度的评估。",
      "status": "online",
      "parameters": [
        {
          "name": "SessionId",
          "type": "string",
          "required": true,
          "description": "语音段唯一标识，一段完整语音使用一个SessionId，不同语音段的评测需要使用不同的SessionId。一般使用uuid(通用唯一识别码)来作为它的值，要尽量保证SessionId的唯一性。",
          "example": "stress_test_956938"
        },
        {
          "name": "RefText",
          "type": "string",
          "required": true,
          "description": "被评估语音对应的文本，仅支持中文和英文。 句子模式下不超过个 30 单词或者中文文字，段落模式不超过 120 单词或者中文文字，中文评估使用 utf-8 编码，自由说模式RefText可以不填。 关于RefText的文本键入要求，请参考[评测模式介绍](https://cloud.tencent.com/document/product/884/56131)。 如需要在评测模式下使用自定义注音（支持中英文），可以通过设置「TextMode」参数实现，设置方式\ufffd...",
          "example": "again"
        },
        {
          "name": "WorkMode",
          "type": "integer",
          "required": true,
          "description": "语音输入模式 0：流式分片 1：非流式一次性评估 推荐使用流式分片传输。",
          "example": "0"
        },
        {
          "name": "EvalMode",
          "type": "integer",
          "required": true,
          "description": "评测模式 0：单词/单字模式（中文评测模式下为单字模式） 1：句子模式 2：段落模式 3：自由说模式 4：单词音素纠错模式 5：情景评测模式 6：句子多分支评测模式 7：单词实时评测模式 8：拼音评测模式 关于每种评测模式的详细介绍，以及适用场景，请参考[评测模式介绍](https://cloud.tencent.com/document/product/884/56131)。",
          "example": "0"
        },
        {
          "name": "ScoreCoeff",
          "type": "float",
          "required": true,
          "description": "评价苛刻指数。取值为[1.0 - 4.0]范围内的浮点数，用于平滑不同年龄段的分数。 1.0：适用于最小年龄段用户，一般对应儿童应用场景； 4.0：适用于最高年龄段用户，一般对应成人严格打分场景。苛刻度影响范围参考：[苛刻度影响范围](https://cloud.tencent.com/document/product/884/78824#.E8.8B.9B.E5.88.BB.E5.BA.A6)",
          "example": "3.5"
        },
        {
          "name": "SoeAppId",
          "type": "string",
          "required": false,
          "description": "业务应用ID，与账号应用APPID无关，是用来方便客户管理服务的参数，新的 SoeAppId 可以在[控制台](https://console.cloud.tencent.com/soe)【应用管理】下新建。如果没有新建SoeAppId，请勿填入该参数，否则会报欠费错误。使用指南：[业务应用](https://cloud.tencent.com/document/product/884/78824#.E4.B8.9A.E5.8A.A1.E5.BA.94.E7.94.A8)",
          "example": "无"
        },
        {
          "name": "IsLongLifeSession",
          "type": "integer",
          "required": false,
          "description": "长效session标识，当该参数为1时，session的持续时间为300s，但会一定程度上影响第一个数据包的返回速度，且TransmitOralProcess必须同时为1才可生效。",
          "example": "无"
        },
        {
          "name": "StorageMode",
          "type": "integer",
          "required": false,
          "description": "音频存储模式，此参数已废弃，无需设置，设置与否都默认为0不存储； 注：有存储需求的用户建议自行存储至腾讯云COS[对象存储](https://cloud.tencent.com/product/cos)使用。",
          "example": "无"
        },
        {
          "name": "SentenceInfoEnabled",
          "type": "integer",
          "required": false,
          "description": "输出断句中间结果标识 0：不输出 1：输出，通过设置该参数 可以在评估过程中的分片传输请求中，返回已经评估断句的中间结果，中间结果可用于客户端 UI 更新，输出结果为TransmitOralProcess请求返回结果 SentenceInfoSet 字段。",
          "example": "无"
        },
        {
          "name": "ServerType",
          "type": "integer",
          "required": false,
          "description": "评估语言 0：英文（默认） 1：中文",
          "example": "无"
        },
        {
          "name": "IsAsync",
          "type": "integer",
          "required": false,
          "description": "异步模式标识 0：同步模式 1：异步模式（一般情况不建议使用异步模式） 可选值参考[服务模式](https://cloud.tencent.com/document/product/884/33697)。",
          "example": "无"
        },
        {
          "name": "TextMode",
          "type": "integer",
          "required": false,
          "description": "输入文本模式 0: 普通文本 1：[音素结构](https://cloud.tencent.com/document/product/884/33698)文本",
          "example": "无"
        },
        {
          "name": "Keyword",
          "type": "string",
          "required": false,
          "description": "主题词和关键词",
          "example": "keyword"
        }
      ],
      "required": [
        "SessionId",
        "RefText",
        "WorkMode",
        "EvalMode",
        "ScoreCoeff"
      ]
    },
    {
      "name": "KeywordEvaluate",
      "description": "指定主题关键词词汇评估，分析语音与关键词的切合程度，可指定多个关键词，支持中文英文同时评测。分片传输时，尽量保证纯异步调用，即不等待上一个分片的传输结果边录边传，这样可以尽可能早的提供音频数据。音频源目前仅支持16k采样率16bit单声道编码方式，如有不一致可能导致评估不准确或失败。",
      "status": "online",
      "parameters": [
        {
          "name": "SeqId",
          "type": "integer",
          "required": true,
          "description": "流式数据包的序号，从1开始，当IsEnd字段为1后后续序号无意义，非流式模式时无意义。 注意：序号上限为3000，不能超过上限。",
          "example": "1"
        },
        {
          "name": "IsEnd",
          "type": "integer",
          "required": true,
          "description": "是否传输完毕标志，若为0表示未完毕，若为1则传输完毕开始评估，非流式模式下无意义。",
          "example": "1"
        },
        {
          "name": "VoiceFileType",
          "type": "integer",
          "required": true,
          "description": "语音文件类型 1: raw/pcm 2: wav 3: mp3 4: speex [音频上传格式](https://cloud.tencent.com/document/product/884/56132)",
          "example": "3"
        },
        {
          "name": "VoiceEncodeType",
          "type": "integer",
          "required": true,
          "description": "语音编码类型 1:pcm",
          "example": "1"
        },
        {
          "name": "UserVoiceData",
          "type": "string",
          "required": true,
          "description": "当前语音数据, 编码格式要求为BASE64且必须保证分片帧完整（16bit的数据必须保证音频长度为偶数）。格式要求参考[音频上传格式](https://cloud.tencent.com/document/product/884/56132) 流式模式下需要将语音数据进行分片处理，参考：[分片大小设置](https://cloud.tencent.com/document/product/884/78985#.E5.88.86.E7.89.87.E5.A4.A7.E5.B0.8F.E8.AE.BE.E7.BD.AE.E4.B8.BA.E5.A4.9A.E5.A4.A7.E6.AF.94.E8.BE.83.E5.90.88.E9.80.82.3F) 如何进行...",
          "example": "SUQzBAAAAAAANFRDT04AAAAHAAADQmx1ZXMAVFNTRQAAAA8AAANMYXZmNTguMjMuMTAyAAAAAAAAAAAAAAD%2F81jAAAAAAAAAAAAASW5mbwAAAA8AAAASAAAITAAiIiIiIi8vLy8vLzw8PDw8SUlJSUlJVlZWVlZjY2NjY2NwcHBwcH19fX19fYqKioqKl5eXl5eXpKSkpKSksbGxsbG%2Bvr6%2Bvr7Ly8vLy9jY2NjY2OXl5eXl8vLy8vLy%2F%2F%2F%2F%2F%2F8AAAAATGF2YzU4LjQxAAAAAAAAAAAAAAAAJAOVAAAAAAAACEyULaIpAAAAAAAAAAAAAAD%2F8zjEABOylnQLRigAETO960QQJ6YQQPAYDTk8mTJ0YQIB9yBwCBwk5CEISd5zvIQjHDgoxzoQihwOEnOdyB8Pnf5CEb%2F%2FJ%2F%2Fkb%2F%2FQnIT%2F%2F%2FU4fOQPh84gcf%2F4fdgZFMFAgSI3tbm442AGGmn%2F8zjEEBkKUvpfi1AAfjskBZcKzUvSVbbkBJDYQQjiAjweEh5oMAAxlFw2k%2Bp54rlpkWD5QfurYURx1YQtGGn7mdM%2FVu3Rmq2QIhX7ZWx7%2F5Eex766IzR8OwyFiH5dn1HFKghCWjAD0l4f9zT%2F8zjEChdqDubXyzgA3lYDYbubfXyPI2D4dmug8D4iJZc9%2BYIwaBEHgPBor9R8YU890ucccaexjHjBqIc6aHHqb%2F%2F%2F%2F%2FsjrS1mImg2cCg1BlukfTFxC7PpC5FCF0fiWcCdCWNpdRAMYCcHqZf%2F8zjECxfpUu7%2BC9JQ7YQQxOR%2FiKEMUe%2F8q1hNE2EaKBQxc4SWEQlDQsCbSBBCTuqSolZZPPt2k1GqT2EbsZFLIkRIWmJpQqDAoCDv%2F%2FXtcHDDGBwHAIXU5FPmGNLVf%2BiOUgqkR5AiDr1Jh7X%2F8zjEChc4tvMWFhJoYfXUNMqB1gdU4pPwIZnrP%2F8mYkJKNHVmM3yXQoSVDEkDMWPMUFXJOsEoLFTr1VAYgA1fSthFzQ28abcksWuOkSyg6C3T2tzJkkKEEk6ov3B9BBMDoBg1EgT8ootC24j%2F8zjEDBb62tI6FgpoO5GE3EBgQmkw%2FnMdCMQQDBEPGNstEOdTnssPdbMz5GHyiIt%2F91KWkPHrVXra7LGO1GOdVOlWHOSHj7%2Fpt3%2F%2FbOrO7pd5%2BQ4xxEh5r%2BoRIDoFhAAZ3YAEH%2F%2FNbiyCRBn%2F8zjEDxWystLcwkSoLYJUnMaxF7LRRVWrMAgQElk6CbkRETWhQsuYrHuoyO9Jiy3naZB9Stfr%2F%2F%2F%2F6p2eh7osy0u5m6Svo1%2F%2F7%2Bj0qavNQdVA7UuiGxAMkt2ZuyUSEUFGaDj8M8WuGo1X4IL%2F8zjEFxMQpupcBowKRR5FI6kt9afbPm38SfPJrAKBHikFpXloKkIsWYM%2FrPf6h7cAAuOGA4tNVeydJCsVHlv%2F%2FedqLkssZVj%2F4yVQtUemsMYhKaZhU2gdEzWb7LfwLDzWJbhnMD46pRpWrnX%2F8zjEKRUKBrh8egSarpKOqT66Fa6S9DbaJ2Qxj%2F%2FZL0VSspQrWVAJ4sLg6Iv7dyyICEv%2F%2BmJBZVUufh4SdxCqFKEJQMJ%2BsEqaXtrbx4WzXlB%2F%2BXX%2FmHNikKupO1hAKmGRGFEaELvR15TSsYz%2F8zjEMxRCimwQeETdreatS1Zyq39ktUtf0cBxymbx%2F%2FO1uX63eKCeBMIFArlLCwIjqBWHSamMJzj5FFxgaNAeKxQqKX0Mn%2F7P2KGxYdzo1IbVIixgYLAyeUaBk5PJUZbson4URTW24h0%2FSgf%2F8zjEQQ%2FoRlwUS8wA%2FglgBwOUTVxujFPq2x72dRxP%2FX0L0t2%2F%2Fb9Le36McQdCK4U7PBlrQGCQ7koxmDjEKZUZWOcimEnIHM7OymihAJljbgm4zUpugWnetpkMhEO7Eb9FucQBM2PECMOt0CX%2F8zjEYBS6PmQVSxAARGA%2BfNEEC0UBchAQ935fc3LjCOC2JEQ0q%2Flw6VyDnDQwFAiEw6iBCb%2F5OGknSuXECJkIToYFAoAN%2FGd%2F5DCIDQIOolycL7idg2UDzwGmEoBFAhEOQELf%2FlMnx3lxjRb%2F8zjEbCb7zowBipAA98NlDbgbiFhIuRcdh9MuE%2BXv%2F%2FoLdO3vcuGZPloyNC8alQvlwumyRS%2F%2F%2F1f%2F%2FzU6B4d3%2B222ku2H%2Fw1qUtolGx5YxBokEwPjG02NhBZBMqZBhqRqmnCqFa1MJiNRAAj%2F8zjELxRwdxL%2FyxACaDh92VacCiWgbq3G71JGf%2BUIpjHUJCJmLNDJNzhAa0tjGk4AhiEN21AFmCjjKLLxjmPBALF5Egr2PkYAFBZqG4%2BCFGqGM9i7X%2F2Xhr%2B2xkcnpdFRR7I0aWhqZ2Q%2FwYD%2F8zjEPBSRwr78AYYwgZQkyJMu7X5XZXcQljwcK%2B%2F%2BSKuABOoCVhWb2EHuNarNrHOLkiSscbiJVXtQ5rEialjXoGiym5fnkCY%2BH5KSOUOr7atkZnV2WhRJGv59X81%2F4bTh%2FxqEFHcWL1qesrb%2F8zjESBXx%2BqpcAYY8VoLRMoNSwUHD%2F6nvVh1QVnUBvHPzELNOiKAIKRYeq%2FKwzFC1rcX%2F%2F%2BzMxQdGx8X8KsNw3xryKmqKyKitNsHQAw61VeVWSRU2v%2BGa59a1FQkHXxEJQaDhENCWR9TxKJb%2F8zjETxdh4nQ0CZCEDR6HKzqwaPYbqeWgrDTaxYeCA4Cwfy3%2FllqGTWX8jVrLZ%2BXZPvyyX%2FlkuZGstQyNQwUMGBhHFRUUFuoka%2F6hf2oHs%2FxYXZLCwr%2F%2BukxBTUUzLjEwMKqqqqqqqqqqqqr%2F8zjEUA8hVcGWCAYAqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqo%3D"
        },
        {
          "name": "SessionId",
          "type": "string",
          "required": true,
          "description": "语音段唯一标识，一段完整语音使用一个SessionId，不同语音段的评测需要使用不同的SessionId。一般使用uuid(通用唯一识别码)来作为它的值，要尽量保证SessionId的唯一性。",
          "example": "12345"
        },
        {
          "name": "Keywords",
          "type": "array",
          "required": true,
          "description": "关键词列表",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "RefText",
              "type": "string",
              "required": true,
              "description": "被评估语音对应的文本，句子模式下不超过 20个单词或者中文文字，段落模式不超过 120个单词或者中文文字，中文文字需使用 utf-8 编码，自由说模式RefText可以不填。如需要在单词模式和句子模式下使用自定义音素，可以通过设置 TextMode 使用[音素标注](https://cloud.tencent.com/document/product/884/33698)。",
              "example": "hello"
            },
            {
              "name": "EvalMode",
              "type": "integer",
              "required": true,
              "description": "评估模式，0：词模式（中文评测模式下为文字模式），1：句子模式，2：段落模式，3：自由说模式，当为词模式评估时，能够提供每个音节的评估信息，当为句子模式时，能够提供完整度和流利度信息。",
              "example": "Null"
            },
            {
              "name": "ScoreCoeff",
              "type": "float",
              "required": true,
              "description": "评价苛刻指数，取值为[1.0 - 4.0]范围内的浮点数，用于平滑不同年龄段的分数，1.0为小年龄段，4.0为最高年龄段",
              "example": "1"
            },
            {
              "name": "ServerType",
              "type": "integer",
              "required": false,
              "description": "评估语言，0：英文，1：中文。 ServerType不填默认为0",
              "example": "0"
            },
            {
              "name": "TextMode",
              "type": "integer",
              "required": false,
              "description": "输入文本模式，0: 普通文本，1：[音素结构](https://cloud.tencent.com/document/product/884/33698)文本。",
              "example": "0"
            }
          ]
        },
        {
          "name": "SoeAppId",
          "type": "string",
          "required": false,
          "description": "业务应用ID，与账号应用APPID无关，是用来方便客户管理服务的参数，新的 SoeAppId 可以在[控制台](https://console.cloud.tencent.com/soe)【应用管理】下新建。如果没有新建SoeAppId，请勿填入该参数，否则会报欠费错误。使用指南：[业务应用](https://cloud.tencent.com/document/product/884/78824#.E4.B8.9A.E5.8A.A1.E5.BA.94.E7.94.A8)",
          "example": "default"
        },
        {
          "name": "IsQuery",
          "type": "integer",
          "required": false,
          "description": "查询标识，当该参数为1时，该请求为查询请求，请求返回该 Session 评估结果。",
          "example": "无"
        }
      ],
      "required": [
        "SeqId",
        "IsEnd",
        "VoiceFileType",
        "VoiceEncodeType",
        "UserVoiceData",
        "SessionId",
        "Keywords"
      ]
    },
    {
      "name": "TransmitOralProcess",
      "description": "本接口可用于中英文发音评测数据传输。在使用本接口时需要注意：传输音频数据，必须在完成发音评估初始化接口之后调用，且SessonId要与初始化接口保持一致。分片传输时，尽量保证SeqId顺序传输（请确认SeqId由1开始）。音频源目前仅支持16k采样率16bit单声道编码方式，如有不一致可能导致评估不准确或失败。",
      "status": "online",
      "parameters": [
        {
          "name": "SeqId",
          "type": "integer",
          "required": true,
          "description": "流式数据包的序号，从1开始，当IsEnd字段为1后后续序号无意义，当IsLongLifeSession不为1且为非流式模式时无意义。 注意：序号上限为3000，不能超过上限。",
          "example": "1"
        },
        {
          "name": "IsEnd",
          "type": "integer",
          "required": true,
          "description": "是否传输完毕标志，若为0表示未完毕，若为1则传输完毕开始评估，非流式模式下无意义。",
          "example": "0"
        },
        {
          "name": "VoiceFileType",
          "type": "integer",
          "required": true,
          "description": "1: raw/pcm 2: wav 3: mp3 4: speex [音频上传格式](https://cloud.tencent.com/document/product/884/56132)",
          "example": "1"
        },
        {
          "name": "VoiceEncodeType",
          "type": "integer",
          "required": true,
          "description": "语音编码类型 1:pcm",
          "example": "1"
        },
        {
          "name": "UserVoiceData",
          "type": "string",
          "required": true,
          "description": "当前语音数据, 编码格式要求为BASE64且必须保证分片帧完整（16bit的数据必须保证音频长度为偶数）。格式要求参考[音频上传格式](https://cloud.tencent.com/document/product/884/56132) 流式模式下需要将语音数据进行分片处理，参考：[分片大小设置](https://cloud.tencent.com/document/product/884/78985#.E5.88.86.E7.89.87.E5.A4.A7.E5.B0.8F.E8.AE.BE.E7.BD.AE.E4.B8.BA.E5.A4.9A.E5.A4.A7.E6.AF.94.E8.BE.83.E5.90.88.E9.80.82.3F) 如何进行...",
          "example": "VWtsR1JxeUpBd0JYUVZaRlptMTBJQkFBQUFBQkFBRUFnRDRBQUFCOUFBQUNBQkFBVEVsVFZCb0FBQUJKVGtaUFNWTkdWQTRBQUFCTVlYWm1OVFl1TVRrdU1UQXdBR1JoZEdGbWlRTUF5"
        },
        {
          "name": "SessionId",
          "type": "string",
          "required": true,
          "description": "语音段唯一标识，一段完整语音使用一个SessionId，不同语音段的评测需要使用不同的SessionId。 一般使用uuid(通用唯一识别码)来作为它的值，要尽量保证SessionId的唯一性。",
          "example": "test-6ef67f85-830e-4075-87a2-0ffda1843607"
        },
        {
          "name": "SoeAppId",
          "type": "string",
          "required": false,
          "description": "业务应用ID，与账号应用APPID无关，是用来方便客户管理服务的参数，新的 SoeAppId 可以在[控制台](https://console.cloud.tencent.com/soe)【应用管理】下新建。如果没有新建SoeAppId，请勿填入该参数，否则会报欠费错误。使用指南：[业务应用](https://cloud.tencent.com/document/product/884/78824#.E4.B8.9A.E5.8A.A1.E5.BA.94.E7.94.A8)",
          "example": "soe_100xxxxx"
        },
        {
          "name": "IsLongLifeSession",
          "type": "integer",
          "required": false,
          "description": "长效session标识，当该参数为1时，session的持续时间为300s，但会一定程度上影响第一个数据包的返回速度。当InitOralProcess接口和TransmitOralProcess接口的IsLongLifeSession均为1时，才可生效。",
          "example": "0"
        },
        {
          "name": "IsQuery",
          "type": "integer",
          "required": false,
          "description": "查询标识，当该参数为1时，该请求为查询请求，请求返回该 Session 的评估结果。",
          "example": "0"
        }
      ],
      "required": [
        "SeqId",
        "IsEnd",
        "VoiceFileType",
        "VoiceEncodeType",
        "UserVoiceData",
        "SessionId"
      ]
    },
    {
      "name": "TransmitOralProcessWithInit",
      "description": "本接口可用于中英文发音评测。在使用本接口时需要注意：初始化并传输音频数据，分片传输时，尽量保证SeqId顺序传输（请确认SeqId由1开始）。音频源目前仅支持16k采样率16bit单声道编码方式，如有不一致可能导致评估不准确或失败。",
      "status": "online",
      "parameters": [
        {
          "name": "SeqId",
          "type": "integer",
          "required": true,
          "description": "流式数据包的序号，从1开始，当IsEnd字段为1后后续序号无意义，当IsLongLifeSession不为1且为非流式模式时无意义。 注意：序号上限为3000，不能超过上限。",
          "example": "1"
        },
        {
          "name": "IsEnd",
          "type": "integer",
          "required": true,
          "description": "是否传输完毕标志，若为0表示未完毕，若为1则传输完毕开始评估，非流式模式下无意义。",
          "example": "0"
        },
        {
          "name": "VoiceFileType",
          "type": "integer",
          "required": true,
          "description": "语音文件类型 1: raw/pcm 2: wav 3: mp3 4: speex 语音文件格式目前仅支持 16k 采样率 16bit 编码单声道，如有不一致可能导致评估不准确或失败。 [音频上传格式](https://cloud.tencent.com/document/product/884/56132)",
          "example": "1"
        },
        {
          "name": "VoiceEncodeType",
          "type": "integer",
          "required": true,
          "description": "语音编码类型 1:pcm",
          "example": "1"
        },
        {
          "name": "UserVoiceData",
          "type": "string",
          "required": true,
          "description": "当前语音数据, 编码格式要求为BASE64且必须保证分片帧完整（16bit的数据必须保证音频长度为偶数）。格式要求参考[音频上传格式](https://cloud.tencent.com/document/product/884/56132) 流式模式下需要将语音数据进行分片处理，参考：[分片大小设置](https://cloud.tencent.com/document/product/884/78985#.E5.88.86.E7.89.87.E5.A4.A7.E5.B0.8F.E8.AE.BE.E7.BD.AE.E4.B8.BA.E5.A4.9A.E5.A4.A7.E6.AF.94.E8.BE.83.E5.90.88.E9.80.82.3F) 如何进行...",
          "example": "LyoqKioqKiog5pu05paw5pe26Ze077yaMjAxOeW5tDEx5pyIMTjml6UyMzozMjow"
        },
        {
          "name": "SessionId",
          "type": "string",
          "required": true,
          "description": "语音段唯一标识，一段完整语音使用一个SessionId，不同语音段的评测需要使用不同的SessionId。一般使用uuid(通用唯一识别码)来作为它的值，要尽量保证SessionId的唯一性。",
          "example": "21eae5be-9e8d-11eb-a7c6-e454e8cfe4b4"
        },
        {
          "name": "RefText",
          "type": "string",
          "required": true,
          "description": "被评估语音对应的文本，仅支持中文和英文。 句子模式下不超过 30个 单词或者中文文字，段落模式不超过 120 个单词或者中文文字，中文评估使用 utf-8 编码，自由说模式RefText可以不填。 关于RefText的文本键入要求，请参考[评测模式介绍](https://cloud.tencent.com/document/product/884/56131)。 如需要在评测模式下使用自定义注音（支持中英文），可以通过设置「TextMode」参数实现，设置方\ufffd...",
          "example": "apple"
        },
        {
          "name": "WorkMode",
          "type": "integer",
          "required": true,
          "description": "语音输入模式 0：流式分片 1：非流式一次性评估 推荐使用流式分片传输。",
          "example": "0"
        },
        {
          "name": "EvalMode",
          "type": "integer",
          "required": true,
          "description": "评测模式 0：单词/单字模式（中文评测模式下为单字模式） 1：句子模式 2：段落模式 3：自由说模式 4：单词音素纠错模式 5：情景评测模式 6：句子多分支评测模式 7：单词实时评测模式 8：拼音评测模式 关于每种评测模式的详细介绍，以及适用场景，请参考[评测模式介绍](https://cloud.tencent.com/document/product/884/56131)。",
          "example": "1"
        },
        {
          "name": "ScoreCoeff",
          "type": "float",
          "required": true,
          "description": "评价苛刻指数。取值为[1.0 - 4.0]范围内的浮点数，用于平滑不同年龄段的分数。 1.0：适用于最小年龄段用户，一般对应儿童应用场景； 4.0：适用于最高年龄段用户，一般对应成人严格打分场景。 苛刻度影响范围参考：[苛刻度影响范围](https://cloud.tencent.com/document/product/884/78824#.E8.8B.9B.E5.88.BB.E5.BA.A6)",
          "example": "1.0"
        },
        {
          "name": "SoeAppId",
          "type": "string",
          "required": false,
          "description": "业务应用ID，与账号应用APPID无关，是用来方便客户管理服务的参数，新的 SoeAppId 可以在[控制台](https://console.cloud.tencent.com/soe)【应用管理】下新建。如果没有新建SoeAppId，请勿填入该参数，否则会报欠费错误。使用指南：[业务应用](https://cloud.tencent.com/document/product/884/78824#.E4.B8.9A.E5.8A.A1.E5.BA.94.E7.94.A8)",
          "example": "无"
        },
        {
          "name": "SentenceInfoEnabled",
          "type": "integer",
          "required": false,
          "description": "输出断句中间结果标识 0：不输出（默认） 1：输出，通过设置该参数 可以在评估过程中的分片传输请求中，返回已经评估断句的中间结果，中间结果可用于客户端 UI 更新，输出结果为TransmitOralProcessWithInit请求返回结果 SentenceInfoSet 字段。",
          "example": "无"
        },
        {
          "name": "ServerType",
          "type": "integer",
          "required": false,
          "description": "评估语言 0：英文（默认） 1：中文",
          "example": "无"
        },
        {
          "name": "IsAsync",
          "type": "integer",
          "required": false,
          "description": "异步模式标识 0：同步模式（默认） 1：异步模式（一般情况不建议使用异步模式，如需使用参考：[异步轮询](https://cloud.tencent.com/document/product/884/78824#.E7.BB.93.E6.9E.9C.E6.9F.A5.E8.AF.A2)） 可选值参考[服务模式](https://cloud.tencent.com/document/product/884/33697)。",
          "example": "无"
        },
        {
          "name": "IsQuery",
          "type": "integer",
          "required": false,
          "description": "查询标识，当该参数为1时，该请求为查询请求，请求返回该 Session 评估结果。",
          "example": "无"
        },
        {
          "name": "TextMode",
          "type": "integer",
          "required": false,
          "description": "输入文本模式 0: 普通文本（默认） 1：[音素结构](https://cloud.tencent.com/document/product/884/33698)文本",
          "example": "无"
        },
        {
          "name": "Keyword",
          "type": "string",
          "required": false,
          "description": "主题词和关键词",
          "example": "keyword"
        },
        {
          "name": "COSBucketURL",
          "type": "string",
          "required": false,
          "description": "音频存储模式，此参数已废弃，无需设置； 注：有存储需求的用户建议自行存储至腾讯云COS[对象存储](https://cloud.tencent.com/product/cos)使用。",
          "example": "https://test-appid.cos.ap-guangzhou.myqcloud.com/folder1/folder2"
        }
      ],
      "required": [
        "SeqId",
        "IsEnd",
        "VoiceFileType",
        "VoiceEncodeType",
        "UserVoiceData",
        "SessionId",
        "RefText",
        "WorkMode",
        "EvalMode",
        "ScoreCoeff"
      ]
    }
  ]
}