---
title: "Cara Pakai Hermes Agent dengan API AI Murah, Bayar Rupiah (Helipod AI Gateway)"
url: "https://helipod.io/blog/hermes-agent-api-ai-murah"
date: "2026-10-15"
updated: "2026-10-15"
author: "Tim Helipod"
tags: ["hermes-agent", "ai gateway", "api ai murah", "vps", "ai-agent", "tutorial", "deepseek", "claude"]
excerpt: "Hubungkan Hermes Agent di VPS ke Helipod AI Gateway: satu API key untuk DeepSeek, Claude, GPT, Gemini, dan GLM, bayar per token dalam Rupiah lewat QRIS, tanpa kartu kredit."
---

# 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](https://helipod.io/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](/blog/tutorial-setup-vps-hermes) sampai Hermes terpasang. Artikel ini melanjutkan dari bagian konfigurasi provider.

## Daftar Isi

1. [Kenapa Pakai AI Gateway untuk Hermes](#1-kenapa-pakai-ai-gateway-untuk-hermes)
2. [Yang Kamu Butuhkan](#2-yang-kamu-butuhkan)
3. [Buat API Key Helipod AI](#3-buat-api-key-helipod-ai)
4. [Isi Saldo AI](#4-isi-saldo-ai)
5. [Konfigurasi Hermes ke Helipod AI Gateway](#5-konfigurasi-hermes-ke-helipod-ai-gateway)
6. [Tes Koneksi dari VPS](#6-tes-koneksi-dari-vps)
7. [Pilih Model yang Cocok untuk Hermes](#7-pilih-model-yang-cocok-untuk-hermes)
8. [Tips Hemat Biaya](#8-tips-hemat-biaya)
9. [Restart Service Hermes](#9-restart-service-hermes)
10. [Troubleshooting](#10-troubleshooting)
11. [FAQ](#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](https://helipod.io/vps-hermes), 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`

```bash
nano ~/.hermes/.env
```

Tambahkan atau ganti baris berikut:

```bash
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:

```bash
chmod 600 ~/.hermes/.env
```

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

```bash
nano ~/.hermes/config.yaml
```

Ubah blok `model` menjadi:

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

Penjelasan singkat:

| Key | Isi | Keterangan |
|---|---|---|
| `default` | kode model Helipod | Lihat daftar kode di menu **Models & pricing** |
| `provider` | `custom` | Wajib untuk endpoint yang bukan provider bawaan Hermes |
| `base_url` | `https://ai.helipod.io/v1` | Endpoint format OpenAI, **harus diakhiri `/v1`** |

### Langkah 3: Cek konfigurasi

```bash
hermes config check
hermes config get model
```

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

```bash
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:**

```bash
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:**

```bash
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:

```bash
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:

| Kode model | Context | Cocok untuk |
|---|---|---|
| `deepseek-v4.1-flash` | 1 juta token | Default harian: murah, cepat, tool calling stabil |
| `glm-5.3-flash` | 1 juta token | Alternatif murah untuk tugas ringan dan otomasi |
| `gpt-5-mini` | 400 ribu token | Seimbang antara harga dan kemampuan reasoning |
| `claude-haiku-4-5` | 200 ribu token | Cepat, rapi untuk coding ringan dan ringkasan |
| `claude-sonnet-4-6` | 1 juta token | Tugas berat: coding kompleks, analisis panjang |
| `kimi-k3` | 1 juta token | Riset dan dokumen panjang |

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:

```yaml
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](/blog/tutorial-setup-vps-hermes)), restart setelah mengubah `config.yaml` atau `.env`:

```bash
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

| Gejala | Penyebab | Solusi |
|---|---|---|
| `401` / invalid API key | Key salah, terhapus, atau ada spasi di `.env` | Salin ulang key `hel_ai_...`, pastikan tidak ada spasi atau tanda kutip berlebih |
| `402` / saldo tidak cukup | Saldo AI habis | Top up di AI Gateway → Overview, aktifkan Auto top-up |
| `404` / model_not_found | Kode model salah, atau key dibatasi ke model lain | Cek kode di Models & pricing, cek daftar model yang diizinkan di key |
| `403` / batas belanja tercapai | Batas belanja bulanan key sudah habis | Naikkan batas di key, atau tunggu bulan berikutnya |
| `429` / rate limited | Terlalu banyak request dalam satu menit | Kurangi paralelisme agent, atau coba lagi beberapa detik kemudian |
| Hermes tidak memanggil tool | Model kurang cocok untuk agent | Pakai salah satu model di tabel bagian 7 |
| Error `404` di semua request | `base_url` tidak diakhiri `/v1` | Pakai `https://ai.helipod.io/v1` |
| Config berubah tapi tidak berefek | Service belum direstart | `sudo systemctl restart hermes` |

## 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](https://helipod.io/ai-gateway)**, buat API key, dan hubungkan ke Hermes kamu. Belum punya server? Pilih **[VPS Hermes](https://helipod.io/vps-hermes)** yang sudah siap pakai.