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](https://docs.aws.amazon.com/transcribe/latest/dg/how-it-works-med.html). Untuk membuat`StartMedicalTranscriptionJob` permintaan, Anda harus terlebih dahulu mengunggah file media Anda ke bucket Amazon S3; Anda kemudian dapat menentukan lokasi S3 file menggunakan`Media` parameter. Anda harus menyertakan parameter berikut dalam`StartMedicalTranscriptionJob` 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](https://docs.aws.amazon.com/general/latest/gr/transcribe.html). + `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 harus`en-US`. + `OutputBucketName`: Bucket Amazon S3 tempat Anda ingin transkrip disimpan. Jika Anda ingin output Anda disimpan dalam sub-folder bucket ini, Anda juga harus menyertakannya`OutputKey`. + `Specialty`: Ini harus`PRIMARYCARE`. + `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](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [ContentIdentificationType](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Label semua informasi kesehatan pribadi (PHI) diidentifikasi dalam transkrip Anda. Untuk informasi selengkapnya, lihat [Mengidentifikasi informasi kesehatan pribadi (PHI) dalam transkripsi](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html). Jenis: String Nilai yang Valid:` PHI` Wajib: Tidak ** [KMSEncryptionContext](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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](https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context) dan [kunci asimetris diAWS KMS](https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html). 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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 menghasilkan`BadRequestException` 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Menjelaskan lokasi Amazon S3 dari file media yang ingin Anda gunakan dalam permintaan Anda. Untuk informasi tentang format media yang didukung, lihat [MediaFormat](https://docs.aws.amazon.com/APIReference/API_StartTranscriptionJob.html#transcribe-StartTranscriptionJob-request-MediaFormat)parameter atau bagian [Format Media](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio) di Panduan Pengembang Amazon S3. Tipe: Objek [Media](API_Media.md) Wajib: Ya ** [MediaFormat](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Tentukan format file media input Anda. Jenis: String Nilai yang Valid:` mp3 | mp4 | wav | flac | ogg | amr | webm` Wajib: Tidak ** [MediaSampleRateHertz](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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`, atur`OutputBucketName` ke`DOC-EXAMPLE-BUCKET`. Namun, jika Anda ingin output Anda disimpan`S3://DOC-EXAMPLE-BUCKET/test-files/`, atur`OutputBucketName` ke`DOC-EXAMPLE-BUCKET` dan`OutputKey` ke`test-files/`. Perhatikan bahwa Amazon Transcribe harus memiliki izin untuk menggunakan lokasi yang ditentukan. Anda dapat mengubah izin Amazon S3 menggunakan [Konsol Manajemen AWS](https://console.aws.amazon.com/s3). Lihat juga [Izin yang Diperlukan untuk Peran Pengguna IAM](https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user). 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Kunci KMS yang ingin mengenkripsi output transkripsi medis Anda. Jika menggunakan kunci yang terletak di **saat ini**Akun 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`. 1. Gunakan alias untuk ID kunci KMS. Sebagai contoh, `alias/ExampleAlias`. 1. Gunakan Amazon Resource Name (ARN) untuk ID kunci KMS. Sebagai contoh, `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Gunakan ARN untuk alias kunci KMS. Sebagai contoh, `arn:aws:kms:region:account-ID:alias/ExampleAlias`. Jika menggunakan kunci yang terletak di **berbeda**Akun 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`. 1. 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 membuat[StartCallAnalyticsJob](API_StartCallAnalyticsJob.md) 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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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' sebagai`OutputKey`, jalur output transkripsi Anda adalah`s3://DOC-EXAMPLE-BUCKET/my-transcript.json`. + Jika Anda menentukan 'my-first-transcription' sebagai`MedicalTranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' sebagai`OutputBucketName`, dan 'my-transcript' sebagai`OutputKey`, jalur output transkripsi Anda adalah`s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json`. + Jika Anda menetapkan 'DOC-EXAMPLE-BUCKET' sebagai`OutputBucketName` dan 'test-files/my-transcript.json' sebagai`OutputKey`, jalur output transkripsi Anda adalah`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json`. + Jika Anda menentukan 'my-first-transcription' sebagai`MedicalTranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' sebagai`OutputBucketName`, dan 'test-files/my-transcript' sebagai`OutputKey`, jalur output transkripsi Anda adalah`s3://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](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Tentukan pengaturan opsional tambahan dalam[StartMedicalTranscriptionJob](#API_StartMedicalTranscriptionJob) permintaan Anda, termasuk identifikasi saluran, transkripsi alternatif, dan partisi speaker. Anda dapat menggunakannya untuk menerapkan kosakata khusus ke pekerjaan transkripsi Anda. Tipe: Objek [MedicalTranscriptionSetting](API_MedicalTranscriptionSetting.md) Wajib: Tidak ** [Specialty](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Tentukan spesialisasi medis utama yang diwakili di media Anda. Untuk transkripsi batch,`PRIMARYCARE` adalah satu-satunya nilai yang valid. Jika Anda memerlukan spesialisasi tambahan, lihat[StartMedicalStreamTranscription](API_streaming_StartMedicalStreamTranscription.md). Jenis: String Nilai Valid:` PRIMARYCARE` Wajib: Ya ** [Tags](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html). Tipe: Array objek [Tag](API_Tag.md) Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 200 item. Wajib: Tidak ** [Type](#API_StartMedicalTranscriptionJob_RequestSyntax) ** 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](#API_StartMedicalTranscriptionJob_ResponseSyntax) ** Memberikan informasi rinci tentang pekerjaan transkripsi medis saat ini, termasuk status pekerjaan dan, jika berlaku, alasan kegagalan. Tipe: Objek [MedicalTranscriptionJob](API_MedicalTranscriptionJob.md) ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md). ** 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: + [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK untuk JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartMedicalTranscriptionJob)