Cara Pakai Hermes Agent dengan API AI Murah, Bayar Rupiah (Helipod AI Gateway)

Hermes Agent bisa jalan 24/7 di VPS kecil, karena model AI-nya tidak berjalan di server kamu. Yang menentukan biaya bulanan justru API model yang dipakai Hermes untuk berpikir dan memanggil tool. Di sinilah banyak pengguna Indonesia tersandung: provider luar minta kartu kredit internasional, tagihan dalam dolar, dan tiap provider punya akun, saldo, dan API key sendiri.

Panduan ini menunjukkan cara menghubungkan Hermes Agent ke Helipod AI Gateway: satu API key untuk puluhan model (DeepSeek, Claude, GPT, Gemini, GLM, Kimi), formatnya kompatibel dengan OpenAI, dan saldonya diisi dalam Rupiah lewat QRIS.

Belum punya Hermes yang jalan? Ikuti dulu Tutorial Setup VPS Hermes sampai Hermes terpasang. Artikel ini melanjutkan dari bagian konfigurasi provider.

Daftar Isi#

1. Kenapa Pakai AI Gateway untuk Hermes
2. Yang Kamu Butuhkan
3. Buat API Key Helipod AI
4. Isi Saldo AI
5. Konfigurasi Hermes ke Helipod AI Gateway
6. Tes Koneksi dari VPS
7. Pilih Model yang Cocok untuk Hermes
8. Tips Hemat Biaya
9. Restart Service Hermes
10. Troubleshooting
11. FAQ

1. Kenapa Pakai AI Gateway untuk Hermes#

Hermes Agent mendukung endpoint custom yang kompatibel dengan OpenAI. Artinya, kamu tidak terikat ke satu provider. Dengan Helipod AI Gateway:

• Satu API key, banyak model. Ganti dari DeepSeek ke Claude atau GPT cukup dengan mengganti nama model di config, tanpa daftar akun baru.
• Bayar dalam Rupiah. Saldo AI diisi dari wallet Helipod (QRIS, virtual account, e-wallet). Tidak perlu kartu kredit internasional, tidak ada selisih kurs di tagihan kartu.
• Bayar per token yang dipakai. Tidak ada langganan bulanan. Harga tiap model per 1 juta token tampil di halaman Models & pricing dalam Rupiah.
• Tool calling jalan. Hermes sangat bergantung pada tool calling (menjalankan perintah, membaca file, memanggil skill). Kami sudah menguji tool calling lewat gateway di DeepSeek, GLM, GPT, dan Claude.
• Kontrol biaya per key. Kamu bisa membatasi key ke model tertentu dan memberi batas belanja bulanan, jadi agent yang jalan sendiri tidak bisa menghabiskan saldo di luar rencana.

2. Yang Kamu Butuhkan#

• VPS dengan Hermes Agent terpasang (misalnya VPS Hermes Helipod, yang sudah menyiapkan Hermes untukmu)
• Akun Helipod (bisa daftar dengan Google)
• Saldo AI minimal Rp10.000 untuk mencoba

3. Buat API Key Helipod AI#

1. Masuk ke dashboard Helipod, buka project kamu, lalu pilih menu AI Gateway.
2. Klik Create API key.
3. Beri nama yang jelas, misalnya hermes-vps.
4. (Disarankan) Aktifkan batasi model dan pilih hanya model yang akan dipakai Hermes.
5. (Disarankan) Isi batas belanja bulanan, misalnya Rp100.000. Setelah batas tercapai, key menolak request sampai bulan berikutnya.
6. Salin key yang muncul. Formatnya diawali hel_ai_.

Simpan key di tempat aman. Jangan menaruhnya di repository Git atau di config.yaml yang mungkin ikut tersalin. Untuk Hermes, tempat yang benar adalah file ~/.hermes/.env.

4. Isi Saldo AI#

Saldo AI terpisah dari saldo wallet, tapi diisi dari wallet:

1. Di menu AI Gateway → Overview, pilih nominal top up (misalnya Rp50.000) atau masukkan nominal lain.
2. Kalau saldo wallet kurang, isi wallet dulu lewat QRIS atau virtual account.
3. Supaya agent tidak berhenti di tengah malam karena saldo habis, aktifkan Auto top-up: saat saldo AI turun di bawah batas tertentu, saldo diisi otomatis dari wallet.

Saat saldo AI habis, request ditolak dengan status 402, dan Hermes akan menampilkan error dari provider.

5. Konfigurasi Hermes ke Helipod AI Gateway#

Semua pengaturan Hermes ada di folder ~/.hermes/. Setting non-rahasia ada di config.yaml, sedangkan API key ada di .env.

Langkah 1: Simpan API key di .env#

nano ~/.hermes/.env

Tambahkan atau ganti baris berikut:

OPENAI_API_KEY=hel_ai_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Untuk endpoint custom yang kompatibel dengan OpenAI, Hermes membaca key dari OPENAI_API_KEY.

Amankan file-nya supaya hanya user kamu yang bisa membaca:

chmod 600 ~/.hermes/.env

Langkah 2: Arahkan model ke gateway di config.yaml#

nano ~/.hermes/config.yaml

Ubah blok model menjadi:

model:
  default: "deepseek-v4.1-flash"
  provider: "custom"
  base_url: "https://ai.helipod.io/v1"

Penjelasan singkat:

Langkah 3: Cek konfigurasi#

hermes config check
hermes config get model

Kalau kamu lebih suka lewat CLI, model juga bisa diganti dengan:

hermes config set model deepseek-v4.1-flash

6. Tes Koneksi dari VPS#

Sebelum menjalankan Hermes, pastikan VPS bisa menjangkau gateway dan key-nya valid.

Daftar model yang bisa dipakai key kamu:

curl -s https://ai.helipod.io/v1/models \
  -H "Authorization: Bearer $(grep OPENAI_API_KEY ~/.hermes/.env | cut -d= -f2)" | head -c 400

Coba satu chat:

curl -s https://ai.helipod.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(grep OPENAI_API_KEY ~/.hermes/.env | cut -d= -f2)" \
  -d '{"model":"deepseek-v4.1-flash","max_tokens":50,"messages":[{"role":"user","content":"Halo, tes koneksi"}]}'

Kalau keluar jawaban JSON berisi choices, koneksi sudah benar. Setelah itu jalankan Hermes dan ajak chat seperti biasa:

hermes

Setiap request yang dikirim Hermes akan muncul di menu AI Gateway → Usage beserta model, jumlah token, dan biayanya dalam Rupiah.

7. Pilih Model yang Cocok untuk Hermes#

Hermes adalah agent: ia menjalankan tool, membaca hasilnya, lalu memutuskan langkah berikutnya. Karena itu model yang dipakai harus mendukung tool calling dan punya context window yang lega. Semua model di bawah ini sudah kami uji melakukan tool call lewat Helipod AI Gateway:

Harga per 1 juta token input dan output tiap model selalu ada di menu Models & pricing, dalam Rupiah. Mulailah dengan model murah sebagai default, lalu naikkan ke model yang lebih kuat hanya untuk tugas yang memang butuh.

8. Tips Hemat Biaya#

Pakai model murah sebagai default. Sebagian besar kerja agent (membaca file, menjalankan perintah, merangkum output) tidak butuh model termahal.

Pakai model murah juga untuk kompresi konteks. Hermes meringkas percakapan panjang dengan model tambahan (auxiliary). Arahkan ke model murah lewat gateway yang sama:

auxiliary:
  compression:
    model: "deepseek-v4.1-flash"
    base_url: "https://ai.helipod.io/v1"

Pastikan context window model kompresi minimal sama besar dengan model utama.

Batasi key. Dengan batas model dan batas belanja bulanan di key, agent yang salah langkah (misalnya loop tanpa henti) tidak bisa menguras saldo.

Pantau pemakaian. Menu Usage menampilkan biaya per hari dan per model. Kalau satu model mendominasi biaya, pertimbangkan menggantinya untuk tugas rutin.

Manfaatkan kode promo. Kode promo di menu Overview memberi diskon per token selama masa berlakunya.

9. Restart Service Hermes#

Kalau Hermes kamu jalankan sebagai service systemd (seperti di tutorial setup), restart setelah mengubah config.yaml atau .env:

sudo systemctl restart hermes
sudo systemctl status hermes
journalctl -u hermes -n 50 --no-pager

Cek log untuk memastikan tidak ada error autentikasi saat Hermes mulai berjalan.

10. Troubleshooting#

11. FAQ#

Apakah Helipod AI Gateway kompatibel dengan Hermes Agent? Ya. Gateway memakai format OpenAI Chat Completions, termasuk streaming dan tool calling, jadi Hermes cukup diarahkan dengan provider: custom dan base_url: https://ai.helipod.io/v1.

Apakah perlu kartu kredit? Tidak. Saldo AI diisi dari wallet Helipod, yang bisa diisi lewat QRIS, virtual account, atau e-wallet.

Bisa ganti model tanpa ganti API key? Bisa. Satu key berlaku untuk semua model (kecuali kamu membatasinya). Ganti saja model.default di config.yaml lalu restart Hermes.

Apakah Hermes juga bisa dipakai di VPS selain Helipod? Bisa. Gateway diakses lewat internet biasa, jadi Hermes di server mana pun bisa memakainya. Tapi VPS Hermes dari Helipod sudah menyiapkan Hermes, sehingga kamu tinggal mengisi API key.

Berapa biaya menjalankan Hermes per bulan? Tergantung seberapa sering agent bekerja dan model yang dipakai. Dengan model murah seperti deepseek-v4.1-flash sebagai default, banyak pengguna cukup dengan top up kecil per bulan. Pantau angka pastinya di menu Usage, lalu atur batas belanja di key sesuai anggaran.

Siap mencoba? Buka Helipod AI Gateway, buat API key, dan hubungkan ke Hermes kamu. Belum punya server? Pilih VPS Hermes yang sudah siap pakai.