Tool Python: Cek Kompatibilitas Model Google AI dengan API Key
Pernah bingung kenapa API key Google AI Anda tidak bisa akses model tertentu? Atau penasaran model mana saja yang bisa dipakai tanpa setup billing?
Google AI punya banyak model keren seperti Gemini 2.5, Imagen 3, dan Veo 2. Tapi sayangnya, tidak semua model gratis dan beberapa punya persyaratan khusus.
Artikel ini akan membahas tool Python yang saya buat untuk mengecek kompatibilitas API key dengan berbagai model Google AI secara otomatis. Tool ini bisa mendeteksi:
- Model mana yang gratis dan bisa langsung dipakai
- Model mana yang perlu billing GCP
- Model mana yang kena quota limit
- Model mana yang tidak accessible
Mengapa Tool Ini Penting?
Problem yang Sering Dihadapi Developer
- Trial and Error - Coba satu-satu model sampai ketemu yang work
- Error Messages Confusing - Pesan error kadang tidak jelas
- Documentation Scattered - Info model tersebar di berbagai halaman
- Billing Surprise - Tiba-tiba kena charge karena tidak tahu model berbayar
Solusi yang Ditawarkan
Tool Gemini API Model Checker ini menyelesaikan semua masalah di atas dengan:
- Automated Testing - Test semua model sekaligus
- Clear Status - Status setiap model jelas dan mudah dipahami
- Comprehensive Report - Laporan lengkap yang bisa disimpan
- Quick Mode - Test cepat untuk model populer
Fitur Utama Tool
1. Quick Check Mode
Mode cepat yang test 5 model paling populer:
gemini-1.5-flash(Text gratis paling umum)gemini-2.0-flash(Multimodal terbaru)imagen-3.0-generate-002(Image generation terbaru)veo-2.0-generate-001(Video generation terbaru)gemini-2.5-pro-preview-05-06(Reasoning paling canggih)
2. Comprehensive Check Mode
Mode lengkap yang test semua model dalam kategori:
- Text Models - 11 model dari Gemini 2.5 sampai legacy
- Image Models - 5 model Imagen dan variants
- Video Models - 3 model Veo dan video generation
- Audio & Embedding - Model audio, speech, dan text embedding
3. Smart Error Detection
Tool bisa membedakan jenis error:
- Billing Required - Model perlu GCP billing aktif
- Quota Exhausted - Rate limit atau daily quota habis
- Not Found - Model tidak ada atau typo
- Authentication - Masalah dengan API key
4. Detailed Reporting
Generate laporan lengkap dengan:
- Summary statistik (berapa available, berapa perlu billing)
- Breakdown per kategori model
- Recommendations actionable
- Save ke file dengan timestamp
Cara Install dan Setup
Step 1: Persiapan Environment
# Install Python dependencies pip install google-genai>=1.10.0 # Clone atau download script git clone https://github.com/username/gemini-api-model-checker.git cd gemini-api-model-checker
Step 2: Dapatkan API Key
- Buka Google AI Studio
- Login dengan akun Google
- Klik "Create API key"
- Copy API key yang dihasilkan
Step 3: Setup API Key di Script
Edit file api_model_checker.py:
# Ganti dengan API key Anda os.environ['GOOGLE_API_KEY'] = ""
Penting: Jangan commit API key ke public repository!
Cara Penggunaan
Jalankan Script
python api_model_checker.py
Pilih Mode Testing
GOOGLE AI API KEY MODEL CHECKER ================================================== Select testing mode: 1. Quick check (popular models only) 2. Comprehensive check (all models) Choose (1/2):
Rekomendasi:
- Pilih 1 jika ingin test cepat (1-2 menit)
- Pilih 2 jika ingin analisis lengkap (5-10 menit)
Memahami Output Tool
Sample Output Quick Check
QUICK CHECK: POPULAR MODELS ======================================== gemini-1.5-flash Most common free text model AVAILABLE gemini-2.0-flash Latest multimodal model QUOTA LIMITED imagen-3.0-generate-002 Latest image generation NEEDS BILLING veo-2.0-generate-001 Latest video generation NEEDS BILLING gemini-2.5-pro-preview-05-06 Most advanced reasoning NEEDS BILLING QUICK SUMMARY: Available: 1 Need billing: 3 Quota limited: 1 TIP: Setup GCP billing to access premium models → https://console.cloud.google.com/billing
Interpretasi Status
StatusArtinyaAction yang Perlu DilakukanAVAILABLEModel siap pakaiLangsung bisa coding!NEEDS BILLINGPerlu setup billing GCPSetup billing, dapat $300 creditQUOTA LIMITEDKena rate limitTunggu 24 jam atau setup billingERRORAda masalah teknisCek API key atau koneksi
Setup Billing GCP (Opsional tapi Recommended)
Jika banyak model yang status NEEDS BILLING, ikuti langkah ini:
Step 1: Buka Google Cloud Console
- Kunjungi: https://console.cloud.google.com/billing
- Login dengan akun yang sama dengan API key
Step 2: Create Billing Account
- Klik "Create billing account"
- Isi informasi kartu kredit
- Bonus: Akun baru dapat $300 free credit!
Step 3: Link Project ke Billing
- Di halaman Billing → Account management
- Tab "Projects" → Link project yang berisi API key
Step 4: Enable APIs
- Menu "APIs & Services" → Library
- Cari dan enable "Vertex AI API"
Estimasi Biaya:
- Gemini Text: ~$0.001 per 1K karakter
- Imagen 3: ~$0.04 per gambar
- Veo 2: ~$0.10-0.30 per video
- Free Credit $300 cukup untuk eksperimen berbulan-bulan!
Customization dan Pengembangan
Tambah Model Baru
Jika ada model baru yang ingin ditest, edit bagian ini:
def check_text_models(client):
text_models = [
# Tambah model baru di sini
"gemini-3.0-ultra", # contoh
# Model existing...
"gemini-2.5-flash-preview-05-20",
]
Ubah Rate Limiting
Jika sering kena quota, tambah delay:
time.sleep(2) # Ubah dari 1 detik ke 2 detik
Custom Report Format
Edit fungsi generate_report() untuk format laporan sesuai kebutuhan.
Troubleshooting Common Issues
Issue 1: "Basic Connection Failed"
Penyebab: API key salah atau expired
Solusi:
- Generate API key baru di Google AI Studio
- Pastikan copy-paste dengan benar
- Cek tidak ada spasi extra
Issue 2: "All Models Need Billing"
Penyebab: Akun belum setup billing
Solusi:
- Setup GCP billing (lihat section di atas)
- Atau gunakan hanya model gratis seperti
gemini-1.5-flash
Issue 3: "Quota Exhausted di Semua Model"
Penyebab: Daily quota habis
Solusi:
- Tunggu 24 jam untuk reset
- Setup billing untuk quota lebih besar
- Gunakan API key berbeda (jika punya)
Issue 4: Script Hanging/Stuck
Penyebab: Network timeout atau server Google busy
Solusi:
- Restart script
- Cek koneksi internet
- Coba lagi di waktu yang berbeda
Tips Optimasi Penggunaan
1. Mulai dengan Quick Check
Selalu jalankan quick check dulu sebelum comprehensive check untuk save quota.
2. Save Report untuk Reference
Tool otomatis save report dengan timestamp. Simpan untuk tracking compatibility over time.
3. Use Environment Variables
Untuk production, gunakan environment variable:
export GOOGLE_API_KEY="your_key_here" python api_model_checker.py
4. Batch Testing
Jika punya multiple API keys, buat script wrapper untuk test semua sekaligus.
5. Monitor Quota Usage
Check Google Cloud Console regularly untuk monitor usage dan billing.
Roadmap dan Future Development
Tool ini bisa dikembangkan lebih lanjut dengan fitur:
- Automated Scheduling - Cron job untuk daily check
- Email Notifications - Alert jika ada model baru available
- Historical Analytics - Track availability trends over time
- Web Interface - GUI version dengan dashboard
- CI/CD Integration - Plugin untuk testing pipeline
- Mobile App - Check on the go
Use Cases di Real World
1. Developer Onboarding
Tim baru bisa langsung tahu model mana yang accessible tanpa trial-error.
2. Project Planning
PM bisa estimate budget berdasarkan model requirements.
3. Cost Optimization
Identify free alternatives sebelum pakai model premium.
4. Debugging Production Issues
Quickly check jika production error karena model compatibility.
5. API Migration
Compare compatibility sebelum migrate ke API key atau project baru.
Kesimpulan
Tool Gemini API Model Checker ini sangat membantu developer yang work dengan Google AI API. Dengan tool ini, Anda bisa:
- Save Time - Tidak perlu trial-error lagi
- Save Money - Tahu model mana yang gratis vs berbayar
- Avoid Frustration - Error messages yang clear dan actionable
- Plan Better - Data untuk decision making
Next Steps:
- Download dan jalankan tool ini
- Setup billing jika perlu akses model premium
- Start building amazing AI applications!
Tool ini open source dan bisa dikustomisasi sesuai kebutuhan. Jangan lupa star repository-nya jika membantu!
