Transcriptions - Submit

Layanan:: Azure AI Services

Versi API:: 2025-10-15

Mengirimkan pekerjaan transkripsi baru.

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15

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).
api-version	query	True	string	Versi api yang diminta.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Ocp-Apim-Subscription-Key	True	string	Berikan kunci akun layanan kognitif Anda di sini.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
displayName	True	string minLength: 1	Nama tampilan objek.
locale	True	string minLength: 1	Lokasi data yang terkandung. Jika Identifikasi Bahasa digunakan, lokal ini digunakan untuk menyalin ucapan yang tidak dapat dideteksi oleh bahasanya.
properties	True	TranscriptionProperties	Properti Transkripsi
contentContainerUrl		string (uri)	URL untuk kontainer blob Azure yang berisi file audio. Kontainer diizinkan memiliki ukuran maksimum 5GB dan jumlah maksimum 10000 blob. Ukuran maksimum untuk blob adalah 2,5 GB. SAS kontainer harus berisi izin 'r' (baca) dan 'l' (daftar). Properti ini tidak akan dikembalikan sebagai respons.
contentUrls		string[] (uri)	Daftar url konten untuk mendapatkan file audio untuk ditranskripsikan. Hingga 1000 url diperbolehkan. Properti ini tidak akan dikembalikan sebagai respons.
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.
dataset		EntityReference	EntityReference
description		string	Deskripsi objek.
model		EntityReference	EntityReference
project		EntityReference	EntityReference

Respons

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

Nama

Jenis

Deskripsi

201 Created

Transcription

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

Header

Location: string

Other Status Codes

Error

Terjadi kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Berikan kunci akun layanan kognitif Anda di sini.

Jenis: apiKey
Dalam: header

Contoh

Create a transcription for URIs

Create a transcription from blob container

Create a transcription with language identification

Create a transcription with multispeaker diarization

Create a transcription for URIs

Permintaan sampel

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using default model for en-US",
  "locale": "en-US",
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48
  }
}

Respon sampel

Kode status:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  },
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Create a transcription from blob container

Permintaan sampel

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription of storage container using default model for en-US",
  "locale": "en-US",
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48
  },
  "contentContainerUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/audiofiles/"
}

Respon sampel

Kode status:: 201

Location: https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  },
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Create a transcription with language identification

Permintaan sampel

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "locale": "fr-FR",
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
        }
      },
      "mode": "Single"
    }
  }
}

Respon sampel

Kode status:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "customProperties": {
    "key": "value"
  },
  "locale": "fr-FR",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
        }
      },
      "mode": "Single"
    },
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Create a transcription with multispeaker diarization

Permintaan sampel

HTTP

POST {endpoint}/speechtotext/transcriptions:submit?api-version=2025-10-15


{
  "displayName": "Transcription using diarization for audio that is known to contain speech from up to 5 speakers",
  "locale": "en-US",
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "diarization": {
      "enabled": true,
      "maxSpeakers": 5
    }
  }
}

Respon sampel

Kode status:: 201

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683?api-version=2025-10-15",
  "displayName": "Transcription using diarization for audio that is known to contain speech from up to 5 speakers",
  "customProperties": {
    "key": "value"
  },
  "locale": "en-US",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/models/827712a5-f942-4997-91c3-7c6cde35600b?api-version=2025-10-15"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?api-version=2025-10-15"
  },
  "properties": {
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "timeToLiveHours": 48,
    "diarization": {
      "enabled": true,
      "maxSpeakers": 5
    },
    "durationMilliseconds": 42000
  },
  "status": "Succeeded"
}

Definisi

Nama	Deskripsi
DetailedErrorCode	Kode Kesalahan Terperinci
DiarizationProperties	Properti Diarisasi
EntityError	EntityError
EntityReference	EntityReference
Error	Kesalahan
ErrorCode	ErrorCode
InnerError	InnerError
LanguageIdentificationMode	Mode Identifikasi Bahasa.
LanguageIdentificationProperties	LanguageIdentificationProperties
ProfanityFilterMode	Mode Filter Kotor
PunctuationMode	Mode Tanda Baca
Status	Kedudukan
Transcription	Transkripsi
TranscriptionLinks	TranskripsiTautan
TranscriptionProperties	Properti Transkripsi

DetailedErrorCode

Enumeration

Kode Kesalahan Terperinci

Nilai	Deskripsi
InvalidParameterValue	Nilai parameter tidak valid.
InvalidRequestBodyFormat	Format isi permintaan tidak valid.
EmptyRequest	Permintaan kosong.
MissingInputRecords	Catatan Input yang Hilang.
InvalidDocument	Dokumen Tidak Valid.
ModelVersionIncorrect	Versi Model Salah.
InvalidDocumentBatch	Kumpulan Dokumen Tidak Valid.
UnsupportedLanguageCode	Kode bahasa yang tidak didukung.
DataImportFailed	Impor data gagal.
InUseViolation	Dalam pelanggaran penggunaan.
InvalidLocale	Lokal tidak valid.
InvalidBaseModel	Model dasar tidak valid.
InvalidAdaptationMapping	Pemetaan adaptasi tidak valid.
InvalidDataset	Himpunan data tidak valid.
InvalidTest	Pengujian tidak valid.
FailedDataset	Himpunan data gagal.
InvalidModel	Model tidak valid.
InvalidTranscription	Transkripsi tidak valid.
InvalidPayload	Muatan tidak valid.
InvalidParameter	Parameter tidak valid.
EndpointWithoutLogging	Titik akhir tanpa pengelogan.
InvalidPermissions	Izin tidak valid.
InvalidPrerequisite	Prasyarat tidak valid.
InvalidProductId	ID produk tidak valid.
InvalidSubscription	Langganan tidak valid.
InvalidProject	Proyek tidak valid.
InvalidProjectKind	Jenis proyek tidak valid.
InvalidRecordingsUri	Rekaman tidak valid uri.
OnlyOneOfUrlsOrContainerOrDataset	Hanya satu url atau kontainer atau himpunan data.
ExceededNumberOfRecordingsUris	Melebihi jumlah rekaman uris.
InvalidChannels	Saluran tidak valid.
ModelMismatch	Ketidakcocokan model.
ProjectGenderMismatch	Proyek ketidakcocokan gender.
ModelDeprecated	Model tidak digunakan lagi.
ModelExists	Model ada.
ModelNotDeployable	Model tidak dapat disebarkan.
EndpointNotUpdatable	Titik akhir tidak dapat diperbarui.
SingleDefaultEndpoint	Titik akhir default tunggal.
EndpointCannotBeDefault	Titik akhir tidak dapat menjadi default.
InvalidModelUri	Uri model tidak valid.
SubscriptionNotFound	Langganan tidak ditemukan.
QuotaViolation	Pelanggaran kuota.
UnsupportedDelta	Delta yang tidak didukung.
UnsupportedFilter	Filter yang tidak didukung.
UnsupportedPagination	Penomoran halaman yang tidak didukung.
UnsupportedDynamicConfiguration	Konfigurasi dinamis yang tidak didukung.
UnsupportedOrderBy	Pesanan yang tidak didukung oleh.
NoUtf8WithBom	Tidak ada utf8 dengan bom.
ModelDeploymentNotCompleteState	Penyebaran model tidak selesai.
SkuLimitsExist	Batas SKU ada.
DeployingFailedModel	Menyebarkan model yang gagal.
UnsupportedTimeRange	Rentang waktu yang tidak didukung.
InvalidLogDate	Tanggal log tidak valid.
InvalidLogId	ID log tidak valid.
InvalidLogStartTime	Waktu mulai log tidak valid.
InvalidLogEndTime	Waktu akhir log tidak valid.
InvalidTopForLogs	Bagian atas tidak valid untuk log.
InvalidSkipTokenForLogs	Token lewati tidak valid untuk log.
DeleteNotAllowed	Hapus tidak diizinkan.
Forbidden	Dilarang.
DeployNotAllowed	Deploy tidak diizinkan.
UnexpectedError	Kesalahan tak terduga.
InvalidCollection	Koleksi tidak valid.
InvalidCallbackUri	Uri callback tidak valid.
InvalidSasValidityDuration	Durasi validitas sas tidak valid.
InaccessibleCustomerStorage	Penyimpanan pelanggan yang tidak dapat diakses.
UnsupportedClassBasedAdaptation	Adaptasi berbasis kelas yang tidak didukung.
InvalidWebHookEventKind	Jenis peristiwa kait web tidak valid.
InvalidTimeToLive	Waktu hidup yang tidak valid.
InvalidSourceAzureResourceId	ID sumber daya Azure yang tidak valid.
ModelCopyAuthorizationExpired	ModelCopyAuthorization kedaluwarsa.
EndpointLoggingNotSupported	Pengelogan titik akhir tidak didukung.
NoLanguageIdentified	Identifikasi Bahasa tidak mengenali bahasa apa pun.
MultipleLanguagesIdentified	Identifikasi Bahasa mengenali banyak bahasa. Tidak ada bahasa dominan yang dapat ditentukan.
InvalidAudioFormat	Format audio input tidak didukung.
BadChannelConfiguration	Ada ketidakcocokan antara saluran audio dalam data, dalam konfigurasi, atau persyaratan aplikasi.
InvalidChannelSpecification	Pemilihan saluran dalam permintaan transkripsi tidak didukung (misalnya, baik 0 maupun 1 belum dipilih.)
AudioLengthLimitExceeded	File audio lebih lama dari durasi maksimum yang diizinkan.
EmptyAudioFile	File audio kosong.

DiarizationProperties

Objek

Properti Diarisasi

Nama	Jenis	Deskripsi
enabled	boolean	Nilai yang menunjukkan apakah diarisasi speaker diaktifkan.
maxSpeakers	integer (int32) minimum: 2 maximum: 35	Petunjuk untuk jumlah maksimum speaker untuk diarisasi. Harus lebih besar dari 1 dan kurang dari 36.

EntityError

Objek

EntityError

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

EntityReference

Objek

EntityReference

Nama	Jenis	Deskripsi
self	string (uri)	Lokasi entitas yang direferensikan.

Error

Objek

Kesalahan

Nama	Jenis	Deskripsi
code	ErrorCode	ErrorCode Kode kesalahan tingkat tinggi.
details	Error[]	Detail pendukung 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. Ini berisi properti yang diperlukan ErrorCode, pesan dan target properti opsional, detail (pasangan nilai kunci), kesalahan dalam (ini dapat bersarang).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya itu akan menjadi "dokumen" atau "id dokumen" jika dokumen tidak valid.

ErrorCode

Enumeration

ErrorCode

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

InnerError

Objek

InnerError

Nama	Jenis	Deskripsi
code	DetailedErrorCode	Kode Kesalahan Terperinci Enum kode kesalahan terperinci.
details	object	Detail pendukung 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. Ini berisi properti yang diperlukan ErrorCode, pesan dan target properti opsional, detail (pasangan nilai kunci), kesalahan dalam (ini dapat bersarang).
message	string	Pesan kesalahan tingkat tinggi.
target	string	Sumber kesalahan. Misalnya itu akan menjadi "dokumen" atau "id dokumen" jika dokumen tidak valid.

LanguageIdentificationMode

Enumeration

Mode Identifikasi Bahasa.

Nilai	Deskripsi
Continuous	Identifikasi bahasa berkelanjutan (Default).
Single	Identifikasi bahasa tunggal. Jika tidak ada bahasa yang dapat diidentifikasi, kode kesalahan NoLanguageIdentified dikembalikan ke pengguna. Jika ada ambiguitas antara beberapa bahasa, kode kesalahan MultipleLanguagesIdentified akan dikembalikan ke pengguna.

LanguageIdentificationProperties

Objek

LanguageIdentificationProperties

Nama	Jenis	Nilai default	Deskripsi
candidateLocales	string[]		Lokasi kandidat untuk identifikasi bahasa (contoh ["en-US", "de-DE", "es-ES"]). Minimal 2 dan maksimum 10 lokal kandidat, termasuk lokal utama untuk transkripsi, didukung untuk mode berkelanjutan. Untuk identifikasi bahasa tunggal, jumlah maksimum lokal kandidat tidak terbatas.
mode	LanguageIdentificationMode	Continuous	Mode Identifikasi Bahasa. Mode yang digunakan untuk identifikasi bahasa.
speechModelMapping	<string, EntityReference>		Pemetaan lokal opsional ke entitas model ucapan. Jika tidak ada model yang diberikan untuk lokal, model dasar default digunakan. Kunci harus berupa lokal yang terkandung dalam lokal kandidat, nilai adalah entitas untuk model masing-masing lokal.

ProfanityFilterMode

Enumeration

Mode Filter Kotor

Nilai	Deskripsi
None	Nonaktifkan pemfilteran kata-kata kotor.
Removed	Hapus kata-kata kotor.
Tags	Tambahkan tag XML "kata-kata kotor"/Kata-kata< kotor>
Masked	Tutupi kata-kata kotor dengan * kecuali huruf pertama, misalnya, f***

PunctuationMode

Enumeration

Mode Tanda Baca

Nilai	Deskripsi
None	Tidak ada tanda baca.
Dictated	Tanda baca yang didikte saja, yaitu tanda baca eksplisit.
Automatic	Tanda baca otomatis.
DictatedAndAutomatic	Tanda baca yang didikte atau tanda baca otomatis.

Status

Enumeration

Kedudukan

Nilai	Deskripsi
NotStarted	Operasi yang berjalan lama belum dimulai.
Running	Operasi yang berjalan lama saat ini sedang diproses.
Succeeded	Operasi yang berjalan lama telah berhasil diselesaikan.
Failed	Operasi yang berjalan lama telah gagal.

Transcription

Objek

Transkripsi

Nama	Jenis	Deskripsi
contentContainerUrl	string (uri)	URL untuk kontainer blob Azure yang berisi file audio. Kontainer diizinkan memiliki ukuran maksimum 5GB dan jumlah maksimum 10000 blob. Ukuran maksimum untuk blob adalah 2,5 GB. SAS kontainer harus berisi izin 'r' (baca) dan 'l' (daftar). Properti ini tidak akan dikembalikan sebagai respons.
contentUrls	string[] (uri)	Daftar url konten untuk mendapatkan file audio untuk ditranskripsikan. Hingga 1000 url diperbolehkan. Properti ini tidak akan dikembalikan sebagai respons.
createdDateTime	string (date-time)	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.
dataset	EntityReference	EntityReference
description	string	Deskripsi objek.
displayName	string minLength: 1	Nama tampilan objek.
lastActionDateTime	string (date-time)	Stempel waktu saat 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	TranscriptionLinks	TranskripsiTautan
locale	string minLength: 1	Lokasi data yang terkandung. Jika Identifikasi Bahasa digunakan, lokal ini digunakan untuk menyalin ucapan yang tidak dapat dideteksi oleh bahasanya.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	Properti Transkripsi
self	string (uri)	Lokasi entitas ini.
status	Status	Kedudukan Jelaskan status API saat ini.

TranscriptionLinks

Objek

TranskripsiTautan

Nama	Jenis	Deskripsi
files	string (uri)	Lokasi untuk mendapatkan semua file entitas ini. Lihat operasi "Transcriptions_ListFiles" untuk detail lebih lanjut.

TranscriptionProperties

Objek

Properti Transkripsi

Nama	Jenis	Nilai default	Deskripsi
channels	integer[] (int32)		Kumpulan nomor saluran yang diminta. Dalam kasus default, saluran 0 dan 1 dipertimbangkan.
destinationContainerUrl	string (uri)		Kontainer tujuan yang diminta. Komentar Ketika kontainer tujuan digunakan dalam kombinasi dengan `timeToLive`, metadata transkripsi akan dihapus secara normal, tetapi data yang disimpan dalam kontainer tujuan, termasuk hasil transkripsi, akan tetap tidak tersentuh, karena tidak diperlukan izin penghapusan untuk penampung ini. Untuk mendukung pembersihan otomatis, konfigurasikan masa pakai blob pada kontainer, atau gunakan "Bawa Penyimpanan Anda sendiri (BYOS)" alih-alih `destinationContainerUrl`, di mana blob dapat dibersihkan.
diarization	DiarizationProperties		Properti Diarisasi
displayFormWordLevelTimestampsEnabled	boolean		Nilai yang menunjukkan apakah stempel waktu tingkat kata untuk formulir tampilan diminta. Nilai defaultnya adalah `false`.
durationMilliseconds	integer (int64)	0	Durasi dalam milidetik transkripsi. Durasi yang lebih besar dari 2^53-1 tidak didukung untuk memastikan kompatibilitas dengan bilangan bulat JavaScript.
error	EntityError		EntityError
languageIdentification	LanguageIdentificationProperties		LanguageIdentificationProperties
profanityFilterMode	ProfanityFilterMode		Mode Filter Kotor Mode penyaringan kata-kata kotor.
punctuationMode	PunctuationMode		Mode Tanda Baca Mode yang digunakan untuk tanda baca.
timeToLiveHours	integer (int32)		Berapa lama transkripsi akan disimpan dalam sistem setelah selesai. Setelah transkripsi mencapai waktu untuk hidup setelah selesai (berhasil atau gagal), transkripsi akan dihapus secara otomatis. Catatan: Saat menggunakan BYOS (bawa penyimpanan Anda sendiri), file hasil pada akun penyimpanan milik pelanggan juga akan dihapus. Gunakan destinationContainerUrl untuk menentukan kontainer terpisah untuk file hasil yang tidak akan dihapus saat timeToLive kedaluwarsa, atau ambil file hasil melalui API dan simpan sesuai kebutuhan. Durasi terpendek yang didukung adalah 6 jam, durasi terlama yang didukung adalah 31 hari. 2 hari (48 jam) adalah nilai default yang direkomendasikan saat data dikonsumsi secara langsung.
wordLevelTimestampsEnabled	boolean		Nilai yang menunjukkan apakah stempel waktu tingkat kata diminta. Nilai defaultnya adalah `false`.

Transcriptions - Submit

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

Ocp-Apim-Subscription-Key

Contoh

Create a transcription for URIs

Permintaan sampel

Respon sampel

Create a transcription from blob container

Permintaan sampel

Respon sampel

Create a transcription with language identification

Permintaan sampel

Respon sampel

Create a transcription with multispeaker diarization

Permintaan sampel

Respon sampel

Definisi

DetailedErrorCode

DiarizationProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationMode

LanguageIdentificationProperties

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

Komentar