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 menghilangkanMediaSampleRateHertz 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, gunakanOutputKey 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 mendapatkanConflictException 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 sertakanS3:// awalan ember yang ditentukan.

Jika Anda ingin output Anda pergi ke sub-folder bucket ini, tentukan menggunakanOutputKey parameter;OutputBucketName hanya menerima nama bucket.

Misalnya, jika Anda ingin output Anda disimpanS3://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:

1. Gunakan ID kunci KMS itu sendiri. Sebagai contoh, 1234abcd-12ab-34cd-56ef-1234567890ab.

2. Gunakan alias untuk ID kunci KMS. Sebagai contoh, alias/ExampleAlias.

3. Gunakan Amazon Resource Name (ARN) untuk ID kunci KMS. Sebagai contoh, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

4. 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:

1. Gunakan ARN untuk ID kunci KMS. Sebagai contoh, arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

2. 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 menggunakanOutputLocation 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 denganOutputBucketName 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 menggunakanOutputKey:

• Jika Anda menentukan 'DOC-EXAMPLE-BUCKET' sebagaiOutputBucketName dan 'my-transcript.json' sebagaiOutputKey, jalur output transkripsi Anda adalahs3://DOC-EXAMPLE-BUCKET/my-transcript.json.

• Jika Anda menentukan 'my-first-transcription' sebagaiMedicalTranscriptionJobName, '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' sebagaiOutputBucketName 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' sebagaiMedicalTranscriptionJobName, '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 (sepertiIN 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:

• AWSAntarmuka Baris Perintah

• AWSSDK for .NET

• AWSSDK for C++

• AWSSDK for Go

• AWSSDK for Java V2

• AWSSDK untuk JavaScript

• AWSSDK for PHP V3

• AWSSDK for Python

• AWSSDK for Ruby V3