Personal Voices - Create

Başvuru

Hizmet:: Cognitive Services - Custom Voice

API Sürümü:: 2023-12-01-preview

Azure Blob Depolama'da ses dosyalarıyla yeni bir kişisel ses oluşturur.

PUT {endpoint}/customvoice/personalvoices/{id}?api-version=2023-12-01-preview

URI Parametreleri

Name İçinde Gerekli Tür Description

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve ana bilgisayar 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ü.

endpoint

path

True

string

Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve ana bilgisayar adı, örneğin: https://eastus.api.cognitive.microsoft.com).

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ığı

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	İşlemin 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

İşlemin 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]$

İstek Gövdesi

Name	Gerekli	Tür	Description
consentId	True	string	Kaynak kimliği
projectId	True	string	Kaynak kimliği
audios		AzureBlobContentSource	Azure Blob Depolama içeriği. Aşağıdaki örneklerde *.wav dosyalarıhttps://contoso.blob.core.windows.net/voicecontainer/jessica/ temsil eder
description		string	Kişisel ses açıklaması
displayName		string	Kişisel sesin görünen adı
id		string	Kaynak kimliği
status		Status	Kaynağın durumu.

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.

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.

Güvenlik

Ocp-Apim-Subscription-Key

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

Tür: apiKey
İçinde: header

Örnekler

Create a personal voice

Sample request

HTTP

PUT {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2023-12-01-preview



{
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica/",
    "extensions": [
      ".wav"
    ]
  }
}

Sample response

Status code:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2023-12-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ı özellikler hedef, iç hata içerir (bu iç içe olabilir).
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 liste 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 destekleyici 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ı özellikler hedef, iç hata içerir (bu iç içe olabilir).
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ı özellikler hedef, iç hata içerir (bu iç içe olabilir).

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ı özellikler hedef, iç hata içerir (bu iç içe olabilir).
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
Internal	string
None	string
SpeakerVerificationFailed	string
TerminateByUser	string

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 - Create

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Örnekler

Create a personal voice

Sample request

Sample response

Tanımlar

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Ek kaynaklar