Cloud Translation menerapkan kuota pada ukuran konten permintaan dan jumlah permintaan yang dapat Anda kirim. Kuota melindungi komunitas pengguna Google Cloud dengan mencegah lonjakan penggunaan yang tidak terduga. Anda juga dapat mengurangi kuota untuk mencegah penggunaan yang berlebihan dan mengontrol biaya.
Jika Anda melebihi kuota, Cloud Translation akan menampilkan error 403.
Pesan error akan muncul dengan teks Daily Limit Exceeded jika Anda melampaui kuota harian atau User Rate Limit Exceeded jika Anda melampaui kuota per menit.
Kuota harian direset pada tengah malam Waktu Pasifik, yang berarti kuota baru dapat memerlukan waktu hingga 24 jam untuk diterapkan.
Menetapkan kuota penggunaan
Secara default, jumlah karakter yang dapat Anda kirim per hari tidak terbatas. Jika Anda memiliki anggaran yang ditetapkan, sebaiknya pantau penggunaan harian dan sesuaikan kuota sesuai dengan rencana pengeluaran Anda.
Anda dapat mengedit kuota menggunakan halaman kuota Konsol Google Cloud. Kuota v2 berlaku untuk Cloud Translation - Basic dan kuota v3 berlaku untuk Cloud Translation - Advanced.
Kuota konten
Kuota konten berlaku bagi permintaan sinkron untuk metode translateText,
detectLanguage, dan translateDocument. Untuk permintaan asinkron, seperti terjemahan teks batch, hanya kuota permintaan yang berlaku.
Semua karakter yang Anda kirim ke Cloud Translation API diperhitungkan dalam kuota konten, termasuk karakter spasi kosong. Jika Anda menggunakan Cloud Translation - Basic dan Cloud Translation - Advanced secara bersamaan, kuota ini bersifat kumulatif.
Untuk terjemahan teks, kuota model kustom dihitung secara terpisah dan tidak diperhitungkan dalam kuota model umum. Namun, ada batasan jumlah model kustom yang diminta dalam satu hari dari sebuah project.
| Kuota | Default |
|---|---|
| Karakter yang dikirim ke model umum per project per hari (v2 dan v3) | tak terbatas |
| Karakter yang dikirim ke model umum per project per menit (v2 dan v3) | 6.000.000 |
| Karakter yang dikirim ke model umum per project per menit per pengguna (v2 dan v3) | 6.000.000 |
| Karakter yang dikirim untuk transliterasi per project per menit (v3) | 100.000 (mengurangi kuota karakter yang dikirim ke model umum per project per menit) |
| Karakter yang dikirim untuk diubah ke dalam aksara latin per project per menit (v3) | 100.000 |
| Karakter yang dikirim ke model kustom per project per menit (v3) | 100.000 |
| Karakter yang dikirim ke model kustom per project per menit per pengguna (v3) | hingga batas project |
| Jumlah model kustom unik yang dipanggil per project per hari (v3) | 30 |
| Untuk terjemahan dokumen, halaman yang dikirim per project per menit (v3) | 2.400 |
| Untuk terjemahan dokumen, halaman yang dikirim per project per menit per pengguna (v3) | 2.400 |
Kuota per pengguna berlaku untuk jumlah permintaan yang dapat dibuat per menit oleh pengguna akhir yang menggunakan aplikasi klien. Saat Anda menggunakan akun layanan, identitas akun layanan adalah pengguna, untuk tujuan penghitungan konsumsi kuota. Jika Anda menggunakan Cloud Translation - Basic dan Kunci API, Cloud Translation akan menggunakan alamat IP klien untuk menerapkan batas ini.
Batas konten per permintaan
Cloud Translation API dioptimalkan untuk menerjemahkan permintaan yang lebih kecil. Panjang maksimum yang direkomendasikan untuk setiap permintaan adalah 5 ribu karakter (poin kode). Namun, semakin banyak karakter yang Anda sertakan, semakin tinggi latensi respons. Untuk Cloud Translation - Advanced, jumlah maksimum poin kode untuk satu permintaan adalah 30 ribu. Cloud Translation - Basic memiliki ukuran permintaan maksimum sebesar 100 ribu byte. Opsi alternatifnya adalah menggunakan terjemahan batch untuk mengirim lebih banyak konten per permintaan sebagai operasi yang berjalan lama.
Cloud Translation API menolak permintaan yang lebih besar dari jumlah maksimum dan memberikan error 400 INVALID_ARGUMENT, terlepas dari kuota yang tersedia.
Meminta kuota
Cloud Translation menerapkan kuota pada jumlah permintaan yang dapat Anda kirim ke layanan. Kuota ini berlaku untuk semua panggilan metode Cloud Translation, kecuali untuk metode translateDocument dan getSupportedLanguages, yang memiliki kuota permintaan atau kontennya sendiri.
Kuota model kustom dihitung secara terpisah dan tidak mengurangi kuota permintaan v3 lainnya.
| Kuota | Default |
|---|---|
| Permintaan untuk mendapatkan bahasa yang didukung (v2 dan v3 digabungkan) per project per menit | 600 |
| Permintaan v2 per project per menit | 300.000 |
| Permintaan v2 per project per menit per pengguna | hingga batas project v2 |
| Permintaan v3 per project per menit | 6.000 |
| Permintaan pengubahan karakter ke dalam aksara latin v3 per project per menit | 6.000 |
| Permintaan v3 per project per menit per pengguna | hingga batas project v3 |
| Permintaan terjemahan batch v3 (teks dan dokumen) per project per hari | tak terbatas |
| Permintaan terjemahan model kustom v3 per project per hari | tak terbatas |
| Permintaan terjemahan model kustom v3 per project per menit | 600 |
| Permintaan terjemahan batch model kustom v3 per project per hari | tak terbatas |
| Permintaan pembuatan model v3 per project per menit | 10 |
| Permintaan pembuatan model serentak v3 per project | 2 |
Kuota per pengguna berlaku untuk jumlah permintaan yang dapat dibuat per menit oleh pengguna akhir yang menggunakan aplikasi klien. Saat Anda menggunakan akun layanan, identitas akun layanan adalah pengguna, untuk tujuan penghitungan konsumsi kuota. Jika Anda menggunakan Cloud Translation - Basic dan Kunci API, Cloud Translation akan menggunakan alamat IP klien untuk menerapkan batas ini.
Menghitung kuota
Untuk Cloud Translation - Basic, kuota konten dan permintaan dihitung berdasarkan project yang membuat permintaan, yang ditentukan oleh kunci yang digunakan dalam permintaan.
Untuk Cloud Translation - Advanced, kuota konten diperiksa berdasarkan project yang terkait dengan model dalam permintaan. Kuota permintaan diperiksa berdasarkan project yang membuat permintaan.
Misalnya, dalam permintaan teks terjemahan berikut, kuota permintaan
diperiksa berdasarkan project-id-1 karena permintaan tersebut berasal dari
project-id-1. Kuota konten diperiksa berdasarkan project-id-2 karena
permintaan menggunakan model dalam project tersebut.
POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText { "Model":"projects/project-id-2/locations/us-central1/models/model-id", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash."] }
Batas Cloud Translation - Advanced
Tabel berikut menjelaskan batas Cloud Translation - Advanced, yang tidak dapat diubah.
| Deskripsi | Batas |
|---|---|
| Jumlah maksimum file yang dapat Anda sertakan dalam satu permintaan batch | 100 file |
| Jumlah maksimum resource glosarium untuk project | 10.000 |
Terjemahan adaptif
| Deskripsi | Batas |
|---|---|
| Jumlah maksimum pasangan segmen yang dapat Anda impor | 10.000 (konsol Google Cloud) 30.000 (API) |
| Jumlah maksimum karakter yang dapat Anda kirim per permintaan | 3.000 |
| Jumlah maksimum karakter output dari terjemahan adaptif per permintaan | 3.000 untuk bahasa (teks apa pun yang melebihi batas ini akan dihapus) |