Kuota dan batas

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

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