Models - Get

Hizmet:: Azure AI Services

API Sürümü:: 2026-01-01

Verilen kimlikle tanımlanan modeli alır.

GET {endpoint}/customvoice/models/{id}?api-version=2026-01-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	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]$	Kaynak kimliği
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Model	İstek başarılı oldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

200 OK

Model

İstek başarılı oldu.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Ocp-Apim-Subscription-Key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://cognitiveservices.azure.com/.default

Örnekler

Get a model

Örnek isteği

HTTP

GET {endpoint}/customvoice/models/Jessica?api-version=2026-01-01

Örnek yanıt

Durum kodu:: 200

{
  "description": "Jessica voice",
  "consentId": "Jessica",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "engineVersion": "2023.07.04.0",
  "id": "Jessica",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z",
  "locale": "en-US",
  "projectId": "Jessica",
  "recipe": {
    "kind": "Default",
    "version": "V7.2023.03"
  },
  "status": "NotStarted",
  "trainingSetId": "Jessica-300",
  "voiceName": "JessicaNeural"
}

Tanımlar

Name	Description
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Model	Model nesnesi
ModelFailureReason	Model eğitimi arıza nedeni
ModelProperties	Model özellikleri
PresetStyleItem	Tarifle desteklenen önceden ayarlanmış stiller. Ses modeli, herhangi bir stil eğitim seti olmadan bu tarzları destekleyebilir.
Recipe	Model yapım için bir reçete. Farklı tariflerin farklı yetenekleri vardır.
Status	Bir kaynağın durumu.

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

Model

Nesne

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üncellemek, en son telaffuz hata düzeltmesini alabilir.
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 mekanı. Yerel kod BCP-47'yi takip eder. Metinden konuşmaya yerel listeyi 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 yapım için bir reçete. Farklı tariflerin farklı yetenekleri vardır.
status	Status	Bir 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

Numaralandırma

Model eğitimi arıza nedeni

Değer	Description
InaccessibleCustomerStorage	Müşteri, Konuşma İçinde Kendi Depolamanızı Getir hesabını kullanır. Ancak depolama şu anda erişilebilir değil. Lütfen doktora bak.
SpeakerVerificationFailed	Onay ve eğitim sesi aynı hoparlörden değil.
TerminateByUser	Müşteri model eğitimini iptal etti.
Internal	Özel Ses Hizmeti hatası.
DataNotReady	Eğitim verisi model eğitimi için hazır değildir.
DataNotEnough	Model eğitimi için eğitim verisi yeterli değildir.

ModelProperties

Nesne

Model özellikleri

Name	Tür	Description
failedTrainingsets	string[]	Başarısız eğitim setlerinin kimlikleri.
failureReason	ModelFailureReason	Model eğitimi arıza nedeni
presetStyles	string[]	Bu modelin önceden belirlenmiş stilleri.
secondaryLocales	string[]	Bu modelin konuşabildiği ikincil yerler. Yerel kod BCP-47'yi takip eder.
styleTrainingSetIds	object	Özelleştirilmiş stiller ve ilgili antrenman setleri.
voiceStyles	string[]	Tüm stiller bu model tarafından desteklenmektedir.

PresetStyleItem

Nesne

Tarifle desteklenen önceden ayarlanmış stiller. Ses modeli, herhangi bir stil eğitim seti olmadan bu tarzları destekleyebilir.

Name	Tür	Description
female	string[]	Kadın ses modelinde desteklenen ön ayarlanmış stiller.
male	string[]	Erkek ses modelinde desteklenen ön ayarlanmış stiller.

Recipe

Nesne

Model yapım için bir reçete. Farklı tariflerin farklı yetenekleri vardır.

Name	Tür	Description
datasetLocales	string[]	Eğitim veri setinin konumu. Yerel kod BCP-47'yi takip eder. Metinden konuşmaya yerel listeyi 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 maksimum özelleştirilmiş stil numarası.
minDurationInSeconds	number (double)	Bu tarifle bir ses modelini eğitmek için minimum ses süresi saniyeler cinsinden gereklidir.
minStyleUtteranceCount	integer (int32)	Her özel tarzı eğitmek için minimum ifade sayısı.
minUtteranceCount	integer (int32)	Bu tarifle bir ses modelini eğitmek için gereken minimum ifade sayısı.
modelLocales	string[]	Bir ses modelinin bu tarifle konuşabileceği yer. Yerel kod BCP-47'yi takip eder. Metinden konuşmaya yerel listeyi burada https://learn.microsoft.com/azure/ai-services/speech-service/language-support?tabs=ttsbulabilirsiniz.
presetStyles	<string, PresetStyleItem>	Bu tarifle desteklenen önceden ayarlanmış stiller, her bir lokasyon. Bu stilleri herhangi bir stil antrenmanı seti olmadan da elde edebilirsiniz.
version	string	Tarif versiyonu

Status

Numaralandırma

Bir kaynağın durumu.

Değer	Description
NotStarted	Henüz Başlamadı
Running	Koşmak
Succeeded	Succeeded
Failed	Başarısız oldu
Disabling	Devre dışı bırakma
Disabled	Disabled