Cloud Translation memberlakukan kuota pada ukuran konten permintaan dan jumlah permintaan yang dapat dikirim. 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 menyatakan 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 mengurangi 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 mengurangi kuota model umum.
| 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 jumlah project |
| Untuk penerjemahan 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 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 (gabungan v2 dan v3) 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 file maksimum yang dapat Anda sertakan dalam satu permintaan batch | 100 file |
| Jumlah maksimum referensi glosarium untuk sebuah project | 10.000 |