Personal Voices - Post

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: 2024-02-01-preview

Tworzy nowy osobisty głos z plikami audio w kliencie.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
projectId	formData	True	string	Identyfikator projektu. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
audioData	formData		file	Pliki audio.
description	formData		string	Opcjonalny opis tego modelu.
displayName	formData		string	Nazwa wyświetlana tego modelu.
properties	formData		string	Właściwości.
endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Identyfikator zasobu. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Media Types: "multipart/form-data"

Nazwa Wymagane Typ Opis

Ocp-Apim-Subscription-Key

True

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string	Tutaj podaj klucz zasobu usługi Mowa.
Operation-Id		string	Identyfikator monitora stanu dla operacji. Jeśli nagłówek Operation-Id pasuje do istniejącej operacji, a żądanie nie jest identyczne z poprzednim żądaniem, zakończy się niepowodzeniem z błędem 400 Nieprawidłowe żądanie. Wzorzec wyrażenia regularnego: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Tutaj podaj klucz zasobu usługi Mowa.

Operation-Id

string

Identyfikator monitora stanu dla operacji. Jeśli nagłówek Operation-Id pasuje do istniejącej operacji, a żądanie nie jest identyczne z poprzednim żądaniem, zakończy się niepowodzeniem z błędem 400 Nieprawidłowe żądanie.

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Odpowiedzi

Nazwa	Typ	Opis
201 Created	PersonalVoice	Utworzone Nagłówki Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Wystąpił błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

201 Created

PersonalVoice

Utworzone

Nagłówki

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Wystąpił błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Tutaj podaj klucz zasobu usługi Mowa.

Typ: apiKey
W: header

Przykłady

Create a personal voice

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.
ErrorCode	Kod błędu najwyższego poziomu
ErrorResponse	Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).
ModelFailureReason	Przyczyna niepowodzenia trenowania modelu
PersonalVoice	Osobisty obiekt głosu
PersonalVoiceProperties	Osobiste właściwości głosu
Status	Stan zasobu.

AzureBlobContentSource

Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nazwa	Typ	Opis
containerUrl	string	Adres URL kontenera usługi Azure Blob Storage z sygnaturą dostępu współdzielonego. Potrzebujesz uprawnień do odczytu i listy.
extensions	string[]	Rozszerzenia nazw plików.
prefix	string	Prefiks nazwy obiektu blob.

Error

Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

Nazwa	Typ	Opis
code	ErrorCode	Kod błędu najwyższego poziomu
details	Error[]	Dodatkowe szczegóły dotyczące błędów i/lub oczekiwanych zasad.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).
message	string	Komunikat o błędzie najwyższego poziomu.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

ErrorCode

Kod błędu najwyższego poziomu

Nazwa	Typ	Opis
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Odpowiedź na błąd jest zgodna z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nazwa	Typ	Opis
error	Error	Błąd najwyższego poziomu jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on błąd najwyższego poziomu z kodem błędu, komunikatem, szczegółami, elementem docelowym i wewnętrznym błędem z bardziej opisowymi szczegółami.

InnerError

Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).

Nazwa	Typ	Opis
code	string	Szczegółowy kod błędu pomocny w diagnostyce.
innererror	InnerError	Błąd wewnętrzny jest zgodny z wytycznymi interfejsu API REST platformy Microsoft Azure dostępnymi pod adresem https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Zawiera on wymagany kod błędu właściwości, komunikat i opcjonalny obiekt docelowy właściwości, błąd wewnętrzny (można to zagnieżdżać).
message	string	Szczegółowy komunikat o błędzie.
target	string	Źródło błędu. Na przykład będzie to "model" lub "identyfikator modelu" w przypadku nieprawidłowego modelu.

ModelFailureReason

Przyczyna niepowodzenia trenowania modelu

Nazwa	Typ	Opis
InaccessibleCustomerStorage	string	Klient korzysta z usługi Bring Your Own Storage na koncie mowy. Jednak magazyn nie jest teraz dostępny. Sprawdź dokument.
Internal	string	Błąd usługi Custom Voice Service.
SpeakerVerificationFailed	string	Zgoda i dźwięk treningowy nie pochodzą z tego samego głośnika.
TerminateByUser	string	Klient anulował trenowanie modelu.

PersonalVoice

Osobisty obiekt głosu

Nazwa	Typ	Opis
audios	AzureBlobContentSource	Zawartość usługi Azure Blob Storage. W poniższych przykładach reprezentuje pliki https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string	Identyfikator zasobu
createdDateTime	string	Sygnatura czasowa utworzenia obiektu. Znacznik czasu jest zakodowany jako format daty i godziny ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", zobacz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Opis głosu osobistego
displayName	string	Nazwa wyświetlana głosu osobistego
id	string	Identyfikator zasobu
lastActionDateTime	string	Sygnatura czasowa wprowadzenia bieżącego stanu. Znacznik czasu jest zakodowany jako format daty i godziny ISO 8601 ("RRRR-MM-DDThh:mm:ssZ", zobacz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
projectId	string	Identyfikator zasobu
properties	PersonalVoiceProperties	Osobiste właściwości głosu
speakerProfileId	string	Osobisty identyfikator profilu osoby mówiącej głosowej. Wypełnij tę właściwość w języku SSML.
status	Status	Stan zasobu.

PersonalVoiceProperties

Osobiste właściwości głosu

Nazwa	Typ	Opis
failureReason	ModelFailureReason	Przyczyna niepowodzenia trenowania modelu

Status

Stan zasobu.

Nazwa	Typ	Opis
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Udostępnij za pośrednictwem

Personal Voices - Post

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

Ocp-Apim-Subscription-Key

Przykłady

Create a personal voice

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Dodatkowe zasoby