通过

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

Personal Voices - Post

  • 参考
服务:
Azure AI Services
API 版本:
2024-02-01-preview

在客户端中使用音频文件创建新的个人语音。

POST {endpoint}/customvoice/personalvoices/{id}?api-version=2024-02-01-preview

URI 参数

名称 在 必需 类型 说明
projectId
 formData True

string

项目 ID。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
audioData
 formData

file

音频文件。
description
 formData

string

此模型的可选说明。
displayName
 formData

string

此模型的显示名称。
properties
 formData

string

属性。
endpoint
 path True

string

支持的认知服务终结点 (协议和主机名，例如： https://eastus.api.cognitive.microsoft.com) 。
id
 path True

string

资源的 ID。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version
 query True

string

要用于此操作的 API 版本。

请求头

Media Types: "multipart/form-data"

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

string

在此处提供语音资源密钥。
Operation-Id

string

操作的状态监视器的 ID。 如果 Operation-Id 标头与现有操作匹配，并且请求与以前的请求不同，则失败并显示 400 错误请求。

正则表达式模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

响应

名称 类型 说明
201 Created

PersonalVoice

创建

标头

  • Operation-Id: string
  • Operation-Location: string
Other Status Codes

ErrorResponse

出现了错误。

标头

x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

在此处提供语音资源密钥。

类型: apiKey
在: header

示例

Create a personal voice

示例请求

POST {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2024-02-01-preview

示例响应

状态代码:
201 
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2024-02-01-preview
Operation-Id: 1321a2c0-9be4-471d-83bb-bc3be4f96a6f
{
  "id": "Jessica-PersonalVoice",
  "speakerProfileId": "3059912f-a3dc-49e3-bdd0-02e449df1fe3",
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

定义

名称 说明
AzureBlobContentSource

Azure Blob 存储内容。 在以下示例中，它表示文件 https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error

顶级错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含一个顶级错误，其中包含错误代码、消息、详细信息、目标以及具有更多描述性详细信息的内部错误。
ErrorCode

顶级错误代码
ErrorResponse

错误响应遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。
InnerError

内部错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含必需的属性错误代码、消息和可选属性目标、内部错误 (可以嵌套) 。
ModelFailureReason

模型训练失败原因
PersonalVoice

个人语音对象
PersonalVoiceProperties

个人语音属性
Status

资源的状态。

AzureBlobContentSource

Azure Blob 存储内容。 在以下示例中，它表示文件 https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

名称 类型 说明
containerUrl

string

使用 SAS 的 Azure Blob 存储容器 URL。 需要读取权限和列表权限。
extensions

string[]

文件扩展名。
prefix

string

Blob 名称前缀。

Error

顶级错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含一个顶级错误，其中包含错误代码、消息、详细信息、目标以及具有更多描述性详细信息的内部错误。

名称 类型 说明
code

ErrorCode

顶级错误代码
details

Error[]

有关错误和/或预期策略的其他支持详细信息。
innererror

InnerError

内部错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含必需的属性错误代码、消息和可选属性目标、内部错误 (可以嵌套) 。
message

string

顶级错误消息。
target

string

错误的源。 例如，如果模型无效，则为“model”或“model id”。

ErrorCode

顶级错误代码

名称 类型 说明
BadArgument

string

BadRequest

string

Forbidden

string

InternalServerError

string

NotFound

string

ServiceUnavailable

string

TooManyRequests

string

Unauthorized

string

UnsupportedMediaType

string

ErrorResponse

错误响应遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名称 类型 说明
error

Error

顶级错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含一个顶级错误，其中包含错误代码、消息、详细信息、目标以及具有更多描述性详细信息的内部错误。

InnerError

内部错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含必需的属性错误代码、消息和可选属性目标、内部错误 (可以嵌套) 。

名称 类型 说明
code

string

帮助诊断的详细错误代码。
innererror

InnerError

内部错误遵循 Microsoft Azure REST API 指南，请参阅 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 这包含必需的属性错误代码、消息和可选属性目标、内部错误 (可以嵌套) 。
message

string

详细的错误消息。
target

string

错误的源。 例如，如果模型无效，则为“model”或“model id”。

ModelFailureReason

模型训练失败原因

名称 类型 说明
InaccessibleCustomerStorage

string

客户在语音帐户中使用“自带存储”。 但是现在无法访问存储。 请查看 文档。
Internal

string

自定义语音服务错误。
SpeakerVerificationFailed

string

同意和训练音频不是来自同一个说话人。
TerminateByUser

string

客户取消了模型训练。

PersonalVoice

个人语音对象

名称 类型 说明
audios

AzureBlobContentSource

Azure Blob 存储内容。 在以下示例中，它表示文件 https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId

string

资源 ID
createdDateTime

string

创建对象的时间戳。 时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh：mm：ssZ”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
description

string

个人语音说明
displayName

string

个人语音的显示名称
id

string

资源 ID
lastActionDateTime

string

输入当前状态时的时间戳。 时间戳编码为 ISO 8601 日期和时间格式 (“YYYY-MM-DDThh：mm：ssZ”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
projectId

string

资源 ID
properties

PersonalVoiceProperties

个人语音属性
speakerProfileId

string

个人语音说话人个人资料 ID。在 SSML 中填充此属性。
status

Status

资源的状态。

PersonalVoiceProperties

个人语音属性

名称 类型 说明
failureReason

ModelFailureReason

模型训练失败原因

Status

资源的状态。

名称 类型 说明
Disabled

string

Disabling

string

Failed

string

NotStarted

string

Running

string

Succeeded

string