Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # StartTranscriptionJob Mentranskripsikan audio dari file media dan menerapkan Parameter Permintaan tambahan yang Anda pilih untuk disertakan dalam permintaan Anda. Untuk membuat`StartTranscriptionJob` permintaan, Anda harus terlebih dahulu mengunggah file media Anda ke bucket Amazon S3; Anda kemudian dapat menentukan lokasi Amazon S3 file menggunakan`Media` parameter. Anda harus menyertakan parameter berikut dalam`StartTranscriptionJob` 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). + `TranscriptionJobName`: Nama kustom yang Anda buat untuk pekerjaan transkripsi Anda yang unik dalam diri AndaAkun AWS. + `Media`(`MediaFileUri`): Lokasi Amazon S3 dari file media Anda. + Salah satu`LanguageCode`,`IdentifyLanguage`, atau`IdentifyMultipleLanguages`: Jika Anda tahu bahasa file media Anda, tentukan menggunakan`LanguageCode` parameter; Anda dapat menemukan semua kode bahasa yang valid di tabel [Bahasa yang didukung](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Jika Anda tidak tahu bahasa yang digunakan di media Anda, gunakan salah satu`IdentifyLanguage` atau`IdentifyMultipleLanguages` dan biarkan Amazon Transcribe mengidentifikasi bahasa untuk Anda. ## Sintaksis Permintaan ``` { "ContentRedaction": { "PiiEntityTypes": [ "{{string}}" ], "RedactionOutput": "{{string}}", "RedactionType": "{{string}}" }, "IdentifyLanguage": {{boolean}}, "IdentifyMultipleLanguages": {{boolean}}, "JobExecutionSettings": { "AllowDeferredExecution": {{boolean}}, "DataAccessRoleArn": "{{string}}" }, "KMSEncryptionContext": { "{{string}}" : "{{string}}" }, "LanguageCode": "{{string}}", "LanguageIdSettings": { "{{string}}" : { "LanguageModelName": "{{string}}", "VocabularyFilterName": "{{string}}", "VocabularyName": "{{string}}" } }, "LanguageOptions": [ "{{string}}" ], "Media": { "MediaFileUri": "{{string}}", "RedactedMediaFileUri": "{{string}}" }, "MediaFormat": "{{string}}", "MediaSampleRateHertz": {{number}}, "ModelSettings": { "LanguageModelName": "{{string}}" }, "OutputBucketName": "{{string}}", "OutputEncryptionKMSKeyId": "{{string}}", "OutputKey": "{{string}}", "Settings": { "ChannelIdentification": {{boolean}}, "MaxAlternatives": {{number}}, "MaxSpeakerLabels": {{number}}, "ShowAlternatives": {{boolean}}, "ShowSpeakerLabels": {{boolean}}, "VocabularyFilterMethod": "{{string}}", "VocabularyFilterName": "{{string}}", "VocabularyName": "{{string}}" }, "Subtitles": { "Formats": [ "{{string}}" ], "OutputStartIndex": {{number}} }, "Tags": [ { "Key": "{{string}}", "Value": "{{string}}" } ], "TranscriptionJobName": "{{string}}" } ``` ## Parameter Permintaan Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [ContentRedaction](#API_StartTranscriptionJob_RequestSyntax) ** Memungkinkan untuk menyunting atau menandai informasi identitas pribadi tertentu (PII) dalam transkrip Anda. Jika Anda menggunakan`ContentRedaction`, Anda juga harus menyertakan sub-parameter:`PiiEntityTypes`,`RedactionOutput`, dan`RedactionType`. Tipe: Objek [ContentRedaction](API_ContentRedaction.md) Wajib: Tidak ** [IdentifyLanguage](#API_StartTranscriptionJob_RequestSyntax) ** Memungkinkan identifikasi bahasa otomatis dalam permintaan pekerjaan transkripsi Anda. Gunakan parameter ini jika file media Anda hanya berisi satu bahasa. Jika media Anda berisi beberapa bahasa, gunakan`IdentifyMultipleLanguages` sebagai gantinya. Jika Anda menyertakan`IdentifyLanguage`, Anda dapat secara opsional menyertakan daftar kode bahasa, menggunakan`LanguageOptions`, yang menurut Anda mungkin ada di file media Anda. Termasuk`LanguageOptions` pembatasan`IdentifyLanguage` hanya opsi bahasa yang Anda tentukan, yang dapat meningkatkan akurasi transkripsi. Jika Anda ingin menerapkan model bahasa khusus, kosakata khusus, atau filter kosakata khusus ke permintaan identifikasi bahasa otomatis Anda, sertakan`LanguageIdSettings` dengan sub-parameter yang relevan (`VocabularyName`,`LanguageModelName`, dan`VocabularyFilterName`). Jika Anda memasukkan`LanguageIdSettings`, juga termasuk`LanguageOptions`. Perhatikan bahwa Anda harus menyertakan salah satu`LanguageCode`,`IdentifyLanguage`, atau`IdentifyMultipleLanguages` dalam permintaan Anda. Jika Anda menyertakan lebih dari satu parameter ini, tugas transkripsi Anda akan dienkripsi. Tipe: Boolean Wajib: Tidak ** [IdentifyMultipleLanguages](#API_StartTranscriptionJob_RequestSyntax) ** Memungkinkan identifikasi multi-bahasa otomatis dalam permintaan pekerjaan transkripsi Anda. Gunakan parameter ini jika file media Anda berisi lebih dari satu bahasa. Jika media Anda hanya berisi satu bahasa, gunakan`IdentifyLanguage` sebagai gantinya. Jika Anda menyertakan`IdentifyMultipleLanguages`, Anda dapat secara opsional menyertakan daftar kode bahasa, menggunakan`LanguageOptions`, yang menurut Anda mungkin ada di file media Anda. Termasuk`LanguageOptions` pembatasan`IdentifyLanguage` hanya opsi bahasa yang Anda tentukan, yang dapat meningkatkan akurasi transkripsi. Jika Anda ingin menerapkan kosakata khusus atau filter kosakata khusus ke permintaan identifikasi bahasa otomatis Anda, sertakan`LanguageIdSettings` dengan sub-parameter yang relevan (`VocabularyName`dan`VocabularyFilterName`). Jika Anda memasukkan`LanguageIdSettings`, juga termasuk`LanguageOptions`. Perhatikan bahwa Anda harus menyertakan salah satu`LanguageCode`,`IdentifyLanguage`, atau`IdentifyMultipleLanguages` dalam permintaan Anda. Jika Anda menyertakan lebih dari satu parameter ini, tugas transkripsi Anda akan dienkripsi. Tipe: Boolean Wajib: Tidak ** [JobExecutionSettings](#API_StartTranscriptionJob_RequestSyntax) ** Memungkinkan untuk mengontrol bagaimana pekerjaan transkripsi Anda diproses. Saat ini, satu-satunya`JobExecutionSettings` modifikasi yang dapat Anda pilih adalah mengaktifkan antrian pekerjaan menggunakan`AllowDeferredExecution` sub-parameter. Jika Anda menyertakan`JobExecutionSettings` dalam permintaan Anda, Anda juga harus menyertakan sub-parameter:`AllowDeferredExecution` dan`DataAccessRoleArn`. Tipe: Objek [JobExecutionSettings](API_JobExecutionSettings.md) Wajib: Tidak ** [KMSEncryptionContext](#API_StartTranscriptionJob_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: 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_StartTranscriptionJob_RequestSyntax) ** Kode bahasa yang mewakili bahasa yang digunakan dalam file media input. Jika Anda tidak yakin dengan bahasa yang digunakan dalam file media Anda, pertimbangkan`IdentifyMultipleLanguages` untuk menggunakan`IdentifyLanguage` atau mengaktifkan identifikasi bahasa otomatis. Perhatikan bahwa Anda harus menyertakan salah satu`LanguageCode`,`IdentifyLanguage`, atau`IdentifyMultipleLanguages` dalam permintaan Anda. Jika Anda menyertakan lebih dari satu parameter ini, tugas transkripsi Anda akan dienkripsi. Untuk daftar bahasa yang didukung dan kode bahasa terkait, lihat tabel [Bahasa yang didukung](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Untuk mentranskripsikan pidato dalam Bahasa Arab Standar Modern (`ar-SA`), file media Anda harus dikodekan dengan kecepatan sampel 16.000 Hz atau lebih tinggi. Jenis: String Nilai yang 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: Tidak ** [LanguageIdSettings](#API_StartTranscriptionJob_RequestSyntax) ** Jika menggunakan identifikasi bahasa otomatis dalam permintaan Anda dan Anda ingin menerapkan model bahasa kustom, kosakata khusus, atau filter kosakata kustom, sertakan`LanguageIdSettings` dengan sub-parameter yang relevan (`VocabularyName`,`LanguageModelName`, dan`VocabularyFilterName`). Perhatikan bahwa identifikasi multi-bahasa (`IdentifyMultipleLanguages`) tidak mendukung model bahasa khusus. `LanguageIdSettings`mendukung dua sampai lima kode bahasa. Setiap kode bahasa yang Anda sertakan dapat memiliki model bahasa khusus terkait, kosakata khusus, dan filter kosakata khusus. Kode bahasa yang Anda tentukan harus sesuai dengan bahasa model bahasa kustom terkait, kosakata khusus, dan filter kosakata khusus. Dianjurkan agar Anda menyertakan`LanguageOptions` saat menggunakan`LanguageIdSettings` untuk memastikan bahwa dialek bahasa yang benar diidentifikasi. Misalnya, jika Anda menentukan kosakata khusus yang ada,`en-US` tetapi Amazon Transcribe menentukan bahwa bahasa yang digunakan di media Anda`en-AU`, kosakata khusus Anda *tidak diterapkan* pada transkripsi Anda. Jika Anda menyertakan`LanguageOptions` dan menyertakan`en-US` sebagai satu-satunya dialek bahasa Inggris, kosakata khusus Anda *diterapkan* pada transkripsi Anda. Jika Anda ingin menyertakan model bahasa kustom dengan permintaan Anda tetapi **tidak** ingin menggunakan identifikasi bahasa otomatis, gunakan sebagai gantinya` ModelSettings ` parameter dengan`LanguageModelName` sub-parameter. Jika Anda ingin menyertakan kosakata khusus atau filter kosakata khusus (atau keduanya) dengan permintaan Anda tetapi **tidak** ingin menggunakan identifikasi bahasa otomatis, gunakan sebagai gantinya` Settings ` parameter dengan`VocabularyName` atau`VocabularyFilterName` (atau keduanya) sub-parameter. Tipe: Peta string ke[LanguageIdSettings](API_LanguageIdSettings.md) objek Entri Peta: Jumlah maksimum 5 item. Kunci yang 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: Tidak ** [LanguageOptions](#API_StartTranscriptionJob_RequestSyntax) ** Anda dapat menentukan dua atau lebih kode bahasa yang mewakili bahasa yang menurut Anda mungkin ada di media Anda. Termasuk lebih dari lima tidak dianjurkan. Jika Anda tidak yakin bahasa apa yang ada, jangan sertakan parameter ini. Jika Anda menyertakan`LanguageOptions` dalam permintaan Anda, Anda juga harus menyertakan`IdentifyLanguage`. Untuk informasi selengkapnya, lihat [Bahasa yang didukung](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Untuk mentranskripsikan pidato dalam Bahasa Arab Standar Modern (`ar-SA`), file media Anda harus dikodekan dengan kecepatan sampel 16.000 Hz atau lebih tinggi. Tipe: Array string Anggota Array: Jumlah minimum 1 item. Nilai yang 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: Tidak ** [Media](#API_StartTranscriptionJob_RequestSyntax) ** Menjelaskan lokasi Amazon S3 dari file media yang ingin Anda gunakan dalam permintaan Anda. Tipe: Objek [Media](API_Media.md) Wajib: Ya ** [MediaFormat](#API_StartTranscriptionJob_RequestSyntax) ** Tentukan format file media input Anda. Jenis: String Nilai yang Valid:` mp3 | mp4 | wav | flac | ogg | amr | webm` Wajib: Tidak ** [MediaSampleRateHertz](#API_StartTranscriptionJob_RequestSyntax) ** Tingkat sampel, dalam hertz, dari trek audio dalam file media input Anda. Jika Anda tidak menentukan laju sampel media, Amazon Transcribe menentukannya untuk Anda. Jika Anda menentukan laju sampel, laju sampel harus sesuai dengan laju yang terdeteksi oleh Amazon Transcribe. Jika ada ketidakcocokan antara nilai yang Anda tentukan dan nilai yang terdeteksi, pekerjaan Anda gagal. Dalam kebanyakan kasus, Anda dapat menghilangkan`MediaSampleRateHertz` dan membiarkan Amazon Transcribe menentukan laju sampel. Tipe: Bilangan Bulat Rentang yang Valid: Nilai minimum 8000. Nilai maksimum 48000. Wajib: Tidak ** [ModelSettings](#API_StartTranscriptionJob_RequestSyntax) ** Tentukan model bahasa khusus yang ingin Anda sertakan dengan pekerjaan transkripsi Anda. Jika Anda menyertakan`ModelSettings` dalam permintaan Anda, Anda harus menyertakan`LanguageModelName` sub-parameter. Untuk informasi selengkapnya, lihat [Model bahasa kustom](https://docs.aws.amazon.com/transcribe/latest/dg/custom-language-models.html). Tipe: Objek [ModelSettings](API_ModelSettings.md) Wajib: Tidak ** [OutputBucketName](#API_StartTranscriptionJob_RequestSyntax) ** Nama bucket Amazon S3 tempat Anda ingin output transkripsi 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). Jika Anda tidak menentukan`OutputBucketName`, transkrip Anda ditempatkan di bucket Amazon S3 yang dikelola layanan dan Anda diberikan URI untuk mengakses transkrip Anda. Jenis: String Batasan Panjang: maksimum 64. Pola: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` Wajib: Tidak ** [OutputEncryptionKMSKeyId](#API_StartTranscriptionJob_RequestSyntax) ** Kunci KMS yang ingin Anda gunakan untuk mengenkripsi output transkripsi 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 (S3) default. 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_StartTranscriptionJob_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 Anda (`TranscriptionJobName`). 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`TranscriptionJobName`, '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`TranscriptionJobName`, '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_StartTranscriptionJob_RequestSyntax) ** Tentukan pengaturan opsional tambahan dalam[StartTranscriptionJob](#API_StartTranscriptionJob) permintaan Anda, termasuk identifikasi saluran, transkripsi alternatif, partisi speaker. Anda dapat menggunakannya untuk menerapkan kosakata khusus dan filter kosakata. Jika Anda ingin menyertakan kosakata khusus atau filter kosakata khusus (atau keduanya) dengan permintaan Anda tetapi **tidak** ingin menggunakan identifikasi bahasa otomatis, gunakan`Settings` dengan`VocabularyName` atau`VocabularyFilterName` (atau keduanya) sub-parameter. Jika Anda menggunakan identifikasi bahasa otomatis dengan permintaan Anda dan ingin menyertakan model bahasa kustom, kosakata khusus, atau filter kosakata khusus, gunakan sebagai gantinya` LanguageIdSettings ` parameter dengan`LanguageModelName`,`VocabularyName` atau`VocabularyFilterName` sub-parameter. Tipe: Objek [Settings](API_Settings.md) Wajib: Tidak ** [Subtitles](#API_StartTranscriptionJob_RequestSyntax) ** Menghasilkan file subtitle untuk media input Anda. Anda dapat menentukan format WebVTT (\*.vtt) dan SubRip (\*.srt). Tipe: Objek [Subtitles](API_Subtitles.md) Wajib: Tidak ** [Tags](#API_StartTranscriptionJob_RequestSyntax) ** Menambahkan satu atau lebih tag kustom, masing-masing dalam bentuk pasangan key:value, ke pekerjaan transkripsi baru pada saat Anda memulai pekerjaan baru ini. Untuk mempelajari lebih lanjut tentang penggunaan tag dengan Amazon Transcribe, lihat [sumber 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 ** [TranscriptionJobName](#API_StartTranscriptionJob_RequestSyntax) ** Nama unik, dipilih oleh Anda, untuk pekerjaan transkripsi 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 ## Sintaksis Respons ``` { "TranscriptionJob": { "CompletionTime": number, "ContentRedaction": { "PiiEntityTypes": [ "string" ], "RedactionOutput": "string", "RedactionType": "string" }, "CreationTime": number, "FailureReason": "string", "IdentifiedLanguageScore": number, "IdentifyLanguage": boolean, "IdentifyMultipleLanguages": boolean, "JobExecutionSettings": { "AllowDeferredExecution": boolean, "DataAccessRoleArn": "string" }, "LanguageCode": "string", "LanguageCodes": [ { "DurationInSeconds": number, "LanguageCode": "string" } ], "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageOptions": [ "string" ], "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "ModelSettings": { "LanguageModelName": "string" }, "Settings": { "ChannelIdentification": boolean, "MaxAlternatives": number, "MaxSpeakerLabels": number, "ShowAlternatives": boolean, "ShowSpeakerLabels": boolean, "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" }, "StartTime": number, "Subtitles": { "Formats": [ "string" ], "OutputStartIndex": number, "SubtitleFileUris": [ "string" ] }, "Tags": [ { "Key": "string", "Value": "string" } ], "Transcript": { "RedactedTranscriptFileUri": "string", "TranscriptFileUri": "string" }, "TranscriptionJobName": "string", "TranscriptionJobStatus": "string" } } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [TranscriptionJob](#API_StartTranscriptionJob_ResponseSyntax) ** Memberikan informasi rinci tentang pekerjaan transkripsi saat ini, termasuk status pekerjaan dan, jika berlaku, alasan kegagalan. Tipe: Objek [TranscriptionJob](API_TranscriptionJob.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 ini 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/StartTranscriptionJob) + [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK untuk JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartTranscriptionJob)