Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateVocabularyFilter
Membuat filter kosakata kustom baru.
Anda dapat menggunakan filter kosakata khusus untuk menutupi, menghapus, atau menandai kata-kata tertentu dari transkrip Anda. Filter kosakata khusus biasanya digunakan untuk menutupi kata-kata kotor dalam transkrip.
Setiap bahasa memiliki kumpulan karakter yang berisi semua karakter yang diizinkan untuk bahasa tertentu. Jika Anda menggunakan karakter yang tidak didukung, permintaan filter kosakata kustom Anda gagal. Lihat Set Karakter untuk Kosakata Kustom untuk mengatur karakter untuk bahasa Anda.
Untuk informasi selengkapnya, lihat Penyaringan kosakata.
Sintaksis Permintaan
{
"LanguageCode": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"VocabularyFilterFileUri": "string
",
"VocabularyFilterName": "string
",
"Words": [ "string
" ]
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- LanguageCode
-
Kode bahasa yang mewakili bahasa entri dalam filter kosakata Anda. Setiap filter kosakata khusus harus berisi istilah hanya dalam satu bahasa.
Filter kosakata khusus hanya dapat digunakan untuk mentranskripsikan file dalam bahasa yang sama dengan filter. Misalnya, jika Anda membuat filter kosakata khusus menggunakan bahasa Inggris AS (
en-US
), Anda hanya dapat menerapkan filter ini ke file yang berisi audio bahasa Inggris.Untuk daftar bahasa yang didukung dan kode bahasa terkait, lihat tabel Bahasa yang didukung.
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
- Tags
-
Menambahkan satu atau lebih tag kustom, masing-masing dalam bentuk pasangan key:value, ke filter kosakata kustom baru pada saat Anda membuat filter kosakata baru ini.
Untuk mempelajari lebih lanjut tentang penggunaan tag dengan Amazon Transcribe, lihat Tagging sumber daya.
Tipe: Array objek Tag
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 200 item.
Wajib: Tidak
- VocabularyFilterFileUri
-
Lokasi Amazon S3 dari file teks yang berisi istilah filter kosakata kustom Anda. URI harus ditempatkanWilayah AWS sama dengan sumber daya yang Anda panggil.
Inilah contoh jalur URI:
s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt
Perhatikan bahwa jika Anda menyertakan
VocabularyFilterFileUri
dalam permintaan Anda, Anda tidak dapat menggunakanWords
; Anda harus memilih satu atau yang lain.Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2000.
Pola:
(s3://|http(s*)://).+
Wajib: Tidak
- VocabularyFilterName
-
Nama unik, dipilih oleh Anda, untuk filter kosakata kustom baru Anda.
Nama ini peka huruf besar, tidak dapat berisi spasi, dan harus unik dalam sebuahAkun AWS. Jika Anda mencoba membuat filter kosakata kustom baru dengan nama yang sama dengan filter kosakata kustom yang ada, Anda mendapatkan
ConflictException
kesalahan.Jenis: String
Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.
Pola:
^[0-9a-zA-Z._-]+
Diperlukan: Ya
- Words
-
Gunakan parameter ini jika Anda ingin membuat filter kosakata khusus dengan menyertakan semua istilah yang diinginkan, sebagai nilai yang dipisahkan koma, dalam permintaan Anda. Opsi lain untuk membuat filter kosakata Anda adalah menyimpan entri Anda dalam file teks dan mengunggahnya ke bucket Amazon S3, lalu tentukan lokasi file Anda menggunakan
VocabularyFilterFileUri
parameter.Perhatikan bahwa jika Anda menyertakan
Words
dalam permintaan Anda, Anda tidak dapat menggunakanVocabularyFilterFileUri
; Anda harus memilih satu atau yang lain.Setiap bahasa memiliki kumpulan karakter yang berisi semua karakter yang diizinkan untuk bahasa tertentu. Jika Anda menggunakan karakter yang tidak didukung, permintaan filter kosakata kustom Anda gagal. Lihat Set Karakter untuk Kosakata Kustom untuk mengatur karakter untuk bahasa Anda.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item.
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.
Wajib: Tidak
Sintaksis Respons
{
"LanguageCode": "string",
"LastModifiedTime": number,
"VocabularyFilterName": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- LanguageCode
-
Kode bahasa yang Anda pilih untuk filter kosakata khusus Anda.
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
- LastModifiedTime
-
Tanggal dan waktu Anda membuat filter kosakata khusus Anda.
Cap waktu dalam format
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC
. Misalnya,2022-05-04T12:32:58.761000-07:00
mewakili 12:32 PM UTC-7 pada 4 Mei 2022.Tipe: Timestamp
- VocabularyFilterName
-
Nama yang Anda pilih untuk filter kosakata khusus Anda.
Jenis: String
Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.
Pola:
^[0-9a-zA-Z._-]+
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 harus unik di 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: