Text Dependent - Reset Profile

服务:

Azure AI Services

API 版本:

2021-09-05

重置配置文件
将现有配置文件重置为其原始创建状态。 重置操作会执行以下操作：

• 将 enrollmentStatus 更新为注册。
• 更新 lastUpdatedDateTime。
• 将 enrollmentsCount 更新为 0。
• 将 enrollmentsLength 更新为 0。
• 将 enrollmentsSpeechLength 更新为 0。
• 将 remainingEnrollmentsCount 更新为初始所需数字。
• 从存储中删除所有关联的注册。
• 删除所选的通行短语关联。
• 重置 modelVersion 的值。

POST {endpoint}/speaker-recognition/verification/text-dependent/profiles/{profileId}:reset?api-version=2021-09-05

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	支持的认知服务终结点（协议和主机名，例如：https://westus.api.cognitive.microsoft.com）。
profileId	path	True	string (uuid)	配置文件 ID 的唯一标识符（guid）。
api-version	query	True	string	指定要用于此请求的操作的版本。

请求头

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

响应

名称	类型	说明
200 OK	TdProfileInfo	扬声器配置文件已成功重置。 配置文件使用重置值返回。 标头 Location: string
Other Status Codes	SpeakerErrorInfo	失败 标头 x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

类型: apiKey
在: header

示例

Successful Query

示例请求

HTTP

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

示例响应

状态代码:

200

Content-Type: application/json

{
  "profileId": "49a36324-fc4b-4387-aa06-090cfbf0064f",
  "locale": "en-US",
  "enrollmentStatus": "Enrolling",
  "createdDateTime": "2015-04-23T18:25:43.41Z",
  "lastUpdatedDateTime": "2015-04-23T18:25:43.41Z",
  "enrollmentsCount": 0,
  "enrollmentsLengthInSec": 0,
  "enrollmentsSpeechLengthInSec": 0,
  "remainingEnrollmentsCount": 3,
  "modelVersion": "2019-12-05"
}

状态代码:

default

Content-Type: application/json
x-ms-error-code: Error Code

{
  "error": {
    "code": "Error Code",
    "message": "Erro Messae"
  }
}

定义

名称	说明
Error
SpeakerErrorInfo	说话人错误消息
TdProfileInfo	Text-Dependent 演讲者个人资料信息
TrainingStatusType	表示配置文件的当前状态的状态。 可用值为： 注册：配置文件没有语音打印，也没有准备好识别请求。 培训：正在创建配置文件的语音打印，目前不能用于识别。 已注册：配置文件具有语音打印，并已准备好进行识别请求。

Error

Object

名称	类型	说明
code	string
message	string

SpeakerErrorInfo

Object

说话人错误消息

名称	类型	说明
error	Error

TdProfileInfo

Object

Text-Dependent 演讲者个人资料信息

名称	类型	说明
createdDateTime	string (date-time)	配置文件创建日期/时间。
enrollmentStatus	TrainingStatusType	表示配置文件的当前状态的状态。 可用值为： 注册：配置文件没有语音打印，也没有准备好识别请求。 培训：正在创建配置文件的语音打印，目前不能用于识别。 已注册：配置文件具有语音打印，并已准备好进行识别请求。
enrollmentsCount	integer	此配置文件接受的注册音频数。
enrollmentsLengthInSec	number	此配置文件接受的注册音频的总长度（以秒为单位）。
enrollmentsSpeechLengthInSec	number	纯语音（在消除静音和非语音段后音频量）在所有配置文件注册（几秒钟内）的总和。
lastUpdatedDateTime	string (date-time)	上次更新配置文件的日期/时间。
locale	string pattern: ^[a-zA-Z]{2}-?[a-zA-Z]{2}$	语言标识符由语言代码和国家/地区代码的组合组成。
modelVersion	string (date)	指定分配给此配置文件的模型的日期。 格式为 yyyy-mm-dd。 如果配置文件没有注册，则此值将为空。
profileId	string (uuid)	配置文件 ID 的唯一标识符（guid）。
remainingEnrollmentsCount	integer	完成配置文件注册所需的注册音频数。

TrainingStatusType

枚举

表示配置文件的当前状态的状态。 可用值为：

• 注册：配置文件没有语音打印，也没有准备好识别请求。
• 培训：正在创建配置文件的语音打印，目前不能用于识别。
• 已注册：配置文件具有语音打印，并已准备好进行识别请求。

值	说明
Enrolling
Training
Enrolled