APIMaster.ai
Dokumentasi APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop dengan APIMaster.ai

Atur kunci API dan URL dasar yang kompatibel dengan OpenAI di Hermes Desktop pada Windows atau macOS, lalu pilih model di Pengaturan.

APIMaster.ai kompatibel dengan OpenAI. Hermes membaca dua variabel lingkungan, lalu Anda memilih model di antarmuka desktop.

Pengaturan cepat

Langkah 1 — Dapatkan Kunci API Anda

  1. Buka konsol APIMaster.
  2. Salin Kunci API Anda (biasanya dimulai dengan sk-).
  3. Jangan pernah menempelkan kunci asli ke dalam obrolan atau tangkapan layar; gunakan placeholder your_apimaster_key di bawah.

Langkah 2 — Edit file .env

Windows

  1. Tekan Win + R, tempel, lalu tekan Enter:

    %LOCALAPPDATA%\hermes

  2. Buka .env di Notepad (buat file jika belum ada).

  3. Jalur lengkap tipikal:

    C:\Users\NamaAnda\AppData\Local\hermes\.env

macOS

Hermes Desktop berbagi ~/.hermes dengan CLI (dokumentasi resmi). Letakkan kunci di ~/.hermes/.env.

Opsi A — Finder (disarankan)

  1. Go → Go to Folder… (Shift + Command + G).

  2. Tempel:

    ~/.hermes

    (~ = folder rumah Anda; .hermes tersembunyi di Finder kecuali Anda menggunakan Go to Folder.)

  3. Buka .env di TextEdit (buat jika belum ada).

Opsi B — Terminal

open ~/.hermes

Jalur lengkap

/Users/NamaAnda/.hermes/.env

Langkah 3 — Tambahkan baris berikut

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL harus diakhiri dengan /v1 — bukan https://apimaster.ai saja.
  • Tidak ada spasi di sekitar =, tidak ada tanda kutip kecuali dokumentasi Hermes menyatakan sebaliknya.
  • Simpan file.

Langkah 4 — Mulai ulang Hermes Desktop

Keluar sepenuhnya dari Hermes (termasuk ikon baki), lalu buka lagi.

Pilih model di aplikasi

  1. Buka Hermes Desktop.

  2. Pergi ke Settings → Model → Main model.

  3. Provider: Custom endpoint.

  4. Model: pilih id model yang didukung, misalnya:

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    Lihat marketplace atau admin Anda untuk daftar lengkap.

  5. Klik Apply, lalu tutup Settings.

Hermes Desktop: Settings → Model → Main model

Uji coba: pilih model dan kirim pesan

1. Atur model utama di Settings (wajib)

  1. Buka Settings (sidebar atau kiri bawah).
  2. Pergi ke Model → Main model.
  3. Provider: Custom endpoint (atau openai-api jika muncul).
  4. Buka dropdown Model dan klik sebuah id (mis. gpt-5.4) — jangan mengetik nama tampilan.
  5. Klik Apply dan tutup Settings.

Obrolan baru menggunakan model ini setelah Apply; obrolan lama mungkin masih menggunakan model sebelumnya.

2. Mulai obrolan baru

  1. Kembali ke daftar obrolan.
  2. Klik New chat (atau +).
  3. Gunakan sesi baru, bukan thread lama.

3. Periksa model aktif (disarankan)

Di dekat input Anda mungkin melihat sesuatu seperti openai-api / gpt-5.4. Jika salah, perbaiki Main model, Apply, dan buka obrolan baru lainnya. Beberapa build juga menawarkan dropdown model kecil di samping composer.

4. Kirim pesan uji coba

Ketik Hello, reply with ok dan tekan Enter. Balasan normal berarti Key, base URL, dan model berfungsi.

5. Masih gagal?

Periksa teks kesalahan (401, 404, timeout), pastikan Hermes telah dimulai ulang setelah mengedit .env, atau jalankan tes konektivitas API dengan kunci yang sama.

FAQ

Masalah Yang perlu diperiksa
Pengiriman gagal URL adalah https://apimaster.ai/v1; kunci disalin sepenuhnya; id model tepat; Hermes dimulai ulang setelah edit .env
Folder tidak ada Gunakan ~/.hermes di Mac (bukan Application Support); jalankan Hermes sekali atau mkdir -p ~/.hermes
Tidak ada Custom endpoint Perbarui Hermes ke versi terbaru
Model salah ID berasal dari APIMaster; lihat Model yang didukung

Opsional: tes konektivitas API dengan kunci yang sama.

Keamanan

  • Jangan bagikan kunci API di Slack, email, atau dokumen publik.
  • Gunakan placeholder di tiket dan tangkapan layar saja.
  • Jika bocor, cabut kunci di konsol, perbarui .env, dan mulai ulang Hermes.

Daftar periksa

  • Kunci API disalin dari konsol (dirahasiakan)
  • OPENAI_API_KEY diatur di .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (dengan /v1)
  • .env disimpan
  • Hermes dimulai ulang sepenuhnya
  • Provider = Custom endpoint, id model dipilih, Apply diklik
  • Pesan uji coba berfungsi di sesi baru

Lihat juga