你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

TextIndependent(Verification) - Verify Profile

验证配置文件
针对输入音频验证现有配置文件。

的限制:

  • 最小音频输入长度为 1 秒
  • 最大音频输入长度为 120 秒
  • 最小有效语音长度 (不包括静音和其他“非语音”帧) 为 4 秒 ,可以通过将“ignoreMinLength”设置为 true 来禁用此限制。
  • 信噪比 (信噪比) 为 2dB
POST {endpoint}/speaker-recognition/verification/text-independent/profiles/{profileId}:verify?api-version=2021-09-05
POST {endpoint}/speaker-recognition/verification/text-independent/profiles/{profileId}:verify?api-version=2021-09-05&ignoreMinLength={ignoreMinLength}

URI 参数

名称 必需 类型 说明
endpoint
path True

string

支持的认知服务终结点 (协议和主机名,例如: https://westus.api.cognitive.microsoft.com) 。

profileId
path True

string

uuid

配置文件 ID (guid) 的唯一标识符。

api-version
query True

string

指定用于此请求的操作的版本。

ignoreMinLength
query

boolean

如果为 true,则无论提供或存储多少语音,都将立即为此配置文件创建语音打印。 默认值为 false。

请求头

Media Types: "audio/wav; codecs=audio/pcm"

名称 必需 类型 说明
Ocp-Apim-Subscription-Key True

string

请求正文

Media Types: "audio/wav; codecs=audio/pcm"

名称 类型 说明
audioData

object

二进制音频文件。 支持的格式为音频/wav;codecs=audio/pcm。 支持高达 5MB 的音频。

响应

名称 类型 说明
200 OK

RecognitionInfo

确定

Other Status Codes

SpeakerErrorInfo

失败

标头

x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

类型: apiKey
在: header

示例

Successful Query

示例请求

POST https://westus.api.cognitive.microsoft.com/speaker-recognition/verification/text-independent/profiles/49a36324-fc4b-4387-aa06-090cfbf0064f:verify?api-version=2021-09-05


"{binary file date}"

示例响应

Content-Type: application/json
{
  "recognitionResult": "accept",
  "score": 0.63
}
Content-Type: application/json
x-ms-error-code: Error Code
{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

定义

名称 说明
Error
RecognitionInfo

说话人识别结果

ResultType

音频是否属于目标配置文件?

SpeakerErrorInfo

扬声器错误消息

Error

名称 类型 说明
code

string

message

string

RecognitionInfo

说话人识别结果

名称 类型 说明
recognitionResult

ResultType

音频是否属于目标配置文件?

score

number

一个浮点数,指示输入音频与目标语音打印之间的相似性。 此数字必须介于 0 和 1 之间。 数字越大,相似性越高。

ResultType

音频是否属于目标配置文件?

名称 类型 说明
accept

string

reject

string

SpeakerErrorInfo

扬声器错误消息

名称 类型 说明
error

Error