Get Transcription - Get Transcription

Referensi

Service:: Azure AI Services

API Version:: v3.0

Mendapatkan transkripsi yang diidentifikasi oleh ID tertentu.

GET {Endpoint}/speechtotext/v3.0/transcriptions/{id}

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).
id	path	True	string uuid	Pengidentifikasi transkripsi.

Respons

Nama	Jenis	Deskripsi
200 OK	Transcription	OK Headers Retry-After: integer
Other Status Codes	Error	Terjadi kesalahan.

Nama

Jenis

Deskripsi

200 OK

Transcription

Headers

Retry-After: integer

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

Get a transcription

Sample Request

HTTP

GET https://westus.api.cognitive.microsoft.com//speechtotext/v3.0/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683

Sample Response

Status code:: 200

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

Definisi

Nama	Deskripsi
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Kesalahan
ErrorCode	ErrorCode
InnerError	InnerError
Links	Tautan
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	Tanda BacaMode
Status	Status
Transcription	Transkripsi
TranscriptionProperties	TranscriptionProperties

DetailedErrorCode

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.
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.
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 kode kesalahan terlalu banyak 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	DetailedErrorCode 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.

Links

Tautan

Nama	Jenis	Deskripsi
files	string	Lokasi untuk mendapatkan semua file entitas ini.

ProfanityFilterMode

Nama	Jenis	Deskripsi
Masked	string	Menutupi kata-kata kotor dengan * kecuali huruf pertama, misalnya, f***
None	string	Nonaktifkan pemfilteran kata-kata kosan.
Removed	string	Hapus kata-kata kocok.
Tags	string	Tambahkan tag< XML "kata-kata kohor" /Kata-kata kohor>

PunctuationMode

Tanda BacaMode

Nama	Jenis	Deskripsi
Automatic	string	Tanda baca otomatis.
Dictated	string	Tanda baca yang ditentukan saja, yaitu tanda baca eksplisit.
DictatedAndAutomatic	string	Tanda baca yang ditentukan atau tanda baca otomatis.
None	string	Tidak ada tanda baca.

Status

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

Transcription

Transkripsi

Nama	Jenis	Deskripsi
contentContainerUrl	string	URL untuk kontainer blob Azure yang berisi file audio. Kontainer diizinkan untuk memiliki ukuran maksimum 5GB dan jumlah maksimum 10000 blob. Ukuran maksimum untuk blob adalah 2,5GB. SAS kontainer harus berisi izin 'r' (baca) dan 'l' (daftar). Properti ini tidak akan dikembalikan dalam respons.
contentUrls	string[]	Daftar url konten untuk mendapatkan file audio untuk ditranskripsikan. Hingga 1000 url diizinkan. Properti ini tidak akan dikembalikan dalam respons.
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.
dataset	EntityReference	EntityReference
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	Links	Tautan
locale	string	Lokal data yang terkandung.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string	Lokasi entitas ini.
status	Status	Status Menjelaskan status API saat ini

TranscriptionProperties

Nama	Jenis	Deskripsi
channels	integer[]	Kumpulan nomor saluran yang diminta. Dalam kasus default, saluran 0 dan 1 dipertimbangkan.
destinationContainerUrl	string	Kontainer tujuan yang diminta. Keterangan 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 ada izin penghapusan yang diperlukan untuk kontainer ini. Untuk mendukung pembersihan otomatis, konfigurasikan masa pakai blob pada kontainer, atau gunakan "Bring your own Storage (BYOS)" alih-alih `destinationContainerUrl`, tempat blob dapat dibersihkan.
diarizationEnabled	boolean	Nilai yang menunjukkan apakah diarisasi (identifikasi pembicara) diminta. Nilai defaultnya adalah `false`.
duration	string	Durasi transkripsi. Durasi dikodekan sebagai durasi ISO 8601 ("PnYnMnDTnHnMnS", lihat https://en.wikipedia.org/wiki/ISO_8601#Durations).
email	string	Alamat email untuk mengirim pemberitahuan email jika operasi selesai. Nilai akan dihapus setelah berhasil mengirim email.
error	EntityError	EntityError
profanityFilterMode	ProfanityFilterMode	ProfanityFilterMode Mode pemfilteran kata-kata kosan.
punctuationMode	PunctuationMode	Tanda BacaMode Mode yang digunakan untuk tanda baca.
timeToLive	string	Berapa lama transkripsi akan disimpan dalam sistem setelah selesai. Setelah transkripsi mencapai waktu hidup setelah selesai (berhasil atau gagal) transkripsi akan dihapus secara otomatis. Tidak mengatur nilai ini atau mengaturnya ke 0 akan menonaktifkan penghapusan otomatis. Durasi terpanjang yang didukung adalah 31 hari. Durasi dikodekan sebagai durasi ISO 8601 ("PnYnMnDTnHnMnS", lihat https://en.wikipedia.org/wiki/ISO_8601#Durations).
wordLevelTimestampsEnabled	boolean	Nilai yang menunjukkan apakah tanda waktu tingkat kata diminta. Nilai defaultnya adalah `false`.

Bagikan melalui

Get Transcription - Get Transcription

Parameter URI

Respons

Keamanan

Ocp-Apim-Subscription-Key

Authorization

Contoh

Get a transcription

Sample Request

Sample Response

Definisi

DetailedErrorCode

EntityError

EntityReference

Error

ErrorCode

InnerError

Links

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionProperties

Keterangan

Sumber Daya Tambahan: