Personal Voices - Post

服務:

Azure AI Services

API 版本:

2024-02-01-preview

在用戶端中使用音訊檔案建立新的個人語音。

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

URI 參數

名稱	位於	必要	類型	Description
projectId	formData	True	string	專案識別碼。 Regex 模式: ^[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	資源的標識碼。 Regex 模式: ^[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"

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string	在這裡提供您的語音資源金鑰。
Operation-Id		string	作業的狀態監視器標識碼。 如果 Operation-Id 標頭符合現有的作業，且要求與先前的要求不相同，則會失敗並出現 400 不正確的要求。 Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

回應

名稱	類型	Description
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

範例要求

HTTP

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"
}

定義

名稱	Description
AzureBlobContentSource	Azure Blob 記憶體內容。 使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav
Error	最上層錯誤遵循Microsoft可在 取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors的 Azure REST API 指導方針。 這包含具有錯誤碼、訊息、詳細數據、目標和內部錯誤的最上層錯誤，其中包含更詳細的描述性詳細數據。
ErrorCode	最上層錯誤碼
ErrorResponse	錯誤回應遵循 Microsoft Azure https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsREST API 指導方針，可在 取得。
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

名稱	類型	Description
containerUrl	string	具有 SAS的 Azure Blob 記憶體容器 URL。 需要讀取和清單許可權。
extensions	string[]	擴展名。
prefix	string	Blob 名稱前置詞。

Error

最上層錯誤遵循Microsoft可在 取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors的 Azure REST API 指導方針。 這包含具有錯誤碼、訊息、詳細數據、目標和內部錯誤的最上層錯誤，其中包含更詳細的描述性詳細數據。

名稱	類型	Description
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	錯誤的來源。 例如，如果是無效的模型，它會是「模型」或「模型標識碼」。

ErrorCode

最上層錯誤碼

名稱	類型	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

錯誤回應遵循 Microsoft Azure https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsREST API 指導方針，可在 取得。

名稱	類型	Description
error	Error	最上層錯誤遵循Microsoft可在 取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors的 Azure REST API 指導方針。 這包含具有錯誤碼、訊息、詳細數據、目標和內部錯誤的最上層錯誤，其中包含更詳細的描述性詳細數據。

InnerError

內部錯誤遵循 Microsoft Azure REST API 指導方針，可在取得 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。 這包含必要的屬性錯誤碼、訊息和選擇性屬性目標、內部錯誤 (這可以是巢狀) 。

名稱	類型	Description
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	錯誤的來源。 例如，如果是無效的模型，它會是「模型」或「模型標識碼」。

ModelFailureReason

模型定型失敗原因

名稱	類型	Description
InaccessibleCustomerStorage	string	客戶會在語音帳戶中使用自備記憶體。 但現在無法存取記憶體。 請檢查 檔。
Internal	string	自訂語音服務錯誤。
SpeakerVerificationFailed	string	同意和訓練音訊不是來自相同的說話者。
TerminateByUser	string	客戶已取消模型定型。

PersonalVoice

個人語音物件

名稱	類型	Description
audios	AzureBlobContentSource	Azure Blob 記憶體內容。 使用下列範例，它代表檔案https://contoso.blob.core.windows.net/voicecontainer/jessica/ *.wav
consentId	string	資源識別碼
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	資源識別碼
lastActionDateTime	string	輸入目前狀態時的時間戳。 時間戳會編碼為 ISO 8601 日期和時間格式， (“YYYY-MM-DDThh：mm：ssZ”，請參閱 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
projectId	string	資源識別碼
properties	PersonalVoiceProperties	個人語音屬性
speakerProfileId	string	個人語音說話者配置檔標識碼。在 SSML 中填入此屬性。
status	Status	資源的狀態。

PersonalVoiceProperties

個人語音屬性

名稱	類型	Description
failureReason	ModelFailureReason	模型定型失敗原因

Status

資源的狀態。

名稱	類型	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string