Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
StartMedicalTranscriptionJob
Mentranskripsikan audio dari dikte atau percakapan medis dan menerapkan Parameter Permintaan tambahan yang Anda pilih untuk disertakan dalam permintaan Anda.
Selain banyak fitur transkripsi standar, Amazon Transcribe Medical memberi Anda kosakata medis yang kuat dan, secara opsional, identifikasi konten, yang menambahkan bendera ke informasi kesehatan pribadi (PHI). Untuk mempelajari lebih lanjut tentang fitur-fitur ini, lihat Cara kerja Amazon Transcribe Medical.
Untuk membuatStartMedicalTranscriptionJob
permintaan, Anda harus terlebih dahulu mengunggah file media Anda ke bucket Amazon S3; Anda kemudian dapat menentukan lokasi S3 file menggunakanMedia
parameter.
Anda harus menyertakan parameter berikut dalamStartMedicalTranscriptionJob
permintaan Anda:
-
region
: DiWilayah AWS mana Anda membuat permintaan Anda. Untuk daftar yangWilayah AWS didukung dengan Amazon Transcribe, lihat titik akhir dan kuota Amazon Transcribe. -
MedicalTranscriptionJobName
: Nama kustom yang Anda buat untuk pekerjaan transkripsi Anda yang unik dalam diri AndaAkun AWS. -
Media
(MediaFileUri
): Lokasi Amazon S3 dari file media Anda. -
LanguageCode
: Ini harusen-US
. -
OutputBucketName
: Bucket Amazon S3 tempat Anda ingin transkrip disimpan. Jika Anda ingin output Anda disimpan dalam sub-folder bucket ini, Anda juga harus menyertakannyaOutputKey
. -
Specialty
: Ini harusPRIMARYCARE
. -
Type
: Pilih apakah audio Anda adalah percakapan atau dikte.
Sintaksis Permintaan
{
"ContentIdentificationType": "string
",
"KMSEncryptionContext": {
"string
" : "string
"
},
"LanguageCode": "string
",
"Media": {
"MediaFileUri": "string
",
"RedactedMediaFileUri": "string
"
},
"MediaFormat": "string
",
"MediaSampleRateHertz": number
,
"MedicalTranscriptionJobName": "string
",
"OutputBucketName": "string
",
"OutputEncryptionKMSKeyId": "string
",
"OutputKey": "string
",
"Settings": {
"ChannelIdentification": boolean
,
"MaxAlternatives": number
,
"MaxSpeakerLabels": number
,
"ShowAlternatives": boolean
,
"ShowSpeakerLabels": boolean
,
"VocabularyName": "string
"
},
"Specialty": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"Type": "string
"
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- ContentIdentificationType
-
Label semua informasi kesehatan pribadi (PHI) diidentifikasi dalam transkrip Anda. Untuk informasi selengkapnya, lihat Mengidentifikasi informasi kesehatan pribadi (PHI) dalam transkripsi.
Jenis: String
Nilai yang Valid:
PHI
Wajib: Tidak
- KMSEncryptionContext
-
Peta teks biasa, non-secret key:value pair, yang dikenal sebagai pasangan konteks enkripsi, yang menyediakan lapisan keamanan tambahan untuk data Anda. Untuk informasi selengkapnya, lihat konteksAWS KMS enkripsi dan kunci asimetris diAWS KMS.
Tipe: Peta string ke string
Entri Peta: Jumlah maksimum 10 item.
Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 2000.
Pola Kunci:
.*\S.*
Batasan Panjang Nilai: Panjang minimum 1. Panjang maksimum 2000.
Pola nilai:
.*\S.*
Wajib: Tidak
- LanguageCode
-
Kode bahasa yang mewakili bahasa yang digunakan dalam file media input. US English (
en-US
) adalah satu-satunya nilai yang valid untuk pekerjaan transkripsi medis. Nilai lain yang Anda masukkan untuk kode bahasa menghasilkanBadRequestException
kesalahan.Jenis: String
Nilai Valid:
af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE
Wajib: Ya
- Media
-
Menjelaskan lokasi Amazon S3 dari file media yang ingin Anda gunakan dalam permintaan Anda.
Untuk informasi tentang format media yang didukung, lihat MediaFormatparameter atau bagian Format Media di Panduan Pengembang Amazon S3.
Tipe: Objek Media
Wajib: Ya
- MediaFormat
-
Tentukan format file media input Anda.
Jenis: String
Nilai yang Valid:
mp3 | mp4 | wav | flac | ogg | amr | webm
Wajib: Tidak
- MediaSampleRateHertz
-
Tingkat sampel, dalam hertz, dari trek audio dalam file media input Anda.
Jika Anda tidak menentukan laju sampel media, Amazon Transcribe Medical menentukannya untuk Anda. Jika Anda menentukan laju sampel, laju sampel harus sesuai dengan tingkat yang terdeteksi oleh Amazon Transcribe Medical; jika ada ketidakcocokan antara nilai yang Anda tentukan dan nilai yang terdeteksi, pekerjaan Anda gagal. Oleh karena itu, dalam banyak kasus, disarankan untuk menghilangkan
MediaSampleRateHertz
dan membiarkan Amazon Transcribe Medical menentukan laju sampel.Tipe: Bilangan Bulat
Rentang yang Valid: Nilai minimum 16000. Nilai maksimum 48000.
Wajib: Tidak
- MedicalTranscriptionJobName
-
Nama unik, dipilih oleh Anda, untuk pekerjaan transkripsi medis Anda. Nama yang Anda tentukan juga digunakan sebagai nama default file keluaran transkripsi Anda. Jika Anda ingin menentukan nama yang berbeda untuk output transkripsi Anda, gunakan
OutputKey
parameter.Nama ini peka huruf besar, tidak dapat berisi spasi, dan harus unik dalam sebuahAkun AWS. Jika Anda mencoba membuat pekerjaan baru dengan nama yang sama dengan pekerjaan yang ada, Anda mendapatkan
ConflictException
kesalahan.Jenis: String
Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.
Pola:
^[0-9a-zA-Z._-]+
Diperlukan: Ya
- OutputBucketName
-
Nama bucket Amazon S3 tempat Anda ingin output transkripsi medis Anda disimpan. Jangan sertakan
S3://
awalan ember yang ditentukan.Jika Anda ingin output Anda pergi ke sub-folder bucket ini, tentukan menggunakan
OutputKey
parameter;OutputBucketName
hanya menerima nama bucket.Misalnya, jika Anda ingin output Anda disimpan
S3://DOC-EXAMPLE-BUCKET
, aturOutputBucketName
keDOC-EXAMPLE-BUCKET
. Namun, jika Anda ingin output Anda disimpanS3://DOC-EXAMPLE-BUCKET/test-files/
, aturOutputBucketName
keDOC-EXAMPLE-BUCKET
danOutputKey
ketest-files/
.Perhatikan bahwa Amazon Transcribe harus memiliki izin untuk menggunakan lokasi yang ditentukan. Anda dapat mengubah izin Amazon S3 menggunakan AWS Management Console
. Lihat juga Izin yang Diperlukan untuk Peran Pengguna IAM. Jenis: String
Batasan Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang Panjang
Pola:
[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]
Diperlukan: Ya
- OutputEncryptionKMSKeyId
-
Kunci KMS yang ingin mengenkripsi output transkripsi medis Anda.
Jika menggunakan kunci yang terletak di saat iniAkun AWS, Anda dapat menentukan kunci KMS Anda dengan salah satu dari empat cara:
-
Gunakan ID kunci KMS itu sendiri. Sebagai contoh,
1234abcd-12ab-34cd-56ef-1234567890ab
. -
Gunakan alias untuk ID kunci KMS. Sebagai contoh,
alias/ExampleAlias
. -
Gunakan Amazon Resource Name (ARN) untuk ID kunci KMS. Sebagai contoh,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Gunakan ARN untuk alias kunci KMS. Sebagai contoh,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Jika menggunakan kunci yang terletak di berbedaAkun AWS dari saat iniAkun AWS, Anda dapat menentukan kunci KMS Anda dalam salah satu dari dua cara:
-
Gunakan ARN untuk ID kunci KMS. Sebagai contoh,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Gunakan ARN untuk alias kunci KMS. Sebagai contoh,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Jika Anda tidak menentukan kunci enkripsi, output Anda akan dienkripsi dengan kunci Amazon S3 (SSE-SSSS3).
Jika Anda menentukan kunci KMS untuk mengenkripsi output Anda, Anda juga harus menentukan lokasi keluaran menggunakan
OutputLocation
parameter.Perhatikan bahwa peran yang membuatStartCallAnalyticsJob permintaan harus memiliki izin untuk menggunakan kunci KMS yang ditentukan.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
Wajib: Tidak
-
- OutputKey
-
Gunakan dalam kombinasi dengan
OutputBucketName
untuk menentukan lokasi keluaran transkrip Anda dan, secara opsional, nama unik untuk file keluaran Anda. Nama default untuk output transkripsi Anda sama dengan nama yang Anda tentukan untuk pekerjaan transkripsi medis Anda (MedicalTranscriptionJobName
).Berikut ini beberapa contoh bagaimana Anda dapat menggunakan
OutputKey
:-
Jika Anda menentukan 'DOC-EXAMPLE-BUCKET' sebagai
OutputBucketName
dan 'my-transcript.json' sebagaiOutputKey
, jalur output transkripsi Anda adalahs3://DOC-EXAMPLE-BUCKET/my-transcript.json
. -
Jika Anda menentukan 'my-first-transcription' sebagai
MedicalTranscriptionJobName
, 'DOC-EXAMPLE-BUCKET' sebagaiOutputBucketName
, dan 'my-transcript' sebagaiOutputKey
, jalur output transkripsi Anda adalahs3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json
. -
Jika Anda menetapkan 'DOC-EXAMPLE-BUCKET' sebagai
OutputBucketName
dan 'test-files/my-transcript.json' sebagaiOutputKey
, jalur output transkripsi Anda adalahs3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json
. -
Jika Anda menentukan 'my-first-transcription' sebagai
MedicalTranscriptionJobName
, 'DOC-EXAMPLE-BUCKET' sebagaiOutputBucketName
, dan 'test-files/my-transcript' sebagaiOutputKey
, jalur output transkripsi Anda adalahs3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json
.
Jika Anda menentukan nama sub-folder bucket Amazon S3 yang tidak ada, yang akan dibuat untuk Anda.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.
Pola:
[a-zA-Z0-9-_.!*'()/]{1,1024}$
Wajib: Tidak
-
- Settings
-
Tentukan pengaturan opsional tambahan dalamStartMedicalTranscriptionJob permintaan Anda, termasuk identifikasi saluran, transkripsi alternatif, dan partisi speaker. Anda dapat menggunakannya untuk menerapkan kosakata khusus ke pekerjaan transkripsi Anda.
Tipe: Objek MedicalTranscriptionSetting
Wajib: Tidak
- Specialty
-
Tentukan spesialisasi medis utama yang diwakili di media Anda. Untuk transkripsi batch,
PRIMARYCARE
adalah satu-satunya nilai yang valid. Jika Anda memerlukan spesialisasi tambahan, lihatStartMedicalStreamTranscription.Jenis: String
Nilai Valid:
PRIMARYCARE
Wajib: Ya
- Tags
-
Menambahkan satu atau lebih tag kustom, masing-masing dalam bentuk pasangan key:value, ke pekerjaan transkripsi medis baru pada saat Anda memulai pekerjaan baru ini.
Untuk mempelajari lebih lanjut tentang penggunaan tag dengan Amazon Transcribe, lihat sumber daya pemberian tag.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 200 item.
Wajib: Tidak
- Type
-
Tentukan apakah media masukan Anda hanya berisi satu orang (
DICTATION
) atau berisi percakapan antara dua orang (CONVERSATION
).Misalnya,
DICTATION
dapat digunakan untuk profesional medis yang ingin menyalin memo suara;CONVERSATION
dapat digunakan untuk menyalin dialog dokter-pasien selama kunjungan kantor pasien.Jenis: String
Nilai Valid:
CONVERSATION | DICTATION
Wajib: Ya
Sintaksis Respons
{
"MedicalTranscriptionJob": {
"CompletionTime": number,
"ContentIdentificationType": "string",
"CreationTime": number,
"FailureReason": "string",
"LanguageCode": "string",
"Media": {
"MediaFileUri": "string",
"RedactedMediaFileUri": "string"
},
"MediaFormat": "string",
"MediaSampleRateHertz": number,
"MedicalTranscriptionJobName": "string",
"Settings": {
"ChannelIdentification": boolean,
"MaxAlternatives": number,
"MaxSpeakerLabels": number,
"ShowAlternatives": boolean,
"ShowSpeakerLabels": boolean,
"VocabularyName": "string"
},
"Specialty": "string",
"StartTime": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"Transcript": {
"TranscriptFileUri": "string"
},
"TranscriptionJobStatus": "string",
"Type": "string"
}
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- MedicalTranscriptionJob
-
Memberikan informasi rinci tentang pekerjaan transkripsi medis saat ini, termasuk status pekerjaan dan, jika berlaku, alasan kegagalan.
Tipe: Objek MedicalTranscriptionJob
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- BadRequestException
-
Permintaan Anda tidak lulus satu atau beberapa tes validasi. Hal ini dapat terjadi ketika entitas yang Anda coba hapus tidak ada atau jika itu dalam keadaan non-terminal (seperti
IN PROGRESS
). Lihat kolom pesan pengecualian untuk informasi selengkapnya.Kode Status HTTP: 400
- ConflictException
-
Sumber daya sudah ada dengan nama ini. Nama sumber daya harus unik dalamAkun AWS.
Kode Status HTTP: 400
- InternalFailureException
-
Ada kesalahan internal. Periksa pesan kesalahan, perbaiki masalah, dan coba lagi permintaan Anda.
Kode Status HTTP: 500
- LimitExceededException
-
Anda telah mengirim terlalu banyak permintaan atau file input Anda terlalu panjang. Tunggu sebelum mencoba ulang permintaan Anda, atau gunakan file yang lebih kecil dan coba lagi permintaan Anda.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API di salah satuAWS SDK khusus bahasa, lihat yang berikut ini: