Personal Voices - Post

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: 2024-02-01-preview

İstemcide ses dosyalarıyla yeni bir kişisel ses oluşturur.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
projectId	formData	True	string	Proje kimliği. Normal ifade deseni: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
audioData	formData		file	Ses dosyaları.
description	formData		string	Bu modelin isteğe bağlı açıklaması.
displayName	formData		string	Bu modelin görünen adı.
properties	formData		string	Özellikler.
endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve konak adı, örneğin: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	Kaynağın kimliği. Normal ifade deseni: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`
api-version	query	True	string	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Media Types: "multipart/form-data"

Name Gerekli Tür Description

Ocp-Apim-Subscription-Key

True

Name	Gerekli	Tür	Description
Ocp-Apim-Subscription-Key	True	string	Konuşma kaynak anahtarınızı burada belirtin.
Operation-Id		string	İşlem için durum izleyicisinin kimliği. Operation-Id üst bilgisi mevcut bir işlemle eşleşiyorsa ve istek önceki istekle aynı değilse, 400 Hatalı İstek ile başarısız olur. Normal ifade deseni: `^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$`

string

Konuşma kaynak anahtarınızı burada belirtin.

Operation-Id

string

İşlem için durum izleyicisinin kimliği. Operation-Id üst bilgisi mevcut bir işlemle eşleşiyorsa ve istek önceki istekle aynı değilse, 400 Hatalı İstek ile başarısız olur.

Normal ifade deseni: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

Yanıtlar

Name	Tür	Description
201 Created	PersonalVoice	Oluşturulan Üst Bilgiler Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Bir hata oluşmuştur. Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

201 Created

PersonalVoice

Oluşturulan

Üst Bilgiler

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Bir hata oluşmuştur.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Konuşma kaynak anahtarınızı burada belirtin.

Tür: apiKey
İçinde: header

Örnekler

Create a personal voice

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 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"
}

Tanımlar

Name	Description
AzureBlobContentSource	Azure Blob Depolama içeriği. Aşağıdaki örneklerde *.wav dosyalarıhttps://contoso.blob.core.windows.net/voicecontainer/jessica/ temsil eder
Error	Üst düzey hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, hata kodu, ileti, ayrıntılar, hedef ve daha açıklayıcı ayrıntılar içeren bir iç hata içeren üst düzey bir hata içerir.
ErrorCode	Üst düzey hata kodu
ErrorResponse	Hata yanıtı, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler.
InnerError	İç hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodunu, ileti ve isteğe bağlı özelliklerin hedef, iç hata (iç içe yerleştirilmiş olabilir) içerir.
ModelFailureReason	Model eğitim hatasının nedeni
PersonalVoice	Kişisel ses nesnesi
PersonalVoiceProperties	Kişisel ses özellikleri
Status	Kaynağın durumu.

AzureBlobContentSource

Azure Blob Depolama içeriği. Aşağıdaki örneklerde *.wav dosyalarıhttps://contoso.blob.core.windows.net/voicecontainer/jessica/ temsil eder

Name	Tür	Description
containerUrl	string	SAS ile Azure Blob Depolama kapsayıcı URL'si. Hem okuma hem de listeleme izinleri gerekir.
extensions	string[]	Dosya adı uzantıları.
prefix	string	Blob adı ön eki.

Error

Üst düzey hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, hata kodu, ileti, ayrıntılar, hedef ve daha açıklayıcı ayrıntılar içeren bir iç hata içeren üst düzey bir hata içerir.

Name	Tür	Description
code	ErrorCode	Üst düzey hata kodu
details	Error[]	Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları.
innererror	InnerError	İç hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodunu, ileti ve isteğe bağlı özelliklerin hedef, iç hata (iç içe yerleştirilmiş olabilir) içerir.
message	string	Üst düzey hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz model olması durumunda "model" veya "model kimliği" olabilir.

ErrorCode

Üst düzey hata kodu

Name	Tür	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

Hata yanıtı, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler.

Name	Tür	Description
error	Error	Üst düzey hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, hata kodu, ileti, ayrıntılar, hedef ve daha açıklayıcı ayrıntılar içeren bir iç hata içeren üst düzey bir hata içerir.

InnerError

İç hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodunu, ileti ve isteğe bağlı özelliklerin hedef, iç hata (iç içe yerleştirilmiş olabilir) içerir.

Name	Tür	Description
code	string	Tanılamaya yardımcı olmak için ayrıntılı hata kodu.
innererror	InnerError	İç hata, adresinde https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsbulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodunu, ileti ve isteğe bağlı özelliklerin hedef, iç hata (iç içe yerleştirilmiş olabilir) içerir.
message	string	Ayrıntılı hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz model olması durumunda "model" veya "model kimliği" olabilir.

ModelFailureReason

Model eğitim hatasının nedeni

Name	Tür	Description
InaccessibleCustomerStorage	string	Müşteri Konuşma Hesabında Kendi Depolama Alanınızı Getirin özelliğini kullanır. Ancak depolamaya şu anda erişilemiyor. Lütfen belgeyi kontrol edin.
Internal	string	Özel Ses Hizmeti hatası.
SpeakerVerificationFailed	string	Onay ve eğitim sesi aynı konuşmacıdan değil.
TerminateByUser	string	Müşteri model eğitimini iptal etti.

PersonalVoice

Kişisel ses nesnesi

Name	Tür	Description
audios	AzureBlobContentSource	Azure Blob Depolama içeriği. Aşağıdaki örneklerde *.wav dosyalarıhttps://contoso.blob.core.windows.net/voicecontainer/jessica/ temsil eder
consentId	string	Kaynak kimliği
createdDateTime	string	Nesnenin oluşturulduğu zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
description	string	Kişisel ses açıklaması
displayName	string	Kişisel sesin görünen adı
id	string	Kaynak kimliği
lastActionDateTime	string	Geçerli durumun girildiği zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-AA-GGThh:mm:ssZ", bkz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
projectId	string	Kaynak kimliği
properties	PersonalVoiceProperties	Kişisel ses özellikleri
speakerProfileId	string	Kişisel ses hoparlörü profil kimliği. Bu özelliği SSML'de doldurun.
status	Status	Kaynağın durumu.

PersonalVoiceProperties

Kişisel ses özellikleri

Name	Tür	Description
failureReason	ModelFailureReason	Model eğitim hatasının nedeni

Status

Kaynağın durumu.

Name	Tür	Description
Disabled	string
Disabling	string
Failed	string
NotStarted	string
Running	string
Succeeded	string

Aracılığıyla paylaş

Personal Voices - Post

URI Parametreleri

İstek Başlığı

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Örnekler

Create a personal voice

Örnek isteği

Örnek yanıt

Tanımlar

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Ek kaynaklar