Models - Create

Referensi

Service:: Azure AI Services

API Version:: v3.2-preview.2

Membuat model baru.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	Titik akhir Cognitive Services yang didukung (protokol dan nama host, misalnya: https://westus.api.cognitive.microsoft.com).

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
displayName	True	string	Nama tampilan objek.
locale	True	string	Lokal data yang terkandung.
baseModel		EntityReference	EntityReference
customProperties		object	Properti kustom entitas ini. Panjang kunci maksimum yang diizinkan adalah 64 karakter, panjang nilai maksimum yang diizinkan adalah 256 karakter dan jumlah entri yang diizinkan adalah 10.
datasets		EntityReference[]	Himpunan data yang digunakan untuk adaptasi.
description		string	Deskripsi objek .
project		EntityReference	EntityReference
properties		CustomModelProperties	CustomModelProperties
text		string	Teks yang digunakan untuk menyesuaikan model bahasa ini.

Respons

Nama	Jenis	Deskripsi
201 Created	CustomModel	Respons berisi informasi tentang entitas sebagai payload dan lokasinya sebagai header. Headers Location: string
Other Status Codes	Error	Terjadi kesalahan.

Nama

Jenis

Deskripsi

201 Created

CustomModel

Respons berisi informasi tentang entitas sebagai payload dan lokasinya sebagai header.

Headers

Location: string

Other Status Codes

Error

Terjadi kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Berikan kunci akun layanan kognitif Anda di sini.

Type: apiKey
In: header

Authorization

Berikan token akses dari JWT yang dikembalikan oleh STS wilayah ini. Pastikan untuk menambahkan cakupan manajemen ke token dengan menambahkan string kueri berikut ke URL STS: ?scope=speechservicesmanagement

Type: apiKey
In: header

Contoh

Create a model

Create a model with custom model weight

Create a model

Sample Request

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

Sample Response

Status code:: 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

Sample Request

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

Sample Response

Status code:: 201

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

Response Body

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

Definisi

Nama	Deskripsi
CustomModel	CustomModel
CustomModelDeprecationDates	CustomModelDeprecationDates
CustomModelFeatures	CustomModelFeatures
CustomModelLinks	CustomModelLinks
CustomModelProperties	CustomModelProperties
DetailedErrorCode	DetailErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Kesalahan
ErrorCode	ErrorCode
InnerError	InnerError
OutputFormatType	OutputFormatType
Status	Status

CustomModel

Nama	Jenis	Deskripsi
baseModel	EntityReference	EntityReference
createdDateTime	string	Stempel waktu saat objek dibuat. Stempel waktu dikodekan sebagai format tanggal dan waktu ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", lihat https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
customProperties	object	Properti kustom entitas ini. Panjang kunci maksimum yang diizinkan adalah 64 karakter, panjang nilai maksimum yang diizinkan adalah 256 karakter dan jumlah entri yang diizinkan adalah 10.
datasets	EntityReference[]	Himpunan data yang digunakan untuk adaptasi.
description	string	Deskripsi objek .
displayName	string	Nama tampilan objek.
lastActionDateTime	string	Stempel waktu ketika status saat ini dimasukkan. Stempel waktu dikodekan sebagai format tanggal dan waktu ISO 8601 ("YYYY-MM-DDThh:mm:ssZ", lihat https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	CustomModelLinks	CustomModelLinks
locale	string	Lokal data yang terkandung.
project	EntityReference	EntityReference
properties	CustomModelProperties	CustomModelProperties
self	string	Lokasi entitas ini.
status	Status	Status Menjelaskan status API saat ini
text	string	Teks yang digunakan untuk menyesuaikan model bahasa ini.

CustomModelDeprecationDates

Nama	Jenis	Deskripsi
transcriptionDateTime	string	Tanggal ketika transkripsi menjadi tidak digunakan lagi.

CustomModelFeatures

Nama	Jenis	Deskripsi
supportedOutputFormats	OutputFormatType[]	Format output yang didukung.
supportsEndpoints	boolean	Nilai yang menunjukkan apakah pembuatan titik akhir untuk transkripsi langsung didukung.
supportsTranscriptions	boolean	Nilai yang menunjukkan apakah transkripsi batch didukung.
supportsTranscriptionsOnSpeechContainers	boolean	Nilai yang menunjukkan apakah model ini dapat digunakan untuk transkripsi pada kontainer ucapan. Fitur ini dapat ditambahkan pada model yang ada ketika dapat digunakan pada kontainer ucapan.

CustomModelLinks

Nama	Jenis	Deskripsi
copy	string	Lokasi ke tindakan penyalinan model. Lihat operasi "Models_Copy" untuk detail selengkapnya.
copyTo	string	Lokasi ke tindakan penyalinan model usang. Lihat operasi "Models_CopyTo" untuk detail selengkapnya.
files	string	Lokasi untuk mendapatkan semua file entitas ini. Lihat operasi "Models_ListFiles" untuk detail selengkapnya.
manifest	string	Lokasi untuk mendapatkan manifes agar model ini digunakan dalam kontainer lokal. Lihat operasi "Models_GetCustomModelManifest" untuk detail selengkapnya.

CustomModelProperties

Nama	Jenis	Deskripsi
customModelWeightPercent	integer	Berat model kustom antara 1 (model kustom 1% dan model dasar 99%) dan 100 (model kustom 100% dan model dasar 0%). Ketika properti ini tidak diatur, layanan memilih nilai yang sesuai (dapatkan model untuk mengambil berat yang dipilih). Mulai tanpa menggunakan properti ini. Jika diperlukan, pilih bobot yang lebih besar (atau lebih kecil) untuk meningkatkan (atau mengurangi) dampak model kustom.
deprecationDates	CustomModelDeprecationDates	CustomModelDeprecationDates
email	string	Alamat email untuk mengirim pemberitahuan email jika operasi selesai. Nilai akan dihapus setelah berhasil mengirim email.
error	EntityError	EntityError
features	CustomModelFeatures	CustomModelFeatures Fitur yang didukung oleh model.

DetailedErrorCode

DetailErrorCode

Nama	Jenis	Deskripsi
DataImportFailed	string	Impor data gagal.
DeleteNotAllowed	string	Hapus tidak diperbolehkan.
DeployNotAllowed	string	Penyebaran tidak diperbolehkan.
DeployingFailedModel	string	Menyebarkan model yang gagal.
EmptyRequest	string	Permintaan Kosong.
EndpointCannotBeDefault	string	Titik akhir tidak boleh default.
EndpointNotUpdatable	string	Titik akhir tidak dapat diperbarui.
EndpointWithoutLogging	string	Titik akhir tanpa pengelogan.
ExceededNumberOfRecordingsUris	string	Melebihi jumlah uri rekaman.
FailedDataset	string	Himpunan data yang gagal.
Forbidden	string	Terlarang.
InUseViolation	string	Dalam pelanggaran penggunaan.
InaccessibleCustomerStorage	string	Penyimpanan pelanggan yang tidak dapat diakses.
InvalidAdaptationMapping	string	Pemetaan adaptasi tidak valid.
InvalidBaseModel	string	Model dasar tidak valid.
InvalidCallbackUri	string	Uri panggilan balik tidak valid.
InvalidCollection	string	Koleksi tidak valid.
InvalidDataset	string	Himpunan data tidak valid.
InvalidDocument	string	Dokumen Tidak Valid.
InvalidDocumentBatch	string	Batch Dokumen Tidak Valid.
InvalidLocale	string	Lokal tidak valid.
InvalidLogDate	string	Tanggal log tidak valid.
InvalidLogEndTime	string	Waktu akhir log tidak valid.
InvalidLogId	string	Id log tidak valid.
InvalidLogStartTime	string	Waktu mulai log tidak valid.
InvalidModel	string	Model tidak valid.
InvalidModelUri	string	Uri model tidak valid.
InvalidParameter	string	Parameter tidak valid.
InvalidParameterValue	string	Nilai parameter tidak valid.
InvalidPayload	string	Payload tidak valid.
InvalidPermissions	string	Izin tidak valid.
InvalidPrerequisite	string	Prasyarat tidak valid.
InvalidProductId	string	Id produk tidak valid.
InvalidProject	string	Proyek tidak valid.
InvalidProjectKind	string	Jenis proyek tidak valid.
InvalidRecordingsUri	string	Rekaman uri tidak valid.
InvalidRequestBodyFormat	string	Format isi permintaan tidak valid.
InvalidSasValidityDuration	string	Durasi validitas sas tidak valid.
InvalidSkipTokenForLogs	string	Lewati token untuk log tidak valid.
InvalidSourceAzureResourceId	string	ID sumber daya Azure sumber tidak valid.
InvalidSubscription	string	Langganan tidak valid.
InvalidTest	string	Tes tidak valid.
InvalidTimeToLive	string	Waktu hidup tidak valid.
InvalidTopForLogs	string	Atas tidak valid untuk log.
InvalidTranscription	string	Transkripsi tidak valid.
InvalidWebHookEventKind	string	Jenis peristiwa webhook tidak valid.
MissingInputRecords	string	Rekaman Input hilang.
ModelCopyOperationExists	string	Operasi penyalinan model ada.
ModelDeploymentNotCompleteState	string	Status penyebaran model tidak selesai.
ModelDeprecated	string	Model tidak digunakan lagi.
ModelExists	string	Model ada.
ModelMismatch	string	Model tidak cocok.
ModelNotDeployable	string	Model tidak dapat disebarkan.
ModelVersionIncorrect	string	Versi Model Salah.
NoUtf8WithBom	string	Tidak ada utf8 dengan bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Hanya salah satu url atau kontainer atau himpunan data.
ProjectGenderMismatch	string	Ketidakcocokan jenis kelamin proyek.
QuotaViolation	string	Pelanggaran kuota.
SingleDefaultEndpoint	string	Titik akhir default tunggal.
SkuLimitsExist	string	Batas Sku ada.
SubscriptionNotFound	string	Langganan tidak ditemukan.
UnexpectedError	string	Kesalahan tak terduga.
UnsupportedClassBasedAdaptation	string	Adaptasi berbasis kelas yang tidak didukung.
UnsupportedDelta	string	Delta yang tidak didukung.
UnsupportedDynamicConfiguration	string	Konfigurasi dinamis yang tidak didukung.
UnsupportedFilter	string	Filter yang tidak didukung.
UnsupportedLanguageCode	string	Kode bahasa tidak didukung.
UnsupportedOrderBy	string	Urutan tidak didukung oleh.
UnsupportedPagination	string	Penomoran halaman yang tidak didukung.
UnsupportedTimeRange	string	Rentang waktu yang tidak didukung.

EntityError

Nama	Jenis	Deskripsi
code	string	Kode kesalahan ini.
message	string	Pesan untuk kesalahan ini.

EntityReference

Nama	Jenis	Deskripsi
self	string	Lokasi entitas yang dirujuk.

Error

Kesalahan

Nama	Jenis	Deskripsi
code	ErrorCode	ErrorCode Kode kesalahan tingkat tinggi.
details	Error[]	Detail dukungan tambahan mengenai kesalahan dan/atau kebijakan yang diharapkan.
innerError	InnerError	InnerError Format Kesalahan Dalam Baru yang sesuai dengan Pedoman API Cognitive Services yang tersedia di https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Hal ini berisi properti yang diperlukan ErrorCode, pesan dan target properti opsional, detail (pasangan nilai kunci), inner error (ini dapat berlapis).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya "dokumen" atau "id dokumen" jika dokumen tidak valid.

ErrorCode

Nama	Jenis	Deskripsi
Conflict	string	Mewakili kode kesalahan konflik.
Forbidden	string	Mewakili kode kesalahan terlarang.
InternalCommunicationFailed	string	Mewakili kode kesalahan komunikasi internal yang gagal.
InternalServerError	string	Mewakili kode kesalahan server internal.
InvalidArgument	string	Mewakili kode kesalahan argumen yang tidak valid.
InvalidRequest	string	Mewakili kode kesalahan permintaan yang tidak valid.
NotAllowed	string	Mewakili kode kesalahan yang tidak diizinkan.
NotFound	string	Mewakili kode kesalahan yang tidak ditemukan.
PipelineError	string	Mewakili kode kesalahan kesalahan alur.
ServiceUnavailable	string	Mewakili kode kesalahan layanan yang tidak tersedia.
TooManyRequests	string	Mewakili terlalu banyak kode kesalahan permintaan.
Unauthorized	string	Mewakili kode kesalahan yang tidak sah.
UnprocessableEntity	string	Mewakili kode kesalahan entitas yang tidak dapat diolah.
UnsupportedMediaType	string	Mewakili kode kesalahan jenis media yang tidak didukung.

InnerError

Nama	Jenis	Deskripsi
code	DetailedErrorCode	DetailErrorCode Enum kode kesalahan terperinci.
details	object	Detail dukungan tambahan mengenai kesalahan dan/atau kebijakan yang diharapkan.
innerError	InnerError	InnerError Format Kesalahan Dalam Baru yang sesuai dengan Pedoman API Cognitive Services yang tersedia di https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Hal ini berisi properti yang diperlukan ErrorCode, pesan dan target properti opsional, detail (pasangan nilai kunci), inner error (ini dapat berlapis).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya "dokumen" atau "id dokumen" jika dokumen tidak valid.

OutputFormatType

Nama	Jenis	Deskripsi
Display	string	Model mendukung tampilan output atau titik akhir transkripsi pemformatan.
Lexical	string	Model menyediakan output transkripsi tanpa pemformatan.

Status

Nama	Jenis	Deskripsi
Failed	string	Operasi jangka panjang telah gagal.
NotStarted	string	Operasi jangka panjang belum dimulai.
Running	string	Operasi yang berjalan lama saat ini sedang diproses.
Succeeded	string	Operasi jangka panjang berhasil diselesaikan.

Share via

Models - Create

Parameter URI

Isi Permintaan

Respons

Keamanan

Ocp-Apim-Subscription-Key

Authorization

Contoh

Create a model

Sample Request

Sample Response

Create a model with custom model weight

Sample Request

Sample Response

Definisi

CustomModel

CustomModelDeprecationDates

CustomModelFeatures

CustomModelLinks

CustomModelProperties

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

OutputFormatType

Status

Sumber Daya Tambahan: