Panduan ini memberikan ringkasan berbagai opsi penagihan Gemini API, menjelaskan cara mengaktifkan penagihan dan memantau penggunaan, serta memberikan jawaban atas pertanyaan umum (FAQ) tentang penagihan.
Tentang penagihan dan tingkat
Penagihan untuk Gemini API didasarkan pada histori pembayaran Anda.
| Tingkat penggunaan | Kualifikasi | Batas tingkat penagihan |
|---|---|---|
| Gratis | Project aktif atau uji coba gratis | T/A |
| Tingkat 1 | Menyiapkan dan menautkan akun penagihan yang aktif | $250 |
| Tingkat 2 | Dibayar $100 + 3 hari sejak pembayaran pertama yang berhasil | $2.000 |
| Tingkat 3 | Membayar $1.000 + 30 hari sejak pembayaran pertama yang berhasil | $20.000 - $100.000+ |
Akun baru dimulai dengan Paket Gratis, yang memungkinkan akses ke model tertentu di Gemini API dan AI Studio, hingga batas penggunaan paket gratis model.
Untuk mengakses batas frekuensi yang lebih tinggi, menggunakan model lanjutan, dan memastikan perintah dan respons Anda tidak digunakan untuk meningkatkan kualitas produk Google*, Anda dapat menautkan akun penagihan dan membayar di muka untuk beralih ke Tingkatan Berbayar. Kemudian, Anda akan berpindah ke tingkat yang lebih tinggi berdasarkan pembelanjaan kumulatif dan usia akun. Di Tingkat 3, Anda mungkin memiliki opsi untuk beralih ke penagihan pasca-bayar.
Tingkatan, batas frekuensi, dan batas akun penagihan ditentukan di tingkat akun penagihan.
* Privasi data tingkat perusahaan: Untuk mengetahui informasi selengkapnya tentang penggunaan data untuk layanan berbayar, lihat Persyaratan Layanan.
Menyiapkan penagihan untuk mengakses Paket Berbayar
Anda dapat membuat project dan menyiapkan penagihan, atau mengimpor project yang ada, untuk mengupgrade ke Paket Berbayar di Google AI Studio. Mengupgrade dari Paket Gratis ke Paket Berbayar berarti menautkan akun penagihan dan membayar di muka untuk menambahkan kredit minimal $10 (atau yang setara dalam mata uang lain) ke akun Anda.
- Buka halaman kunci API, halaman
Project, atau tempat mana pun Anda melihat tombol
Siapkan penagihan di AI Studio.
- Pengguna baru akan memiliki project dan kunci API yang dibuat untuk mereka secara default.
- Jika Anda memerlukan kunci baru, klik Buat kunci API dan ikuti dialog untuk menambahkan pasangan kunci-project ke tabel.
- Temukan project Tingkat Gratis yang ingin Anda upgrade ke Tingkat Berbayar, lalu klik Siapkan penagihan di kolom Tingkat Penagihan.
- Jika Anda belum pernah menyiapkan akun penagihan Google sebelumnya:
- Anda akan diminta untuk memilih negara Anda guna menyetujui Persyaratan Layanan.
- Kemudian, isi atau konfirmasi informasi kontak dan metode pembayaran Anda untuk melanjutkan.
- Jika Anda telah menyiapkan akun penagihan Google di masa lalu:
- Anda akan diminta untuk memilih dari akun penagihan yang sudah ada.
- Jika Anda tidak ingin menggunakan akun yang ada, klik Tambahkan akun penagihan baru, lalu isi atau konfirmasi informasi kontak dan metode pembayaran Anda untuk melanjutkan.
- Selanjutnya, Anda akan:
- Diminta untuk membayar di muka minimal Rp100.000 untuk menyelesaikan penyiapan penagihan (artinya akun Anda ditetapkan secara otomatis ke paket penagihan Prabayar),
- Diberi pilihan antara paket penagihan Prabayar dan Pascabayar untuk akun Anda.
- Ditetapkan ke paket penagihan Pasca Bayar untuk periode sementara hingga sistem Prabayar baru diterapkan kepada semua pengguna (mulai 23 Maret 2026).
- Setelah melakukan pembayaran di muka atau memilih Bayar Nanti, penyiapan akun Anda selesai.
Melakukan upgrade ke tingkat berbayar berikutnya
Jika Anda sudah menggunakan paket berbayar dan memenuhi kriteria untuk perubahan paket, Anda akan otomatis diupgrade ke paket berikutnya (tunduk pada waktu pemrosesan).
Memverifikasi status penagihan
Setelah menautkan akun penagihan ke project, Anda dapat memantau statusnya di halaman Penagihan AI Studio. Tidak seperti paket gratis, status paket berbayar bersifat dinamis; meskipun paket penggunaan Anda ditentukan oleh histori akun Anda, Gemini API hanya akan melayani permintaan jika Anda memiliki saldo kredit Prabayar yang positif.
Di halaman Project, Anda dapat melihat tingkat dan paket penagihan project di kolom Tingkat Penagihan. Tindakan status penagihan yang mungkin perlu Anda lakukan untuk project ditampilkan di kolom Tingkat Penagihan atau Status:
- "Siapkan penagihan" jika project tidak memiliki akun penagihan yang terkait.
- "Siapkan prabayar" jika project sudah memiliki akun penagihan yang terlampir, tetapi diwajibkan untuk menggunakan paket penagihan Prabayar yang perlu disiapkan.
- "Tidak ada kredit yang tersedia" jika akun penagihan diwajibkan untuk membeli kredit, tetapi akun pembayaran Prabayar belum disiapkan atau saldo kredit yang tersedia telah habis.
Klik salah satu pesan untuk melanjutkan tindakan yang diperlukan.
Memantau penggunaan
Anda dapat memantau penggunaan Gemini API di Google AI Studio di Dasbor > Penggunaan.
Paket penagihan
Paket penagihan untuk Gemini API dan AI Studio dibagi menjadi dua kategori yang menentukan kapan Anda membayar penggunaan: Prabayar dan Pascabayar. Anda dapat memeriksa paket penagihan yang ditetapkan dan mengelola metode pembayaran di halaman Penagihan AI Studio.
Prabayar
Dalam paket penagihan Prabayar, Anda membeli kredit untuk saldo prabayar sebelum penggunaan Gemini API, dan biaya penggunaan API akan dikurangi dari saldo kredit Prabayar Anda dalam hampir real-time. Anda dapat melakukan prabayar dengan menambahkan kredit ke akun, atau menyiapkan isi ulang otomatis. Setelah dibeli, masa berlaku kredit yang tidak digunakan akan berakhir setelah 12 bulan dan tidak dapat dikembalikan dananya, kecuali setelah beralih ke akun Pascabayar.
Saat saldo kredit Prabayar di akun penagihan Anda mencapai $0, semua kunci API di semua project yang ditautkan ke akun penagihan tersebut akan berhenti berfungsi secara bersamaan. Kredit prabayar hanya berlaku untuk biaya penggunaan Gemini API; Anda tidak dapat menggunakannya untuk membayar layanan Google Cloud lainnya.
Pengguna baru secara default menggunakan paket penagihan Prabayar. Project yang ada sebelum pengenalan paket penagihan Prabayar dan Pascabayar mungkin perlu memperbarui detail penagihan project sebelum melanjutkan penggunaan Gemini API.
Membeli kredit
Anda dapat membeli kredit secara manual sebelum menggunakan Gemini API untuk memuatnya ke saldo kredit akun Prabayar.
Untuk membeli kredit, buka halaman Penagihan AI Studio dan pilih Beli kredit. Pembelian minimum adalah $10. Jumlah maksimum kredit yang dapat Anda bayar di muka adalah $5.000.
Muat ulang otomatis
Isi ulang otomatis adalah fitur opsional yang otomatis mengisi ulang saldo kredit Prabayar Anda saat saldo hampir habis. Hal ini berguna untuk mencegah gangguan layanan.
Anda dapat menyiapkan isi ulang otomatis dan melihat status isi ulang otomatis di kartu Kredit tersedia di halaman Penagihan AI Studio. Klik Siapkan isi ulang otomatis atau Kelola isi ulang otomatis untuk menetapkan metode pembayaran, jumlah isi ulang, dan saldo minimum yang memicu pembayaran isi ulang.
Pascabayar
Dalam paket penagihan Pasca-bayar, akun Penagihan Cloud Anda mengakumulasi biaya dan Anda akan ditagih secara otomatis di akhir bulan, atau saat biaya Anda mencapai jumlah nilai minimum yang ditetapkan secara otomatis. Pembayaran ditagihkan ke metode pembayaran yang terlampir pada akun pembayaran Pascabayar Anda, yang dapat Anda kelola di halaman Penagihan AI Studio.
Jika memenuhi kriteria Tingkat 3, Anda dapat beralih dari paket Prabayar ke Pascabayar secara manual. Untuk mengubah paket, Anda harus mengklik tombol Beralih ke pascabayar yang muncul di kanan atas halaman Penagihan AI Studio saat akun Anda memenuhi syarat.
Kemudian, di halaman Penagihan, Anda dapat melihat saldo, tanggal jatuh tempo, dan pembayaran sebelumnya, serta melakukan pembayaran dan mengelola metode pembayaran.
Saat menyiapkan penagihan untuk project baru, jika memenuhi syarat untuk Pasca Bayar, Anda akan memiliki opsi untuk memilih antara Prabayar dan Pasca Bayar dalam dialog penyiapan penagihan.
Setelah Anda mengalihkan akun Penagihan Cloud untuk menggunakan paket penagihan Pasca Bayar, semua project yang ditautkan ke akun penagihan tersebut akan dialihkan ke paket Pasca Bayar. Anda tidak dapat memindahkan akun penagihan tersebut kembali ke paket penagihan Prabayar. Anda dapat memindahkan project ke akun penagihan dengan paket penagihan yang berbeda untuk mengubah siklus penagihan untuk project tersebut; buka dokumentasi Cloud tentang mengelola penagihan untuk project.
Anda dapat mempelajari lebih lanjut siklus penagihan Pascabayar dalam panduan Penagihan Cloud.
Batas pembelanjaan
Gemini API mendukung batas pembelanjaan bulanan di tingkat akun penagihan dan project. Kontrol ini dirancang untuk melindungi akun Anda dari kelebihan penggunaan yang tidak terduga, dan ekosistem untuk memastikan ketersediaan layanan.
Batas pembelanjaan project
Anda dapat menetapkan batas pembelanjaan level project sendiri di AI Studio. Hal ini berguna jika Anda memiliki beberapa project dalam akun penagihan yang sama dan ingin memastikan setiap project memiliki akses ke batas pembelanjaan kumulatif yang cukup.
Akun dengan peran editor, pemilik, atau admin project dapat menetapkan batas pembelanjaan per project di AI Studio pada halaman Pembelanjaan di bagian Batas pembelanjaan bulanan > Edit batas pembelanjaan.
Jika Anda memindahkan project ke akun penagihan lain, batas pembelanjaan yang telah Anda tetapkan untuk project tersebut akan tetap berlaku, tetapi pembelanjaan yang terkumpul akan direset ke $0 untuk siklus penagihan baru.
Penyelesaian mode batch masih dapat menimbulkan biaya tambahan.
Waktu pemrosesan data penagihan dapat sedikit tertunda di AI Studio, hingga sekitar 10 menit. Anda mungkin mengalami kelebihan penggunaan di luar batas project jika data penagihan belum diproses sebelum lebih banyak tagihan terakumulasi.
Batas pembelanjaan tingkat akun penagihan
Setiap tingkatan memiliki batas pembelanjaan bulanan maksimum:
| Tingkat penggunaan | Batas pembelanjaan |
|---|---|
| Gratis | T/A |
| Tingkat 1 | $250 |
| Tingkat 2 | $2.000 |
| Tingkat 3 | $20.000 - $100.000 |
Batas penggunaan bulanan diterapkan di tingkat akun penagihan; batas ini telah ditetapkan dan tidak dapat dikonfigurasi. Total pembelanjaan digabungkan di semua project tertaut; setelah total kumulatif mencapai batas tingkat, layanan ditangguhkan untuk semua project yang ditautkan ke akun penagihan tersebut hingga awal siklus penagihan berikutnya (bulanan).
Mengevaluasi pembelanjaan akun penagihan Anda
Untuk mengevaluasi pembelanjaan bulanan historis Anda guna menentukan apakah batas pembelanjaan tingkat Akun Penagihan yang baru akan memengaruhi project yang sedang berjalan, ikuti langkah-langkah berikut:
- Di konsol Google Cloud, lihat halaman Laporan akun Penagihan Cloud Anda.
- Jika Anda memiliki lebih dari satu akun penagihan, saat diminta, pilih akun Penagihan Cloud yang ingin Anda lihat laporan biayanya.
- Laporan secara default "Dikelompokkan menurut Layanan" pada "Bulan ini". Anda akan melihat Gemini API di kolom Service dan total pembelanjaan di kolom Usage cost dalam tabel.
- Untuk melihat biaya terperinci yang terbatas pada penggunaan Gemini API, tetapkan filter Kelompokkan menurut untuk mengelompokkan menurut SKU, dan filter Layanan ke Gemini API.
- Sesuaikan filter Rentang waktu menurut tanggal penggunaan ke rentang yang diinginkan untuk mengevaluasi pembelanjaan historis Anda dalam suatu periode.
Waktu pemrosesan
Sinyal dan pembaruan penagihan tidak selalu terjadi secara real time.
- Penggunaan kredit: Biaya penggunaan biasanya diambil dari saldo Anda dalam beberapa menit.
- Konfirmasi pembayaran: Meskipun sebagian besar pembayaran kartu bersifat instan, beberapa metode pembayaran (seperti transfer bank) mungkin memerlukan waktu beberapa hari untuk diproses. Layanan hanya dilanjutkan atau diupgrade setelah pembelian kredit dikonfirmasi secara resmi.
- Upgrade tingkat: Setelah pembayaran berhasil, atau saat Anda memenuhi kriteria upgrade, upgrade tingkat biasanya akan ditampilkan dalam waktu 10 menit.
- Grafik perincian Total Biaya: Grafik yang menampilkan perincian total biaya di halaman Penagihan dan halaman Pembelanjaan dapat memerlukan waktu hingga 24 jam untuk diperbarui.
Baca panduan Penagihan Cloud tentang siklus penagihan dan latensi transaksi untuk mempelajari lebih lanjut potensi keterlambatan penagihan.
Pengembalian dana
Pengembalian dana tidak diizinkan untuk akun penagihan Prabayar. Masa berlaku kredit yang dibeli akan berakhir setelah 1 tahun. Setelah masa berlaku habis, kredit akan hangus dan tidak dapat diambil.
Saat akun Prabayar beralih ke jenis akun Pascabayar (setelah Anda memenuhi kriteria dan mengupgrade akun secara manual Anda), akun Prabayar akan ditutup dan sisa kredit prabayar akan otomatis dikembalikan dananya ke metode pembayaran yang tercatat.
Jika Anda menutup akun Prabayar karena alasan apa pun selain mengupgrade ke Pasca Bayar, sisa kredit prabayar akan hangus.
Akun Pasca-bayar mengikuti kebijakan pengembalian dana Google Cloud.
Akun Penagihan Cloud
Gemini API menggunakan akun Cloud Billing untuk layanan penagihan, yang dapat Anda siapkan langsung di AI Studio. Anda dapat menggunakan AI Studio untuk melacak pembelanjaan, memahami biaya, dan melakukan pembayaran.
Tingkatan, batas frekuensi, dan batas akun penagihan ditentukan di tingkat akun penagihan.
Project dan kunci API
Semua project yang ditautkan ke akun Penagihan Cloud akan mewarisi tingkat penggunaan dan batas tarif serta batas akun yang terkait dengan akun penagihan tersebut. Jika Anda mengubah project dari satu akun penagihan ke akun penagihan lain, tingkatnya, dan selanjutnya batas kecepatan serta batas akun, akan beralih ke tingkat akun penagihan baru.
Pembelanjaan kumulatif (untuk semua produk Google Cloud) dan usia akun di semua project yang terkait dengan akun penagihan dihitung untuk kualifikasi tingkat akun penagihan tersebut.
Anda dapat membatalkan tautan project dari akun penagihannya untuk kembali ke paket gratis.
Kunci API adalah kredensial yang dibuat di dalam project. Project ini tidak memiliki setelan penagihan independen; project ini mewarisi batas tingkat dan status penagihan project. Penggunaan kumulatif dari semua kunci dalam project dihitung dalam batas pembelanjaan project tersebut dan total pembelanjaan akun penagihan.
Pertanyaan umum (FAQ)
Bagian berikut memberikan jawaban atas pertanyaan umum (FAQ).
Apa yang ditagih kepada saya?
Harga Gemini API didasarkan pada hal berikut:
- Jumlah token input
- Jumlah token output
- Jumlah token yang di-cache
- Durasi penyimpanan token yang di-cache
Untuk mengetahui informasi harga, lihat halaman Harga.
Di mana saya dapat melihat kuota saya?
Anda dapat melihat kuota dan batas sistem di AI Studio.
Bagaimana cara meminta lebih banyak kuota?
Anda akan otomatis mendapatkan lebih banyak kuota saat akun Anda mencapai persyaratan tingkat berikutnya.
Dapatkah saya menggunakan Gemini API secara gratis di EEA (termasuk Uni Eropa), Inggris Raya, dan Swiss?
Ya, kami menyediakan paket gratis dan paket berbayar di banyak region.
Jika saya menyiapkan penagihan dengan Gemini API, apakah saya akan ditagih untuk penggunaan Google AI Studio?
Penggunaan AI Studio tetap tanpa biaya kecuali jika pengguna menautkan kunci API berbayar untuk mengakses fitur berbayar. Setelah menautkan kunci API berbayar sebagai bagian dari project berbayar di AI Studio, Anda akan ditagih atas penggunaan AI Studio untuk kunci tersebut. Anda dapat beralih antara project Tingkat Berbayar dan project Tingkat Gratis di AI Studio sesuai kebutuhan.
Dapatkah saya menggunakan 1 juta token dalam paket gratis?
Paket gratis untuk Gemini API berbeda-beda berdasarkan model yang dipilih. Untuk saat ini, Anda dapat mencoba jendela konteks 1 juta token dengan cara berikut:
- Di Google AI Studio
- Dengan paket tanpa biaya untuk model tertentu
- Dengan paket pascabayar
Bagaimana cara menghitung jumlah token yang saya gunakan?
Gunakan metode GenerativeModel.count_tokens
untuk menghitung jumlah token. Lihat Panduan token untuk mempelajari lebih lanjut token.
Dapatkah saya menggunakan kredit selamat datang Google Cloud dengan Gemini API?
Tidak, kredit selamat datang atau kredit uji coba gratis Google Cloud tidak dapat digunakan untuk Gemini API atau AI Studio.
Jika Anda diberi kredit selamat datang Google Cloud sebelum dinyatakan tidak memenuhi syarat, Anda diizinkan untuk membelanjakan sisa kredit Anda di Gemini API dan AI Studio hingga kredit tersebut berakhir setelah 90 hari.
Bagaimana penagihan ditangani?
Penagihan untuk Gemini API ditangani oleh sistem Cloud Billing. Pelajari penyiapan Penagihan Cloud dalam produk di dokumentasi Penagihan Cloud.
Apakah saya ditagih untuk permintaan yang gagal?
Jika permintaan Anda gagal dengan error 400 atau 500, Anda tidak akan ditagih untuk token yang digunakan. Namun, permintaan tersebut tetap akan mengurangi kuota Anda.
Apakah GetTokens ditagih?
Permintaan ke GetTokens API tidak ditagih, dan tidak mengurangi kuota inferensi.
Bagaimana penanganan data Google AI Studio saya jika saya memiliki akun API berbayar?
Lihat Persyaratan layanan untuk mengetahui detail tentang cara data ditangani saat Penagihan Cloud diaktifkan (lihat "Cara Google Menggunakan Data Anda" di bagian "Layanan Berbayar"). Perhatikan bahwa perintah Google AI Studio Anda diperlakukan berdasarkan persyaratan "Layanan Berbayar" yang sama selama setidaknya 1 project API mengaktifkan penagihan, yang dapat Anda validasi di halaman kunci API Gemini jika Anda melihat project yang ditandai sebagai "Berbayar" di bagian "Paket".
Apa yang terjadi jika saldo kredit prabayar saya mencapai Rp0?
Semua layanan Gemini API di semua project yang dibayar oleh akun Pembayaran di Muka Penagihan Cloud tersebut akan segera dihentikan untuk mencegah pengenaan biaya lebih lanjut. Project Anda tidak otomatis didowngrade ke Paket Gratis.
Untuk memulihkan layanan di tingkat Berbayar saat ini, Anda harus membeli kredit tambahan. Setelah membeli kredit, Anda akan dapat menggunakan Gemini API. Perhatikan bahwa mungkin ada keterlambatan saat sistem kami diperbarui untuk menampilkan saldo kredit Anda.
Jika ingin melakukan downgrade ke Tingkat Gratis, Anda dapat menonaktifkan penagihan pada project yang ingin Anda downgrade.
Apakah masa berlaku kredit prabayar saya akan berakhir?
Ya, masa berlaku kredit akan berakhir 12 bulan setelah tanggal pembeliannya.
Mengapa saldo kredit akun Prabayar saya negatif?
Karena kompleksitas sistem penagihan dan pemrosesan kami, mungkin ada penundaan dalam kemampuan kami untuk menghentikan penggunaan setelah Anda menggunakan semua kredit Anda. Penggunaan berlebih ini mungkin muncul sebagai saldo kredit negatif di dasbor penagihan AI Studio Anda. Jika hal ini terjadi, layanan Anda akan dijeda, dan saldo negatif Anda akan dikurangi dari pembelian kredit berikutnya.
Untuk menghindari jeda pada layanan Gemini API, sebaiknya siapkan isi ulang otomatis untuk membeli lebih banyak kredit secara otomatis saat saldo kredit Anda kurang dari nilai yang Anda tentukan.
Dapatkah saya menggunakan kredit Prabayar untuk layanan Google Cloud lainnya, seperti Vertex AI?
Tidak, kredit Prabayar hanya dapat digunakan untuk Gemini API. Layanan Google Cloud lainnya yang Anda gunakan (Compute, Storage, Vertex) ditagih menggunakan siklus penagihan Cloud standar.
Mengapa saya melihat pesan "Jenis akun penagihan tidak aktif atau tidak didukung"?
Interaksi pembayaran di halaman Penagihan AI Studio dapat diblokir dan diganti dengan pesan "Jenis akun penagihan tidak aktif atau tidak didukung" jika jenis akun penagihan atau status akun penagihan yang Anda pilih tidak memenuhi syarat untuk Paket Berbayar di AI Studio.
Periksa Cloud Console untuk melihat status akun penagihan Anda. Salah satu jenis yang tidak memenuhi syarat adalah Akun uji coba gratis. Jika demikian, Anda dapat mengaktifkan penagihan di AI Studio agar memenuhi syarat. Salah satu status tidak aktif adalah Ditutup, dalam hal ini Anda dapat membuka kembali akun.
Di mana saya bisa mendapatkan bantuan terkait penagihan?
Untuk mendapatkan bantuan terkait penagihan, lihat Mendapatkan dukungan penagihan Cloud.