将代码从 REST API v3.1 迁移到 v3.2

语音转文本 REST API 用于批量听录和自定义语音识别。 本文介绍版本 3.1 到 3.2 的更改内容。

基础路径

必须在代码中将基础路径从 /speechtotext/v3.1 更新为 /speechtotext/v3.2-preview.1。 例如，若要获取 chinanorth2 区域中的基础模型，请使用 https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.2-preview.1/models/base 而非 https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/models/base。

有关详细信息，请参阅本指南后面的操作 ID。

批量听录

后向兼容性限制

请勿使用语音转文本 REST API v3.0 或 v3.1 检索通过语音转文本 REST API v3.2 创建的听录。 你可能会看到如下错误消息：“此 API 版本不能用于访问此听录。 请使用 API v3.2 或更高版本。”

语言识别模型

LanguageIdentificationMode 作为 candidateLocales 和 speechModelMapping 的同级添加到 LanguageIdentificationProperties。 可用于语言识别的模型为 Continuous 或 Single。 连续语言识别是默认值。 有关详细信息，请参阅语言识别。

自定义语音

自定义显示文本格式设置

为支持使用自定义显示文本格式数据进行模型适应，Datasets_Create 操作支持 OutputFormatting 数据类型。 有关详细信息，请参阅上传数据集。

为具有 Lexical 和 Display 枚举值的 OutputFormatType 添加了定义。

"OutputFormatType": {
    "title": "OutputFormatType",
    "enum": [
        "Lexical",
        "Display"
    ],
    "type": "string",
    "x-ms-enum": {
        "name": "OutputFormatType",
        "modelAsString": true,
        "values": [
            {
                "value": "Lexical",
                "description": "Model provides the transcription output without formatting."
            },
            {
                "value": "Display",
                "description": "Model supports display formatting transcriptions output or endpoints."
            }
        ]
    }
},

OutputFormattingData 枚举值将添加到 FileKind（输入数据类型）。

supportedOutputFormat 属性已添加到 BaseModelFeatures。 此属性在 BaseModel 定义范围内。

"BaseModelFeatures": {
    "title": "BaseModelFeatures",
    "description": "Features supported by the model.",
    "type": "object",
    "allOf": [
        {
            "$ref": "#/definitions/SharedModelFeatures"
        }
    ],
    "properties": {
        "supportsAdaptationsWith": {
            "description": "Supported dataset kinds to adapt the model.",
            "type": "array",
            "items": {
                "$ref": "#/definitions/DatasetKind"
            },
            "readOnly": true
        },
        "supportedOutputFormat": {
            "description": "Supported output formats.",
            "type": "array",
            "items": {
                "$ref": "#/definitions/OutputFormatType"
            },
            "readOnly": true
        }
    }
},

调整费用

chargeForAdaptation 属性已添加到 BaseModelProperties。 此属性在 BaseModel 定义范围内。

如果 chargeForAdaptation 的值为 true，则需为训练模型付费。 如果值为 false，则需为训练模型付费。 使用 chargeForAdaptation 属性而不是创建日期以编程方式确定是否需要为模型训练付费。

"BaseModelProperties": {
    "title": "BaseModelProperties",
    "type": "object",
    "properties": {
        "deprecationDates": {
            "$ref": "#/definitions/BaseModelDeprecationDates"
        },
        "features": {
            "$ref": "#/definitions/BaseModelFeatures"
        },
        "chargeForAdaptation": {
            "description": "A value indicating whether model adaptation is charged.",
            "type": "boolean",
            "readOnly": true
        }
    }
},

文本规范化

textNormalizationKind 属性已添加到 DatasetProperties。

TextNormalizationKind 的实体定义：文本规范化的类型。

• 默认值：默认文本规范化（例如，在 en-US 中，将“2 to 3”替换为“two to three”）。
• 无：未对输入文本应用文本规范化。 此值是一个替代选项，仅在上传前对文本进行规范化时才使用。

评估属性

已向 EvaluationProperties 属性添加令牌计数和标记错误属性：

• correctTokenCount1：model1 正确识别的标记数。
• tokenCount1：model1 处理的标记数。
• tokenDeletionCount1：model1 识别出的删除标记数。
• tokenErrorRate1：使用 model1 进行识别的标记错误率。
• tokenInsertionCount1：model1 识别出的插入标记数。
• tokenSubstitutionCount1：model1 识别出的替代标记数。
• correctTokenCount2：model2 正确识别的标记数。
• tokenCount2：model2 处理的标记数。
• tokenDeletionCount2：model2 识别出的删除标记数。
• tokenErrorRate2：使用 model2 进行识别的标记错误率。
• tokenInsertionCount2：model2 识别出的插入标记数。
• tokenSubstitutionCount2：model2 识别出的替代标记数。

操作 ID

必须在代码中将基础路径从 /speechtotext/v3.1 更新为 /speechtotext/v3.2-preview.1。 例如，若要获取 chinanorth2 区域中的基础模型，请使用 https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.2-preview.1/models/base 而非 https://chinanorth2.api.cognitive.azure.cn/speechtotext/v3.1/models/base。

后续步骤

• 语音转文本 REST API
• 语音转文本 REST API v3.2（预览版）
• 语音转文本 REST API v3.1 参考
• 语音转文本 REST API v3.0 参考