Models - Get

Hizmet:

Azure AI Services

API Sürümü:

2024-02-01-preview

Verilen kimlik tarafından tanımlanan modeli alır.

GET {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: ^[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	string	Konuşma kaynak anahtarınızı burada belirtin.

Yanıtlar

Name	Tür	Description
200 OK	Model	Başarılı
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

Get a model

Örnek isteği

HTTP

GET {endpoint}/customvoice/models/Jessica?api-version=2024-02-01-preview

Örnek yanıt

Durum kodu:

200

{
  "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"
}

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

Ü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.

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	ModelProperties	Model özellikleri
recipe	Recipe	Model oluşturma tarifi. Farklı tarifler farklı özelliklere sahiptir.
status	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	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

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,  PresetStyleItem>	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