Models - Create

Başvuru

Hizmet:: Azure AI Services

API Sürümü:: v3.2-preview.2

Yeni bir model oluşturur.

POST {endpoint}/speechtotext/v3.2-preview.2/models

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://westus.api.cognitive.microsoft.com).

İstek Gövdesi

Name	Gerekli	Tür	Description
displayName	True	string	Nesnenin görünen adı.
locale	True	string	Kapsanan verilerin yerel ayarı.
baseModel		EntityReference	EntityReference
customProperties		object	Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur.
datasets		EntityReference[]	Uyarlama için kullanılan veri kümeleri.
description		string	Nesnenin açıklaması.
project		EntityReference	EntityReference
properties		CustomModelProperties	CustomModelProperties
text		string	Bu dil modelini uyarlamak için kullanılan metin.

Yanıtlar

Name	Tür	Description
201 Created	CustomModel	Yanıt, yük olarak varlık ve üst bilgi olarak konumu hakkında bilgi içerir. Üst Bilgiler Location: string
Other Status Codes	Error	Bir hata oluşmuştur.

Name

Tür

Description

201 Created

CustomModel

Yanıt, yük olarak varlık ve üst bilgi olarak konumu hakkında bilgi içerir.

Üst Bilgiler

Location: string

Other Status Codes

Error

Bir hata oluşmuştur.

Güvenlik

Ocp-Apim-Subscription-Key

Bilişsel hizmetler hesap anahtarınızı burada sağlayın.

Tür: apiKey
İçinde: header

Authorization

Bu bölgenin STS tarafından döndürülen JWT'den bir erişim belirteci sağlayın. STS URL'sine aşağıdaki sorgu dizesini ekleyerek yönetim kapsamını belirteci eklediğinizden emin olun: ?scope=speechservicesmanagement

Tür: apiKey
İçinde: header

Örnekler

Create a model

Create a model with custom model weight

Create a model

Örnek isteği

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/models

{
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "locale": "en-US",
  "displayName": "Model with acoustic and language datasets"
}

Örnek yanıt

Durum kodu:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b",
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "links": {
    "manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
    "copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
    "copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
  },
  "properties": {
    "deprecationDates": {
      "transcriptionDateTime": "2023-05-04T00:00:00Z"
    },
    "customModelWeightPercent": 30,
    "features": {
      "supportsTranscriptions": true,
      "supportsEndpoints": true,
      "supportsTranscriptionsOnSpeechContainers": false,
      "supportedOutputFormats": [
        "Lexical",
        "Display"
      ]
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Running",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Language model",
  "description": "This is a language model"
}

Create a model with custom model weight

Örnek isteği

HTTP

POST {endpoint}/speechtotext/v3.2-preview.2/models

{
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1"
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "properties": {
    "customModelWeightPercent": 42
  },
  "locale": "en-US",
  "displayName": "Model with acoustic and language datasets"
}

Örnek yanıt

Durum kodu:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b",
  "baseModel": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/base/8a043172-65b7-4cf3-a8b5-4449efa5a0f1"
  },
  "datasets": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c"
    }
  ],
  "links": {
    "manifest": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/manifest/827712a5-f942-4997-91c3-7c6cde35600b",
    "copyTo": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copyto",
    "copy": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy",
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files"
  },
  "properties": {
    "deprecationDates": {
      "transcriptionDateTime": "2023-05-04T00:00:00Z"
    },
    "customModelWeightPercent": 42,
    "features": {
      "supportsTranscriptions": true,
      "supportsEndpoints": true,
      "supportsTranscriptionsOnSpeechContainers": false,
      "supportedOutputFormats": [
        "Lexical",
        "Display"
      ]
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Running",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Language model",
  "description": "This is a language model"
}

Tanımlar

Name	Description
CustomModel	CustomModel
CustomModelDeprecationDates	CustomModelDeprecationDates
CustomModelFeatures	CustomModelFeatures
CustomModelLinks	CustomModelLinks
CustomModelProperties	CustomModelProperties
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Hata
ErrorCode	ErrorCode
InnerError	InnerError
OutputFormatType	OutputFormatType
Status	Durum

CustomModel

Name	Tür	Description
baseModel	EntityReference	EntityReference
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. ).
customProperties	object	Bu varlığın özel özellikleri. İzin verilen anahtar uzunluğu üst sınırı 64 karakter, izin verilen değer uzunluğu üst sınırı 256 karakter ve izin verilen girdi sayısı 10'dur.
datasets	EntityReference[]	Uyarlama için kullanılan veri kümeleri.
description	string	Nesnenin açıklaması.
displayName	string	Nesnenin görünen adı.
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. ).
links	CustomModelLinks	CustomModelLinks
locale	string	Kapsanan verilerin yerel ayarı.
project	EntityReference	EntityReference
properties	CustomModelProperties	CustomModelProperties
self	string	Bu varlığın konumu.
status	Status	Durum API'nin geçerli durumunu açıklama
text	string	Bu dil modelini uyarlamak için kullanılan metin.

CustomModelDeprecationDates

Name	Tür	Description
transcriptionDateTime	string	Transkripsiyonun kullanım dışı bırakıldığında tarih.

CustomModelFeatures

Name	Tür	Description
supportedOutputFormats	OutputFormatType[]	Desteklenen çıkış biçimleri.
supportsEndpoints	boolean	Canlı transkripsiyon için uç nokta oluşturmanın desteklenip desteklenmediğini belirten bir değer.
supportsTranscriptions	boolean	Toplu transkripsiyonun desteklenip desteklenmediğini gösteren bir değer.
supportsTranscriptionsOnSpeechContainers	boolean	Bu modelin konuşma kapsayıcısında transkripsiyon için kullanılıp kullanılamayacağını gösteren değer. Bu özellik, konuşma kapsayıcısında kullanılabilir hale geldiğinde mevcut modellere eklenebilir.

CustomModelLinks

Name	Tür	Description
copy	string	Model kopyalama eyleminin konumu. Daha fazla ayrıntı için bkz. "Models_Copy" işlemi.
copyTo	string	Eski model kopyalama eyleminin konumu. Daha fazla ayrıntı için bkz. "Models_CopyTo" işlemi.
files	string	Bu varlığın tüm dosyalarını almak için konum. Daha fazla ayrıntı için "Models_ListFiles" işlemine bakın.
manifest	string	Şirket içi kapsayıcıda kullanılacak bu model için bildirim alma konumu. Daha fazla ayrıntı için bkz. "Models_GetCustomModelManifest" işlemi.

CustomModelProperties

Name	Tür	Description
customModelWeightPercent	integer	Özel modelin ağırlığı 1 (%1 özel model ve %99 temel model) ile 100 (%100 özel model ve %0 temel model) arasındadır. Bu özellik ayarlanmadığında, hizmet uygun bir değer seçer (seçilen ağırlığı almak için modeli alın). Bu özelliği kullanmadan başlayın. Gerekirse, özel modelin etkisini artırmak (veya azaltmak) için daha büyük (veya daha küçük) bir ağırlık seçin.
deprecationDates	CustomModelDeprecationDates	CustomModelDeprecationDates
email	string	İşlemin tamamlanması durumunda adresine e-posta bildirimleri gönderilecek e-posta adresi. Değer, e-posta başarıyla gönderildikten sonra kaldırılır.
error	EntityError	EntityError
features	CustomModelFeatures	CustomModelFeatures Model tarafından desteklenen özellikler.

DetailedErrorCode

Name	Tür	Description
DataImportFailed	string	Veri içeri aktarma başarısız oldu.
DeleteNotAllowed	string	Silmeye izin verilmiyor.
DeployNotAllowed	string	Dağıtıma izin verilmiyor.
DeployingFailedModel	string	Başarısız modeli dağıtma.
EmptyRequest	string	Boş İstek.
EndpointCannotBeDefault	string	Uç nokta varsayılan olamaz.
EndpointNotUpdatable	string	Uç nokta güncelleştirilebilir değil.
EndpointWithoutLogging	string	Günlüğe kaydetmeden uç nokta.
ExceededNumberOfRecordingsUris	string	Kayıt sayısı aşıldı uris.
FailedDataset	string	Başarısız veri kümesi.
Forbidden	string	Yasak.
InUseViolation	string	Kullanım ihlali.
InaccessibleCustomerStorage	string	Erişilemez müşteri depolama alanı.
InvalidAdaptationMapping	string	Geçersiz uyarlama eşlemesi.
InvalidBaseModel	string	Geçersiz temel model.
InvalidCallbackUri	string	Geçersiz geri çağırma uri'si.
InvalidCollection	string	Geçersiz koleksiyon.
InvalidDataset	string	Geçersiz veri kümesi.
InvalidDocument	string	Geçersiz Belge.
InvalidDocumentBatch	string	Geçersiz Belge Toplu İşlemi.
InvalidLocale	string	Geçersiz yerel ayar.
InvalidLogDate	string	Geçersiz günlük tarihi.
InvalidLogEndTime	string	Geçersiz günlük bitiş saati.
InvalidLogId	string	Geçersiz günlük kimliği.
InvalidLogStartTime	string	Geçersiz günlük başlangıç saati.
InvalidModel	string	Geçersiz model.
InvalidModelUri	string	Geçersiz model uri'si.
InvalidParameter	string	Geçersiz parametre.
InvalidParameterValue	string	Geçersiz parametre değeri.
InvalidPayload	string	Geçersiz yük.
InvalidPermissions	string	Geçersiz izinler.
InvalidPrerequisite	string	Geçersiz önkoşul.
InvalidProductId	string	Geçersiz ürün kimliği.
InvalidProject	string	Geçersiz proje.
InvalidProjectKind	string	Geçersiz proje türü.
InvalidRecordingsUri	string	Geçersiz kayıt uri'si.
InvalidRequestBodyFormat	string	Geçersiz istek gövdesi biçimi.
InvalidSasValidityDuration	string	Geçersiz sas geçerlilik süresi.
InvalidSkipTokenForLogs	string	Günlükler için geçersiz atlama belirteci.
InvalidSourceAzureResourceId	string	Geçersiz kaynak Azure kaynak kimliği.
InvalidSubscription	string	Geçersiz abonelik.
InvalidTest	string	Geçersiz test.
InvalidTimeToLive	string	Geçersiz yaşam süresi.
InvalidTopForLogs	string	Günlükler için geçersiz üst.
InvalidTranscription	string	Geçersiz transkripsiyon.
InvalidWebHookEventKind	string	Geçersiz web kancası olay türü.
MissingInputRecords	string	Eksik Giriş Kayıtları.
ModelCopyOperationExists	string	Model kopyalama işlemi var.
ModelDeploymentNotCompleteState	string	Model dağıtımı tamamlanamadı durumu.
ModelDeprecated	string	Model kullanım dışı bırakıldı.
ModelExists	string	Model var.
ModelMismatch	string	Model uyuşmazlığı.
ModelNotDeployable	string	Model dağıtılamaz.
ModelVersionIncorrect	string	Model Sürümü Yanlış.
NoUtf8WithBom	string	Bom ile utf8 yok.
OnlyOneOfUrlsOrContainerOrDataset	string	Url'lerden, kapsayıcılardan veya veri kümelerinden yalnızca biri.
ProjectGenderMismatch	string	Proje cinsiyet uyuşmazlığı.
QuotaViolation	string	Kota ihlali.
SingleDefaultEndpoint	string	Tek varsayılan uç nokta.
SkuLimitsExist	string	Sku sınırları vardır.
SubscriptionNotFound	string	Abonelik bulunamadı.
UnexpectedError	string	Beklenmeyen hata.
UnsupportedClassBasedAdaptation	string	Desteklenmeyen sınıf tabanlı uyarlama.
UnsupportedDelta	string	Desteklenmeyen delta.
UnsupportedDynamicConfiguration	string	Desteklenmeyen dinamik yapılandırma.
UnsupportedFilter	string	Desteklenmeyen filtre.
UnsupportedLanguageCode	string	Desteklenmeyen dil kodu.
UnsupportedOrderBy	string	Desteklenmeyen sipariş ölçütü.
UnsupportedPagination	string	Desteklenmeyen sayfalandırma.
UnsupportedTimeRange	string	Desteklenmeyen zaman aralığı.

EntityError

Name	Tür	Description
code	string	Bu hatanın kodu.
message	string	Bu hatanın iletisi.

EntityReference

Name	Tür	Description
self	string	Başvuruda bulunılan varlığın konumu.

Error

Hata

Name	Tür	Description
code	ErrorCode	ErrorCode Üst düzey hata kodları.
details	Error[]	Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları.
innerError	InnerError	InnerError adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellikler hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message	string	Üst düzey hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

ErrorCode

Name	Tür	Description
Conflict	string	Çakışma hata kodunu temsil ediyor.
Forbidden	string	Yasak hata kodunu temsil ediyor.
InternalCommunicationFailed	string	İç iletişim başarısız hata kodunu temsil eder.
InternalServerError	string	İç sunucu hata kodunu temsil etme.
InvalidArgument	string	Geçersiz bağımsız değişken hata kodunu temsil ediyor.
InvalidRequest	string	Geçersiz istek hata kodunu temsil ediyor.
NotAllowed	string	İzin verilmeyen hata kodunu temsil ediyor.
NotFound	string	Bulunamadı hata kodunu temsil ediyor.
PipelineError	string	İşlem hattı hata kodunu temsil eder.
ServiceUnavailable	string	Hizmet kullanılamıyor hata kodunu temsil etme.
TooManyRequests	string	Çok fazla istek hata kodunu temsil eder.
Unauthorized	string	Yetkisiz hata kodunu temsil etme.
UnprocessableEntity	string	İşlenemeyen varlık hata kodunu temsil eder.
UnsupportedMediaType	string	Desteklenmeyen medya türü hata kodunu temsil eder.

InnerError

Name	Tür	Description
code	DetailedErrorCode	DetailedErrorCode Ayrıntılı hata kodu sabit listesi.
details	object	Hata ve/veya beklenen ilkelerle ilgili ek destek ayrıntıları.
innerError	InnerError	InnerError adresinde https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owbulunan Bilişsel Hizmetler API Yönergelerine uygun yeni İç Hata biçimi. Bu, ErrorCode, ileti ve isteğe bağlı özellikler hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
message	string	Üst düzey hata iletisi.
target	string	Hatanın kaynağı. Örneğin, geçersiz belge olması durumunda "belgeler" veya "belge kimliği" olabilir.

OutputFormatType

Name	Tür	Description
Display	string	Model, görüntüleme biçimlendirme transkripsiyonları çıkışını veya uç noktalarını destekler.
Lexical	string	Model, biçimlendirme olmadan transkripsiyon çıkışı sağlar.

Status

Durum

Name	Tür	Description
Failed	string	Uzun süre çalışan işlem başarısız oldu.
NotStarted	string	Uzun süre çalışan işlem henüz başlatılmadı.
Running	string	Uzun süre çalışan işlem şu anda işleniyor.
Succeeded	string	Uzun süre çalışan işlem başarıyla tamamlandı.

Aracılığıyla paylaş

Models - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

Ocp-Apim-Subscription-Key

Authorization

Örnekler

Create a model

Örnek isteği

Örnek yanıt

Create a model with custom model weight

Örnek isteği

Örnek yanıt

Tanımlar

CustomModel

CustomModelDeprecationDates

CustomModelFeatures

CustomModelLinks

CustomModelProperties

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

OutputFormatType

Status

Ek kaynaklar