Ringkasan Cloud Translation API

Cloud Translation API dapat menerjemahkan teks untuk lebih dari 100 pasangan bahasa. Jika Anda tidak tahu bahasa teks sumber, Cloud Translation API dapat mendeteksinya untuk Anda. Untuk mengetahui daftar semua bahasa yang didukung, lihat Bahasa yang didukung.

Sebagai organisasi perusahaan, Anda dapat menyertakan teks terjemahan dalam alur kerja internal yang ada. Misalnya, Anda mungkin memiliki tim dukungan global yang menerima kasus pelanggan dalam berbagai bahasa. Anda dapat menambahkan Cloud Translation API ke dalam alur kerja Anda untuk menerjemahkan kasus pelanggan tersebut ke dalam bahasa yang digunakan oleh anggota tim dukungan Anda. Dengan menggunakan Cloud Translation API, Anda meningkatkan efisiensi tim dukungan secara keseluruhan karena mereka tidak perlu menerjemahkan teks secara manual atau mengandalkan orang lain.

Cloud Translation API dapat diskalakan dengan lancar dan memungkinkan terjemahan karakter tanpa batas per hari. Namun, ada batasan ukuran konten untuk tiap permintaan dan rasio permintaan. Selain itu, Anda dapat menggunakan batas kuota untuk mengelola anggaran. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.

Cloud Translation API hadir dalam dua edisi berbeda, yaitu edisi Basic dan edisi Advanced. Untuk mengetahui daftar berbagai fitur yang didukung oleh setiap edisi, lihat perbandingan edisi.

Cloud Translation - Basic API

Edisi Basic diakses melalui library klien v2, dan memerlukan konfigurasi minimal. API ini menerima kunci API untuk autentikasi serta akun layanan, dan menggunakan model Neural Machine Translation (NMT) terlatih dari Google tanpa modifikasi. Basic akan cocok untuk aplikasi yang perlu menerjemahkan konten buatan pengguna kasual seperti chat, media sosial, atau komentar.

Secara default, Cloud Translation API menggunakan edisi Basic, yang diupdate Google pada ritme semi-reguler seiring ketersediaan lebih banyak data pelatihan dan teknik yang lebih baik.

Namun, jika Anda merencanakan project baru, sebaiknya pilih edisi Advanced untuk memanfaatkan keamanan yang lebih baik, lebih banyak fitur, dan peningkatan layanan baru yang akan terus dilakukan oleh edisi Advanced.

Cloud Translation - Advanced API

Edisi Advanced diakses melalui library klien v3 dan memerlukan autentikasi akun layanan yang terintegrasi dengan peran IAM. Layanan ini menawarkan pilihan model, termasuk model LLM Terjemahan, model NMT, dan penyesuaian NMT. Selain itu, API ini menyediakan fitur seperti glosarium, terjemahan batch, terjemahan dokumen, dan lainnya.

Fitur utama Cloud Translation - Advanced API adalah:

  • Akses ke lebih banyak model - Pilih model yang tepat untuk Anda dari antara model terjemahan canggih seperti Translation LLM, model Terjemahan Mesin Neural (NMT) Google, model Terjemahan Adaptif, atau model NMT kustom yang dibuat oleh Anda atau orang lain.

  • Glosarium - Buat kamus khusus untuk menerjemahkan istilah khusus domain dengan benar dan konsisten.

  • Permintaan batch - Buat permintaan asinkron untuk menerjemahkan teks dalam jumlah besar.

  • Terjemahan Dokumen - Menerjemahkan dokumen, seperti file PDF, untuk mempertahankan format dan tata letak asli.

  • Peran IAM - Amankan permintaan terjemahan Anda dengan menggunakan Identity and Access Management. Buat akun layanan dan berikan izin dengan menambahkan peran IAM. Cloud Translation - Advanced API tidak mendukung kunci API.

  • Label - Tambahkan label yang ditentukan pengguna (key-value pair) ke permintaan terjemahan untuk melacak penggunaan dengan lebih baik dan mendapatkan laporan penagihan terperinci.

  • Endpoint regional - Lakukan kontrol atas lokasi penyimpanan dan pemrosesan resource untuk project Anda.

Glosarium

Glosarium adalah kamus kustom yang digunakan Cloud Translation - Advanced API untuk menerjemahkan istilah spesifik domain, entity bernama, dan jenis istilah lainnya yang spesifik bagi Anda dengan benar dan konsisten. Misalnya, Anda dapat menggunakan glosarium untuk menentukan terjemahan istilah tertentu, seperti "Google Summer of Code", "mode rahasia Gmail", atau "laporan performa penempatan".

Anda juga dapat menggunakan glosarium untuk mencegah penerjemahan kata tertentu, seperti kata yang dipinjam atau nama produk. Untuk mengetahui informasi tentang cara menggunakan glosarium, lihat Membuat dan menggunakan glosarium.

Permintaan batch

Permintaan terjemahan batch adalah permintaan asinkron yang menerjemahkan input dari bucket Cloud Storage. Cloud Translation - Advanced API melakukan terjemahan batch sebagai operasi yang berjalan lama dan menulis output ke bucket Cloud Storage yang Anda tentukan. Permintaan inline untuk terjemahan batch tidak didukung.

Untuk mengetahui informasi tentang cara membuat permintaan batch, lihat Permintaan batch (Lanjutan).

Terjemahan Dokumen

Dengan Terjemahan Dokumen, Anda dapat langsung menerjemahkan dokumen yang sudah ada, seperti file PDF dan DOCX, ke bahasa target. Terjemahan Dokumen mempertahankan format aslinya sehingga dokumen yang diterjemahkan memiliki tata letak dan format yang sama dengan dokumen aslinya. Misalnya, Terjemahan Dokumen mempertahankan jeda paragraf dan judul, sehingga konten terjemahan Anda dibagi seperti dalam dokumen asli.

Fitur Cloud Translation - Advanced API, seperti glosarium dan model AutoML, juga berfungsi dengan Terjemahan Dokumen. Misalnya, jika Anda sudah memiliki model AutoML yang digunakan untuk terjemahan teks, Anda dapat menggunakan model yang sama untuk Terjemahan Dokumen. Untuk mengetahui informasi selengkapnya tentang jenis file yang didukung dan cara menerjemahkan dokumen, lihat Menerjemahkan dokumen.

Pemilihan model dan model AutoML

Pemilihan model Cloud Translation - Advanced API memungkinkan Anda memilih model yang tepat secara dinamis untuk aplikasi Anda dari antara Translation LLM (yang juga dapat Anda sesuaikan lebih lanjut untuk terjemahan adaptif), model NMT Google, atau model AutoML Translation kustom, bergantung pada konteks dan konten yang Anda terjemahkan.

Buat model kustom dengan menggunakan AutoML Translation untuk mendapatkan terjemahan yang lebih akurat untuk terminologi khusus domain. Anda kemudian dapat menggunakan model yang dihasilkan di Cloud Translation - Advanced API untuk menerjemahkan teks.

Untuk mengetahui informasi tentang cara menggunakan model kustom untuk menerjemahkan teks, lihat Menerjemahkan teks (Lanjutan).

Peran IAM

Cloud Translation - Advanced API terintegrasi dengan IAM untuk memberikan keamanan tambahan untuk permintaan terjemahan Anda, memungkinkan kontrol akses yang mendetail, dan mendukung integrasi dengan AutoML Translation.

Anda harus menambahkan pengguna dan akun layanan ke salah satu peran berikut untuk memberi akun tersebut akses ke Cloud Translation - Advanced API. Untuk mengetahui informasi tentang cara membuat akun layanan, lihat Membuat dan mengelola akun layanan dalam dokumentasi IAM.

Peran ID Peran Deskripsi
Cloud Translation API Viewer roles/cloudtranslate.viewer Dapat mengakses operasi get dan daftar.
Cloud Translation API User roles/cloudtranslate.user

Mencakup izin roles/cloudtranslate.viewer. Dapat menerjemahkan teks menggunakan model NMT dan AutoML Translation dalam mode online dan asinkron (batch). Dapat menggunakan Document Translation. Dapat mendeteksi bahasa. Dapat mencantumkan bahasa yang didukung untuk model NMT dan AutoML Translation. Dapat menggunakan glosarium untuk terjemahan.
Cloud Translation API Editor roles/cloudtranslate.editor

Mencakup izin roles/cloudtranslate.user, dan dapat membuat serta menghapus glosarium, serta membatalkan atau menghapus operasi yang berjalan lama.
Cloud Translation API Admin roles/cloudtranslate.admin

Mencakup izin roles/cloudtranslate.editor, dan dapat menetapkan kebijakan IAM dan memberikan izin IAM untuk Cloud Translation API. Memiliki semua izin IAM untuk Cloud Translation API.

Untuk melihat daftar izin yang terdapat dalam setiap peran, lihat Memahami peran.

Peran yang telah dikonfigurasi sebelumnya untuk banyak kasus penggunaan umum. Namun, Anda mungkin memerlukan peran yang menyertakan sekumpulan izin khusus. Misalnya, Anda mungkin ingin membuat peran yang memungkinkan pengguna membuat glosarium dalam project, tanpa mengizinkan mereka menghapus atau memperbarui glosarium yang ada dalam project. Dalam kasus tersebut, Anda dapat membuat peran khusus IAM yang memenuhi kebutuhan Anda.

Untuk mengetahui informasi tentang cara mengelola peran IAM, lihat bagian Memberikan, mengubah, dan mencabut akses ke resource dan Memberikan peran ke akun layanan.

Label

Cloud Translation - Advanced API mendukung penambahan label yang ditentukan pengguna (key-value pair) ke permintaan TranslateText, BatchTranslateText, dan DetectLanguage. Informasi tentang penggunaan permintaan diteruskan ke sistem penagihan, yang dapat Anda gunakan untuk mengelompokkan biaya penagihan dengan memfilter label.

Untuk mengetahui informasi selengkapnya tentang label yang ditentukan pengguna, lihat Melaporkan penggunaan dengan label (Lanjutan).

Endpoint regional

Secara default, Cloud Translation - Advanced API menyimpan dan memproses resource di lokasi global, yang berarti tidak ada jaminan bahwa resource tetap berada di dalam lokasi tertentu. Daripada menggunakan endpoint global default, Anda dapat menggunakan endpoint regional untuk mempertahankan resource dalam lokasi tertentu, seperti Uni Eropa. Untuk mengetahui informasi selengkapnya, lihat artikel Menentukan endpoint regional.

Perbandingan edisi

Tabel berikut menunjukkan fitur yang tersedia di tiap edisi.

Fitur Dasar Lanjutan
Menerjemahkan dengan model NMT
Menerjemahkan dengan LLM Terjemahan
Menerjemahkan dengan model Terjemahan Adaptif
Menerjemahkan dengan model kustom
Menerjemahkan beberapa string dalam satu permintaan
Terjemahan dalam batch dengan Cloud Storage
Menerjemahkan dokumen
Dukungan glosarium (kontrol terhadap terminologi)
Melatih model kustom
Deteksi Bahasa
REST API terintegrasi
gRPC API terintegrasi
Akun Layanan
Kunci API
Logging audit
Mendukung HTML
Mendukung Lebih dari 100 Bahasa
Dukungan pengubahan karakter ke dalam aksara Latin
Dukungan transliterasi
Terjemahan Adaptif
Dukungan endpoint multi-regional
Dukungan Kontrol Layanan VPC

Lihat Fitur Cloud Translation - Advanced API untuk mengetahui detail selengkapnya tentang Cloud Translation - Advanced API.

Harga

Cloud Translation API memberikan tagihan kepada Anda setiap bulan berdasarkan jumlah karakter yang Anda kirim. Untuk mengetahui informasi selengkapnya, lihat Harga.

Referensi dan bacaan lebih lanjut