Models - Create
Yeni bir ses modeli oluşturur.
PUT {endpoint}/customvoice/models/{id}?api-version=2024-02-01-preview
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
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: |
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 |
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: |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
consentId | True |
string |
Kaynak kimliği |
projectId | True |
string |
Kaynak kimliği |
recipe | True |
Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir. |
|
trainingSetId | True |
string |
Kaynak kimliği |
description |
string |
Model açıklaması |
|
id |
string |
Kaynak kimliği |
|
locale |
string |
Bu modelin yerel ayarı. Yerel ayar kodu BCP-47'yi izler. Metin okuma yerel ayarı listesini burada https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsbulabilirsiniz. |
|
properties |
Model özellikleri |
||
status |
Kaynağın durumu. |
||
voiceName |
string |
Ses adı |
Yanıtlar
Name | Tür | Description |
---|---|---|
201 Created |
Oluşturulan Üst Bilgiler
|
|
Other Status Codes |
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 model |
Create a multi style model |
Create a model
Örnek isteği
PUT {endpoint}/customvoice/models/Jessica?api-version=2024-02-01-preview
{
"voiceName": "JessicaNeural",
"description": "Jessica voice",
"recipe": {
"kind": "Default"
},
"projectId": "Jessica",
"consentId": "Jessica",
"trainingSetId": "Jessica-300"
}
Örnek yanıt
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1f4352df-f247-40c0-a7b1-a54d017933e1?api-version=2024-02-01-preview
Operation-Id: 1f4352df-f247-40c0-a7b1-a54d017933e1
{
"id": "Jessica",
"voiceName": "JessicaNeural",
"description": "Jessica voice",
"recipe": {
"kind": "Default",
"version": "V7.2023.03"
},
"projectId": "Jessica",
"consentId": "Jessica",
"trainingSetId": "Jessica-300",
"locale": "en-US",
"engineVersion": "2023.07.04.0",
"status": "NotStarted",
"createdDateTime": "2023-04-01T05:30:00.000Z",
"lastActionDateTime": "2023-04-02T10:15:30.000Z"
}
Create a multi style model
Örnek isteği
PUT {endpoint}/customvoice/models/JessicaMultiStyle?api-version=2024-02-01-preview
{
"voiceName": "JessicaMultiStyleNeural",
"description": "Jessica multi style voice",
"recipe": {
"kind": "MultiStyle"
},
"projectId": "Jessica",
"consentId": "Jessica",
"trainingSetId": "Jessica-300",
"locale": "en-US",
"properties": {
"presetStyles": [
"cheerful",
"sad"
],
"styleTrainingSetIds": {
"happy": "JessicaHappy-300",
"myStyle2": "JessicaStyle2"
}
}
}
Örnek yanıt
Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/a01a127a-c204-4e46-a8c1-fab01559b05b?api-version=2024-02-01-preview
Operation-Id: a01a127a-c204-4e46-a8c1-fab01559b05b
{
"id": "JessicaMultiStyle",
"voiceName": "JessicaMultiStyleNeural",
"description": "Jessica multi style voice",
"recipe": {
"kind": "MultiStyle",
"version": "V3.2023.06"
},
"projectId": "Jessica",
"consentId": "Jessica",
"trainingSetId": "Jessica-300",
"locale": "en-US",
"engineVersion": "2023.07.04.0",
"properties": {
"presetStyles": [
"cheerful",
"sad"
],
"styleTrainingSetIds": {
"happy": "JessicaHappy-300",
"myStyle2": "JessicaStyle2"
},
"voiceStyles": [
"cheerful",
"sad",
"happy",
"myStyle2"
]
},
"status": "NotStarted",
"createdDateTime": "2023-04-01T05:30:00.000Z",
"lastActionDateTime": "2023-04-02T10:15:30.000Z"
}
Tanımlar
Name | Description |
---|---|
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. |
Error |
Üst düzey hata kodu |
Error |
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. |
Inner |
İç 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. |
Model |
Model nesnesi |
Model |
Model eğitim hatasının nedeni |
Model |
Model özellikleri |
Preset |
Yemek tarifi tarafından desteklenen önceden ayarlanmış stiller. Ses modeli, herhangi bir stil eğitim kümesi olmadan bu stilleri destekleyebilir. |
Recipe |
Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir. |
Status |
Kaynağın durumu. |
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 |
Üst düzey hata kodu |
|
details |
Error[] |
Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları. |
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 |
Ü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 |
İç 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. |
Model
Model nesnesi
Name | Tür | Description |
---|---|---|
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 |
Model açıklaması |
engineVersion |
string |
Altyapı sürümü. Bu sürümü güncelleştirin, en son söyleniş hata düzeltmesini alabilir. |
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. ). |
locale |
string |
Bu modelin yerel ayarı. Yerel ayar kodu BCP-47'yi izler. Metin okuma yerel ayarı listesini burada https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsbulabilirsiniz. |
projectId |
string |
Kaynak kimliği |
properties |
Model özellikleri |
|
recipe |
Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir. |
|
status |
Kaynağın durumu. |
|
trainingSetId |
string |
Kaynak kimliği |
voiceName |
string |
Ses adı |
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. |
ModelProperties
Model özellikleri
Name | Tür | Description |
---|---|---|
failureReason |
Model eğitim hatasının nedeni |
|
presetStyles |
string[] |
Bu modelin önceden ayarlanmış stilleri. |
styleTrainingSetIds |
object |
Özelleştirilmiş stiller ve ilişkili eğitim kümeleri. |
voiceStyles |
string[] |
Bu model tarafından desteklenen tüm stiller. |
PresetStyleItem
Yemek tarifi tarafından desteklenen önceden ayarlanmış stiller. Ses modeli, herhangi bir stil eğitim kümesi olmadan bu stilleri destekleyebilir.
Name | Tür | Description |
---|---|---|
female |
string[] |
Kadın ses modelinde desteklenen önceden ayarlanmış stiller. |
male |
string[] |
Erkek ses modelinde desteklenen önceden ayarlanmış stiller. |
Recipe
Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir.
Name | Tür | Description |
---|---|---|
datasetLocales |
string[] |
Eğitim veri kümesinin yerel ayarı. Yerel ayar kodu BCP-47'yi izler. Metin okuma yerel ayarı listesini burada https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsbulabilirsiniz. |
description |
string |
Yemek tarifi açıklaması |
kind |
string |
Yemek tarifi türü |
maxCustomStyleNum |
integer |
Tek bir ses modelinde desteklenen özelleştirilmiş stil sayısı üst sınırı. |
minStyleUtteranceCount |
integer |
Özelleştirilmiş her stili eğitmek için gereken en düşük konuşma sayısı. |
minUtteranceCount |
integer |
Bu tarifle bir ses modelini eğitmek için gereken en düşük konuşma sayısı. |
modelLocales |
string[] |
Bir ses modelinin bu tarifle konuşabileceği yer. Yerel ayar kodu BCP-47'yi izler. Metin okuma yerel ayarı listesini burada https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsbulabilirsiniz. |
presetStyles |
<string,
Preset |
Yerel ayar başına bu tarif tarafından desteklenen önceden ayarlanmış stiller. Bu stilleri herhangi bir stil eğitim kümesi olmadan alabilirsiniz. |
version |
string |
Yemek tarifi sürümü |
Status
Kaynağın durumu.
Name | Tür | Description |
---|---|---|
Disabled |
string |
|
Disabling |
string |
|
Failed |
string |
|
NotStarted |
string |
|
Running |
string |
|
Succeeded |
string |