Personal Voices - Post

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2024-02-01-preview

Vytvoří nový osobní hlas se zvukovými soubory v klientovi.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
projectId	formData	True	string	ID projektu. Vzor regulárního výrazu: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
audioData	formData		file	Zvukové soubory.
description	formData		string	Volitelný popis tohoto modelu
displayName	formData		string	Zobrazovaný název tohoto modelu.
properties	formData		string	vlastnosti.
endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	ID prostředku. Vzor regulárního výrazu: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Media Types: "multipart/form-data"

Name Vyžadováno Typ Description

Ocp-Apim-Subscription-Key

True

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Sem zadejte svůj klíč prostředku služby Speech.
Operation-Id		string	ID monitorování stavu operace Pokud hlavička Operation-Id odpovídá existující operaci a požadavek není shodný s předchozím požadavkem, selže s chybou 400 Chybný požadavek. Vzor regulárního výrazu: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Sem zadejte svůj klíč prostředku služby Speech.

Operation-Id

string

ID monitorování stavu operace Pokud hlavička Operation-Id odpovídá existující operaci a požadavek není shodný s předchozím požadavkem, selže s chybou 400 Chybný požadavek.

Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Odpovědi

Name	Typ	Description
201 Created	PersonalVoice	Vytvořeno Hlavičky Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Došlo k chybě. Hlavičky x-ms-error-code: string

Name

Typ

Description

201 Created

PersonalVoice

Vytvořeno

Hlavičky

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Došlo k chybě.

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Sem zadejte svůj klíč prostředku služby Speech.

Typ: apiKey
V: header

Příklady

Create a personal voice

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
}

Definice

Name	Description
AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.
ErrorCode	Kód chyby nejvyšší úrovně
ErrorResponse	Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).
ModelFailureReason	Důvod selhání trénování modelu
PersonalVoice	Osobní hlasový objekt
PersonalVoiceProperties	Osobní hlasové vlastnosti
Status	Stav prostředku.

AzureBlobContentSource

Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Description
containerUrl	string	Adresa URL kontejneru Azure Blob Storage se SAS Potřebujete oprávnění ke čtení i výpisu.
extensions	string[]	Přípony názvů souborů.
prefix	string	Předpona názvu objektu blob.

Error

Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

Name	Typ	Description
code	ErrorCode	Kód chyby nejvyšší úrovně
details	Error[]	Další podpůrné podrobnosti týkající se chyby nebo očekávaných zásad
innererror	InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Chybová zpráva nejvyšší úrovně
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "model" nebo "id modelu".

ErrorCode

Kód chyby nejvyšší úrovně

Name	Typ	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Odpověď na chybu se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Description
error	Error	Chyba nejvyšší úrovně se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje chybu nejvyšší úrovně s kódem chyby, zprávou, podrobnostmi, cílem a vnitřní chybou s popisnějšími podrobnostmi.

InnerError

Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).

Name	Typ	Description
code	string	Podrobný kód chyby, který vám pomůže s diagnostikou.
innererror	InnerError	Vnitřní chyba se řídí pokyny k rozhraní Microsoft Azure REST API, které jsou k dispozici na adrese https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Obsahuje kód chyby požadovaných vlastností, zprávu a volitelný cíl vlastností, vnitřní chybu (může být vnořená).
message	string	Podrobná chybová zpráva
target	string	Zdroj chyby. V případě neplatného modelu by to bylo například "model" nebo "id modelu".

ModelFailureReason

Důvod selhání trénování modelu

Name	Typ	Description
InaccessibleCustomerStorage	string	Zákazník používá úložiště Přineste si vlastní v účtu služby Speech. Úložiště ale teď není přístupné. Projděte si dokument.
Internal	string	Chyba služby Custom Voice Service
SpeakerVerificationFailed	string	Vyjádření souhlasu a trénování nejsou od stejného mluvčího.
TerminateByUser	string	Zákazník zrušil trénování modelu.

PersonalVoice

Osobní hlasový objekt

Name	Typ	Description
audios	AzureBlobContentSource	Obsah služby Azure Blob Storage. V následujících příkladech představuje soubory https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string	ID prostředku
createdDateTime	string	Časové razítko, kdy byl objekt vytvořen. Časové razítko je kódované jako formát data a času ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Popis osobního hlasu
displayName	string	Zobrazovaný název osobního hlasu
id	string	ID prostředku
lastActionDateTime	string	Časové razítko, kdy byl zadán aktuální stav. Časové razítko je kódované jako formát data a času ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId	string	ID prostředku
properties	PersonalVoiceProperties	Osobní hlasové vlastnosti
speakerProfileId	string	ID osobního profilu hlasového mluvčího. Vyplňte tuto vlastnost v SSML.
status	Status	Stav prostředku.

PersonalVoiceProperties

Osobní hlasové vlastnosti

Name	Typ	Description
failureReason	ModelFailureReason	Důvod selhání trénování modelu

Status

Stav prostředku.

Name	Typ	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Sdílet prostřednictvím

Personal Voices - Post

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Příklady

Create a personal voice

Ukázkový požadavek

Ukázková odpověď

Definice

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Další materiály