Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

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

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 menyertakanVocabularyFilterFileUri 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 mendapatkanConflictException 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 menggunakanVocabularyFilterFileUri parameter.

Perhatikan bahwa jika Anda menyertakanWords dalam permintaan Anda, Anda tidak dapat menggunakanVocabularyFilterFileUri; Anda harus memilih satu atau yang lain.

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

LastModifiedTime

Tanggal dan waktu Anda membuat filter kosakata khusus Anda.

Cap waktu dalam formatYYYY-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 (sepertiIN 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:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CreateVocabulary

DeleteCallAnalyticsCategory