Models - Create

Başvuru

Hizmet:: Azure AI Services

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

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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynağın kimliği.
api-version	query	True	string minLength: 1	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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	İş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.

İstek Gövdesi

Name	Gerekli	Tür	Description
consentId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
recipe	True	Recipe	Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir.
trainingSetId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
description		string	Model açıklaması
id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	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		ModelProperties	Model özellikleri
status		Status	Kaynağın durumu.
voiceName		string minLength: 1	Ses adı

Yanıtlar

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

Name

Tür

Description

201 Created

Model

Oluşturulan

Üst Bilgiler

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Bir hata oluştu.

Ü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

HTTP

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

Durum kodu:: 201

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

HTTP

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

Durum kodu:: 201

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, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan 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ı, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan Microsoft Azure REST API Yönergeleri'ni izler.
InnerError	İç hata, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodu, ileti ve isteğe bağlı özellikler hedefi, iç hata (iç içe yerleştirilebilir) içerir.
Model	Model nesnesi
ModelFailureReason	Model eğitim hatasının nedeni
ModelProperties	Model özellikleri
PresetStyleItem	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

Object

Üst düzey hata, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan 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, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodu, ileti ve isteğe bağlı özellikler hedefi, iç hata (iç içe yerleştirilebilir) 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

Listeleme

Üst düzey hata kodu

Değer	Description
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Object

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

Name	Tür	Description
error	Error	Üst düzey hata, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan 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

Object

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

Name	Tür	Description
code	string	Tanılamaya yardımcı olmak için ayrıntılı hata kodu.
innererror	InnerError	İç hata, https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errorsadresinde bulunan Microsoft Azure REST API Yönergeleri'ni izler. Bu, gerekli özellikler hata kodu, ileti ve isteğe bağlı özellikler hedefi, iç hata (iç içe yerleştirilebilir) 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

Object

Model nesnesi

Name	Tür	Description
consentId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
createdDateTime	string (date-time)	Nesnenin oluşturulduğu zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-MM-DDThh: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ştirerek en son telaffuz hatasını düzeltebilirsiniz.
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
lastActionDateTime	string (date-time)	Geçerli durumun girildiği zaman damgası. Zaman damgası ISO 8601 tarih ve saat biçimi olarak kodlanmıştır ("YYYY-MM-DDThh: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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
properties	ModelProperties	Model özellikleri
recipe	Recipe	Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir.
status	Status	Kaynağın durumu.
trainingSetId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Kaynak kimliği
voiceName	string minLength: 1	Ses adı

ModelFailureReason

Listeleme

Model eğitim hatasının nedeni

Değer	Description
InaccessibleCustomerStorage	Müşteri Konuşma Hesabında Kendi Depolama Alanınızı Getirin seçeneğini kullanır. Ancak depolama alanına şu anda erişilemiyor. Lütfen belgedenetleyin.
Internal	Özel Ses Hizmeti hatası.
SpeakerVerificationFailed	Onay ve eğitim sesi aynı konuşmacıdan değildir.
TerminateByUser	Müşteri model eğitimini iptal etti.

ModelProperties

Object

Model özellikleri

Name	Tür	Description
failureReason	ModelFailureReason	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

Object

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

Object

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	Tarif açıklaması
kind	string	Tarif türü
maxCustomStyleNum	integer (int32)	Tek bir ses modelinde desteklenen en fazla özelleştirilmiş stil numarası.
minStyleUtteranceCount	integer (int32)	Özelleştirilmiş her stili eğitmek için gereken en düşük konuşma sayısı.
minUtteranceCount	integer (int32)	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şabildiği 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.
presetStyles	<string, PresetStyleItem>	Yerel ayar başına bu tarifin desteklediği önceden ayarlanmış stiller. Bu stilleri herhangi bir stil eğitim kümesi olmadan alabilirsiniz.
version	string	Tarif sürümü

Status

Listeleme

Kaynağın durumu.

Değer	Description
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

Aracılığıyla paylaş

Models - Create

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Örnekler

Create a model

Örnek isteği

Örnek yanıt

Create a multi style model

Örnek isteği

Örnek yanıt

Tanımlar

Error

ErrorCode

ErrorResponse

InnerError

Model

ModelFailureReason

ModelProperties

PresetStyleItem

Recipe

Status