Cloud Translation menerapkan kuota pada ukuran konten permintaan dan jumlah permintaan yang dapat Anda kirim. Kuota melindungi komunitas penggunaGoogle Cloud dengan mencegah lonjakan penggunaan yang tidak terduga. Anda juga dapat mengurangi kuota untuk mencegah penggunaan yang berlebihan dan mengontrol biaya.
Jika kuota Anda terlampaui, Cloud Translation akan menampilkan error 403.
Pesan error akan menampilkan 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. Artinya, kuota baru dapat membutuhkan 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 sudah ditetapkan, sebaiknya pantau penggunaan harian dan atur kuota sesuai dengan rencana pengeluaran Anda.
Anda dapat mengedit kuota menggunakan konsol Google Cloud halaman kuota. 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 kapasitas yang berlaku.
Semua karakter yang Anda kirim ke Cloud Translation API dihitung 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 batas
jumlah model kustom yang diminta dalam satu hari dari suatu project. Selain itu,
jika model translation-llm digunakan, maka tidak ada kuota konten.
| 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 peromawian 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 oleh pengguna akhir, yang menggunakan aplikasi klien, per menit. 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, latensi respons akan semakin tinggi. 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 alternatif adalah menggunakan terjemahan batch untuk mengirim lebih banyak konten per permintaan sebagai operasi yang berjalan lama.
Cloud Translation API akan menolak permintaan yang lebih besar dari jumlah maksimum dan akan memberikan
error 400 INVALID_ARGUMENT, terlepas dari kuota yang tersedia.
Kuota kapasitas
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 dan translation-llm dihitung secara terpisah dan tidak mengurangi kuota kapasitas penggunaan 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 peromawian 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 |
| Permintaan LLM Terjemahan v3 per project per menit | 900 |
| Permintaan Terjemahan Adaptif v3 per project per menit | 900 |
Kuota per pengguna berlaku untuk jumlah permintaan yang dapat dibuat oleh pengguna akhir, yang menggunakan aplikasi klien, per menit. 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 kuota kapasitas dihitung berdasarkan project yang membuat permintaan, yang ditentukan oleh kunci yang digunakan dalam permintaan tersebut.
Untuk Cloud Translation - Advanced, kuota konten dihitung berdasarkan project yang terkait dengan model dalam permintaan. Kuota permintaan dihitung berdasarkan project yang membuat permintaan.
Misalnya, dalam permintaan teks terjemahan berikut, kuota kapasitas
dihitung berdasarkan project-id-1 karena permintaan tersebut berasal dari
project-id-1. Kuota konten dihitung berdasarkan project-id-2 karena
permintaan tersebut menggunakan model yang ada 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 satu project | 10.000 |
LLM Terjemahan
| Deskripsi | Batas |
|---|---|
| Jumlah maksimum karakter yang dapat Anda kirim per permintaan | 30.000 |
Terjemahan adaptif
| Deskripsi | Batas |
|---|---|
| Jumlah maksimum pasangan segmen yang dapat Anda impor | 10.000 (konsolGoogle Cloud ) 30.000 (API) |
| Jumlah maksimum karakter yang dapat Anda kirim per permintaan | 30.000 |
| Jumlah maksimum karakter output dari terjemahan adaptif per permintaan | 30.000 untuk bahasa (teks apa pun yang melebihi batas ini akan dihapus) |