{"id":729,"date":"2026-09-10T10:40:27","date_gmt":"2026-09-10T10:40:27","guid":{"rendered":"https:\/\/masterkurniawan.my.id\/?p=729"},"modified":"2026-09-10T10:46:08","modified_gmt":"2026-09-10T10:46:08","slug":"menghubungkan-hermes-agent-ke-openrouter-melalui-9router","status":"publish","type":"post","link":"https:\/\/masterkurniawan.my.id\/index.php\/2026\/09\/10\/menghubungkan-hermes-agent-ke-openrouter-melalui-9router\/","title":{"rendered":"Menghubungkan Hermes Agent ke OpenRouter melalui 9Router"},"content":{"rendered":"\n

<\/h1>\n\n\n\n
\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

Hermes Agent + 9Router + OpenRouter: Membuat AI Agent dengan Endpoint OpenAI-Compatible<\/h2>\n\n\n\n

Saat menggunakan AI Agent seperti Hermes Agent, kita tidak selalu harus menghubungkannya langsung ke provider AI. Kita bisa menambahkan sebuah layer perantara seperti 9Router<\/strong>.<\/p>\n\n\n\n

Dengan pendekatan ini, arsitektur menjadi lebih fleksibel karena Hermes Agent cukup berkomunikasi dengan satu endpoint lokal, sedangkan 9Router bertugas meneruskan request ke provider AI seperti OpenRouter.<\/p>\n\n\n\n

Pada artikel ini kita akan membangun alur:<\/p>\n\n\n\n

Hermes Agent\n     \u2502\n     \u25bc\n9Router\nlocalhost:20128\/v1\n     \u2502\n     \u25bc\nOpenRouter\n     \u2502\n     \u25bc\nOpenAI GPT-4o-mini<\/code><\/pre>\n\n\n\n
Konfigurasi ini juga menggunakan API OpenAI-compatible sehingga Hermes Agent tidak perlu mengetahui detail koneksi langsung ke OpenRouter.<\/p>\n\n\n\n
\n\n\n\n
1. Apa itu Hermes Agent?<\/h2>\n\n\n\n
Hermes Agent adalah AI Agent yang dapat menjalankan berbagai tugas menggunakan model bahasa sebagai otaknya.<\/p>\n\n\n\n
Berbeda dengan chatbot sederhana, AI Agent dapat menggunakan tools dan melakukan tindakan berdasarkan instruksi yang diberikan.<\/p>\n\n\n\n
Secara sederhana:<\/p>\n\n\n\n
User\n  \u2502\n  \u25bc\nHermes Agent\n  \u2502\n  \u251c\u2500\u2500 Model AI\n  \u251c\u2500\u2500 Tools\n  \u251c\u2500\u2500 Shell\n  \u251c\u2500\u2500 Files\n  \u2514\u2500\u2500 Agent loop<\/code><\/pre>\n\n\n\n
Hermes membutuhkan sebuah model AI untuk menghasilkan reasoning dan respons.<\/p>\n\n\n\n
Model tersebut bisa berasal dari berbagai provider.<\/p>\n\n\n\n
Dalam konfigurasi ini kita tidak menghubungkan Hermes langsung ke OpenRouter, melainkan menggunakan 9Router sebagai perantara.<\/p>\n\n\n\n
Jika hanya dari Hermes ke OpenRouter cukup sederhana:<\/p>\n\n\n\n
export OPENROUTER_API_KEY=”sk-or-v1-…”<\/p>\n\n\n\n
curl -4 –http1.1 -sS
-X POST “https:\/\/openrouter.ai\/api\/v1\/chat\/completions<\/a>“
-H “Authorization: Bearer $OPENROUTER_API_KEY”
-H “Content-Type: application\/json”
–data-raw ‘{“model”:”openai\/gpt-4o-mini”,”messages”:[{“role”:”user”,”content”:”Say hello in Indonesian.”}]}’<\/p>\n\n\n\n
Ketikkan hermes lalu enter<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
\/model openai\/gpt-4o-mini –provider openrouter<\/p>\n\n\n\n
Jika dihubungkan dengan telegram seperti di bawah ini<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
\n\n\n\n
2. Apa itu 9Router?<\/h1>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
9Router digunakan sebagai gateway\/router API.<\/p>\n\n\n\n
Hermes mengirim request ke endpoint lokal:<\/p>\n\n\n\n
http://localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Kemudian 9Router meneruskan request tersebut ke provider yang telah dikonfigurasi.<\/p>\n\n\n\n
Dengan demikian, Hermes tidak perlu langsung mengakses endpoint OpenRouter.<\/p>\n\n\n\n
Secara konsep:<\/p>\n\n\n\n
Hermes\n   \u2502\n   \u2502 OpenAI-compatible API\n   \u25bc\n9Router\n   \u2502\n   \u2502 Provider routing\n   \u25bc\nOpenRouter<\/code><\/pre>\n\n\n\n
Layer seperti ini berguna ketika kita ingin mengelola beberapa provider atau model dari satu endpoint.<\/p>\n\n\n\n
\n\n\n\n
3. Apa itu OpenRouter?<\/h1>\n\n\n\n
OpenRouter menyediakan satu API yang dapat digunakan untuk mengakses berbagai model AI.<\/p>\n\n\n\n
Dalam contoh ini kita menggunakan:<\/p>\n\n\n\n
openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
OpenRouter menjadi upstream provider yang menerima request dari 9Router.<\/p>\n\n\n\n
Jadi posisi OpenRouter berada di belakang 9Router.<\/p>\n\n\n\n
\n\n\n\n
4. Arsitektur yang Kita Bangun<\/h1>\n\n\n\n
Arsitektur akhirnya adalah:<\/p>\n\n\n\n
\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     Hermes Agent                         \u2502\n\u2502                                                          \u2502\n\u2502  AI Agent \/ Tools                         \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n           \u2502\n           \u2502 HTTP\n           \u2502 localhost:20128\/v1\n           \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502       9Router                                  \u2502\n\u2502                                                         \u2502\n\u2502  API Gateway                              \u2502\n\u2502  Model Routing                          \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n           \u2502\n           \u2502 HTTPS\n           \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502     OpenRouter                            \u2502\n\u2502                                                         \u2502\n\u2502  Provider Gateway                     \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n           \u2502\n           \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502    GPT-4o-mini                              \u2502\n\u2502                                                          \u2502\n\u2502      OpenAI                                     \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/code><\/pre>\n\n\n\n
Ada dua koneksi API yang berbeda di sini.<\/p>\n\n\n\n
Hermes \u2192 9Router<\/h3>\n\n\n\n
Hermes menggunakan API key milik 9Router.<\/p>\n\n\n\n
sk-116...<\/code><\/pre>\n\n\n\n
9Router \u2192 OpenRouter<\/h3>\n\n\n\n
9Router menggunakan API key OpenRouter.<\/p>\n\n\n\n
sk-or-v1-...<\/code><\/pre>\n\n\n\n
Kedua API key tersebut memiliki fungsi yang berbeda dan tidak boleh ditukar.<\/p>\n\n\n\n
\n\n\n\n
5. Menyiapkan Provider OpenRouter di 9Router<\/h1>\n\n\n\n
Pertama, buka interface 9Router.<\/p>\n\n\n\n
Pada menu provider, buat custom provider.<\/p>\n\n\n\n
Gunakan tipe:<\/p>\n\n\n\n
openai-compatible<\/code><\/pre>\n\n\n\n
Kemudian gunakan konfigurasi:<\/p>\n\n\n\n
Name:\nopenrouter\n\nBase URL:\nhttps://openrouter.ai\/api\/v1<\/code><\/pre>\n\n\n\n
API key yang digunakan pada koneksi provider adalah API key OpenRouter.<\/p>\n\n\n\n
Setelah provider dibuat, 9Router akan memiliki namespace model:<\/p>\n\n\n\n
openrouter\/...<\/code><\/pre>\n\n\n\n
Dalam setup yang kita gunakan, model GPT-4o-mini nantinya dipanggil dengan:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
\n\n\n\n
6. Membuat Connection di 9Router<\/h1>\n\n\n\n
Pada provider OpenRouter, buat connection.<\/p>\n\n\n\n
Contohnya:<\/p>\n\n\n\n
data<\/code><\/pre>\n\n\n\n
atau:<\/p>\n\n\n\n
data2<\/code><\/pre>\n\n\n\n
Kemudian lakukan:<\/p>\n\n\n\n
Test Connection<\/code><\/pre>\n\n\n\n
Jika muncul:<\/p>\n\n\n\n
\u2713 Connection is working!<\/code><\/pre>\n\n\n\n
berarti 9Router sudah dapat berkomunikasi dengan OpenRouter.<\/p>\n\n\n\n
Ini merupakan langkah penting karena kita bisa memastikan koneksi upstream berfungsi sebelum menghubungkan Hermes.<\/p>\n\n\n\n
\n\n\n\n
7. Menguji 9Router dengan curl<\/h1>\n\n\n\n
Sebelum menghubungkan Hermes, sebaiknya kita melakukan pengujian langsung menggunakan curl.<\/p>\n\n\n\n
Gunakan:<\/p>\n\n\n\n
curl -X POST http:\/\/localhost:20128\/v1\/chat\/completions \\\n  -H \"Content-Type: application\/json\" \\\n  -H \"Authorization: Bearer API_KEY_9ROUTER\" \\\n  -d '{\n    \"model\": \"openrouter\/openai\/gpt-4o-mini\",\n    \"messages\": [\n      {\n        \"role\": \"user\",\n        \"content\": \"Halo, tes GPT-4o-mini melalui 9Router\"\n      }\n    ]\n  }'<\/code><\/pre>\n\n\n\n
Jika berhasil, response akan menunjukkan model seperti:<\/p>\n\n\n\n
{\n  \"object\": \"chat.completion\",\n  \"model\": \"openai\/gpt-4o-mini\",\n  \"provider\": \"Azure\"\n}<\/code><\/pre>\n\n\n\n
Hal yang perlu diperhatikan adalah model yang dikirim ke 9Router:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
Sedangkan pada response, upstream dapat menampilkan:<\/p>\n\n\n\n
openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
Ini menunjukkan request berhasil melewati 9Router dan diteruskan ke OpenRouter.<\/p>\n\n\n\n
\n\n\n\n
8. Bagaimana dengan \/v1\/models?<\/h1>\n\n\n\n
Kita juga dapat mencoba:<\/p>\n\n\n\n
curl -s http:\/\/localhost:20128\/v1\/models \\\n  -H \"Authorization: Bearer API_KEY_9ROUTER\"<\/code><\/pre>\n\n\n\n
Pada konfigurasi tertentu, response dapat berupa:<\/p>\n\n\n\n
{\n  \"object\": \"list\",\n  \"data\": []\n}<\/code><\/pre>\n\n\n\n
Ini tidak otomatis berarti 9Router mati.<\/p>\n\n\n\n
Endpoint \/v1\/models<\/code> dan endpoint \/v1\/chat\/completions<\/code> merupakan dua hal berbeda.<\/p>\n\n\n\n
Yang lebih penting adalah apakah endpoint chat completion dapat memproses request.<\/p>\n\n\n\n
Dalam pengujian konfigurasi ini:<\/p>\n\n\n\n
\/v1\/models<\/code><\/pre>\n\n\n\n
menghasilkan daftar kosong, tetapi:<\/p>\n\n\n\n
\/v1\/chat\/completions<\/code><\/pre>\n\n\n\n
berhasil menjalankan GPT-4o-mini.<\/p>\n\n\n\n
Artinya endpoint chat tetap berfungsi.<\/p>\n\n\n\n
\n\n\n\n
9. Menghubungkan Hermes Agent ke 9Router<\/h1>\n\n\n\n
Sekarang kita konfigurasi Hermes.<\/p>\n\n\n\n
File konfigurasi berada di:<\/p>\n\n\n\n
~\/.hermes\/config.yaml<\/code><\/pre>\n\n\n\n
Sebelum mengubah konfigurasi, sebaiknya buat backup:<\/p>\n\n\n\n
cp ~\/.hermes\/config.yaml ~\/.hermes\/config.yaml.bak<\/code><\/pre>\n\n\n\n
Kemudian konfigurasi model menjadi:<\/p>\n\n\n\n
model:\n  default: openrouter\/openai\/gpt-4o-mini\n  provider: custom\n  base_url: http:\/\/localhost:20128\/v1\n  api_key: API_KEY_9ROUTER\n  api_mode: chat_completions<\/code><\/pre>\n\n\n\n
Perhatikan bagian penting:<\/p>\n\n\n\n
provider: custom<\/code><\/pre>\n\n\n\n
dan:<\/p>\n\n\n\n
base_url: http:\/\/localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Dengan konfigurasi ini Hermes tidak diarahkan langsung ke OpenRouter.<\/p>\n\n\n\n
Hermes diarahkan ke endpoint lokal 9Router.<\/p>\n\n\n\n
\n\n\n\n
10. Kenapa menggunakan provider: custom?<\/h1>\n\n\n\n
Ini bagian yang cukup penting.<\/p>\n\n\n\n
Hermes memiliki provider bawaan seperti OpenRouter.<\/p>\n\n\n\n
Jika kita menggunakan:<\/p>\n\n\n\n
provider: openrouter<\/code><\/pre>\n\n\n\n
Hermes dapat menggunakan endpoint OpenRouter secara langsung.<\/p>\n\n\n\n
Artinya alurnya menjadi:<\/p>\n\n\n\n
Hermes\n   \u2502\n   \u25bc\nOpenRouter\n   \u2502\n   \u25bc\nModel<\/code><\/pre>\n\n\n\n
Padahal yang kita inginkan adalah:<\/p>\n\n\n\n
Hermes\n   \u2502\n   \u25bc\n9Router\n   \u2502\n   \u25bc\nOpenRouter\n   \u2502\n   \u25bc\nModel<\/code><\/pre>\n\n\n\n
Karena itu kita menggunakan:<\/p>\n\n\n\n
provider: custom<\/code><\/pre>\n\n\n\n
dengan:<\/p>\n\n\n\n
base_url: http:\/\/localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Dengan cara tersebut, Hermes memperlakukan 9Router sebagai OpenAI-compatible API endpoint.<\/p>\n\n\n\n
\n\n\n\n
11. API Key Hermes<\/h1>\n\n\n\n
Hermes harus menggunakan API key milik 9Router:<\/p>\n\n\n\n
api_key: API_KEY_9ROUTER<\/code><\/pre>\n\n\n\n
Bukan API key OpenRouter.<\/p>\n\n\n\n
Jadi konsepnya:<\/p>\n\n\n\n
Hermes\n   \u2502\n   \u2502 API_KEY_9ROUTER\n   \u25bc\n9Router\n   \u2502\n   \u2502 API_KEY_OPENROUTER\n   \u25bc\nOpenRouter<\/code><\/pre>\n\n\n\n
Ini merupakan salah satu bagian yang paling sering menyebabkan error ketika melakukan konfigurasi.<\/p>\n\n\n\n
\n\n\n\n
12. Menjalankan Hermes<\/h1>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Setelah konfigurasi selesai, jalankan Hermes:<\/p>\n\n\n\n
hermes<\/code><\/pre>\n\n\n\n
Kemudian coba:<\/p>\n\n\n\n
Halo, siapa kamu?<\/code><\/pre>\n\n\n\n
Jika Hermes memberikan respons, berarti endpoint custom berhasil digunakan.<\/p>\n\n\n\n
Dalam konfigurasi ini model yang digunakan adalah:<\/p>\n\n\n\n
gpt-4o-mini<\/code><\/pre>\n\n\n\n
dengan routing:<\/p>\n\n\n\n
Hermes \u2192 9Router \u2192 OpenRouter<\/code><\/pre>\n\n\n\n
\n\n\n\n
13. Cara Memastikan Hermes Tidak Lagi Direct ke OpenRouter<\/h1>\n\n\n\n
Ini juga penting.<\/p>\n\n\n\n
Sebelumnya Hermes dapat dikonfigurasi:<\/p>\n\n\n\n
provider: openrouter<\/code><\/pre>\n\n\n\n
Jika menggunakan konfigurasi tersebut, Hermes akan langsung menggunakan endpoint OpenRouter.<\/p>\n\n\n\n
Kita tidak menginginkan itu.<\/p>\n\n\n\n
Konfigurasi yang kita gunakan adalah:<\/p>\n\n\n\n
provider: custom\nbase_url: http:\/\/localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Jadi endpoint yang dituju Hermes adalah:<\/p>\n\n\n\n
http://localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Bukan:<\/p>\n\n\n\n
https://openrouter.ai\/api\/v1<\/code><\/pre>\n\n\n\n
\n\n\n\n
14. Alur Request Secara Detail<\/h1>\n\n\n\n
Misalnya kita mengetik:<\/p>\n\n\n\n
Buatkan saya sebuah script Python<\/code><\/pre>\n\n\n\n
Hermes menerima perintah tersebut.<\/p>\n\n\n\n
Kemudian Hermes membuat request:<\/p>\n\n\n\n
POST \/v1\/chat\/completions<\/code><\/pre>\n\n\n\n
ke:<\/p>\n\n\n\n
http://localhost:20128\/v1<\/code><\/pre>\n\n\n\n
dengan model:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
9Router menerima request tersebut.<\/p>\n\n\n\n
Kemudian 9Router melihat prefix:<\/p>\n\n\n\n
openrouter\/<\/code><\/pre>\n\n\n\n
dan mengetahui bahwa request tersebut harus diarahkan ke provider OpenRouter.<\/p>\n\n\n\n
9Router kemudian mengirim request ke:<\/p>\n\n\n\n
https://openrouter.ai\/api\/v1<\/code><\/pre>\n\n\n\n
dengan API key OpenRouter.<\/p>\n\n\n\n
OpenRouter kemudian meneruskan request ke model:<\/p>\n\n\n\n
openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
Model menghasilkan response.<\/p>\n\n\n\n
Response kemudian berjalan kembali:<\/p>\n\n\n\n
GPT-4o-mini\n      \u2193\nOpenRouter\n      \u2193\n9Router\n      \u2193\nHermes\n      \u2193\nUser<\/code><\/pre>\n\n\n\n
\n\n\n\n
15. Diagram Request dan Response<\/h1>\n\n\n\n
Request<\/h3>\n\n\n\n
User\n \u2193\nHermes\n \u2193\nPOST localhost:20128\/v1\/chat\/completions\n \u2193\n9Router\n \u2193\nPOST OpenRouter API\n \u2193\nGPT-4o-mini<\/code><\/pre>\n\n\n\n
Response<\/h3>\n\n\n\n
GPT-4o-mini\n \u2193\nOpenRouter\n \u2193\n9Router\n \u2193\nHermes\n \u2193\nUser<\/code><\/pre>\n\n\n\n
Jadi 9Router berada tepat di tengah-tengah komunikasi.<\/p>\n\n\n\n
\n\n\n\n
16. Pengujian Akhir<\/h1>\n\n\n\n
Ada tiga tahap pengujian yang sebaiknya dilakukan.<\/p>\n\n\n\n
Test 1 \u2014 9Router aktif<\/h3>\n\n\n\n
curl -s http:\/\/localhost:20128\/v1\/models<\/code><\/pre>\n\n\n\n
Jika mendapatkan response JSON, berarti endpoint dapat diakses.<\/p>\n\n\n\n
Misalnya:<\/p>\n\n\n\n
{\"object\":\"list\",\"data\":[]}<\/code><\/pre>\n\n\n\n
server tetap merespons.<\/p>\n\n\n\n
Test 2 \u2014 9Router \u2192 OpenRouter<\/h3>\n\n\n\n
Gunakan:<\/p>\n\n\n\n
curl -X POST http:\/\/localhost:20128\/v1\/chat\/completions \\\n  -H \"Content-Type: application\/json\" \\\n  -H \"Authorization: Bearer API_KEY_9ROUTER\" \\\n  -d '{\n    \"model\": \"openrouter\/openai\/gpt-4o-mini\",\n    \"messages\": [\n      {\n        \"role\": \"user\",\n        \"content\": \"Tes koneksi\"\n      }\n    ]\n  }'<\/code><\/pre>\n\n\n\n
Jika mendapatkan response dari model, jalur 9Router \u2192 OpenRouter sudah berhasil.<\/p>\n\n\n\n
Test 3 \u2014 Hermes \u2192 9Router<\/h3>\n\n\n\n
Jalankan:<\/p>\n\n\n\n
hermes<\/code><\/pre>\n\n\n\n
Kemudian kirim prompt.<\/p>\n\n\n\n
Jika Hermes mendapatkan response, maka seluruh chain sudah bekerja.<\/p>\n\n\n\n
\n\n\n\n
17. Troubleshooting<\/h1>\n\n\n\n
Error: Invalid API key<\/h2>\n\n\n\n
Contohnya:<\/p>\n\n\n\n
Invalid API key<\/code><\/pre>\n\n\n\n
Pastikan API key yang digunakan Hermes adalah API key 9Router.<\/p>\n\n\n\n
Jangan memasukkan API key OpenRouter ke bagian:<\/p>\n\n\n\n
api_key:<\/code><\/pre>\n\n\n\n
Hermes berbicara dengan 9Router, bukan langsung dengan OpenRouter.<\/p>\n\n\n\n
\n\n\n\n
Error: No active credentials for provider<\/h2>\n\n\n\n
Contohnya:<\/p>\n\n\n\n
No active credentials for provider: openai<\/code><\/pre>\n\n\n\n
atau:<\/p>\n\n\n\n
No active credentials for provider: kiro<\/code><\/pre>\n\n\n\n
Artinya 9Router mencoba menggunakan provider tertentu tetapi credential aktif untuk provider tersebut tidak tersedia.<\/p>\n\n\n\n
Periksa model yang digunakan.<\/p>\n\n\n\n
Untuk konfigurasi kita:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
bukan:<\/p>\n\n\n\n
openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
dan bukan:<\/p>\n\n\n\n
kr\/claude-sonnet-4.5<\/code><\/pre>\n\n\n\n
\n\n\n\n
18. Kenapa Prefix Model Penting?<\/h1>\n\n\n\n
9Router menggunakan prefix untuk menentukan routing.<\/p>\n\n\n\n
Dalam konfigurasi kita:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
dapat dibaca sebagai:<\/p>\n\n\n\n
openrouter\/<\/code><\/pre>\n\n\n\n
\u2192 gunakan provider OpenRouter.<\/p>\n\n\n\n
Kemudian:<\/p>\n\n\n\n
openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
\u2192 model yang diminta dari OpenRouter.<\/p>\n\n\n\n
Jadi prefix tersebut bukan nama model OpenAI sebenarnya.<\/p>\n\n\n\n
Ia merupakan bagian dari mekanisme routing 9Router.<\/p>\n\n\n\n
\n\n\n\n
19. Keuntungan Arsitektur Ini<\/h1>\n\n\n\n
Ada beberapa keuntungan menggunakan 9Router di antara Hermes dan OpenRouter.<\/p>\n\n\n\n
1. Satu endpoint untuk Hermes<\/h3>\n\n\n\n
Hermes hanya perlu mengetahui:<\/p>\n\n\n\n
http://localhost:20128\/v1<\/code><\/pre>\n\n\n\n
Tidak perlu mengetahui endpoint setiap provider.<\/p>\n\n\n\n
2. Provider dapat diganti<\/h3>\n\n\n\n
Jika suatu saat ingin menggunakan provider lain, perubahan dapat dilakukan di layer router.<\/p>\n\n\n\n
Hermes tidak harus diubah secara besar-besaran.<\/p>\n\n\n\n
3. Routing model lebih fleksibel<\/h3>\n\n\n\n
Model dapat dipanggil menggunakan namespace tertentu.<\/p>\n\n\n\n
Contohnya:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
4. Credential terpisah<\/h3>\n\n\n\n
API key Hermes dan API key provider tidak harus sama.<\/p>\n\n\n\n
Strukturnya:<\/p>\n\n\n\n
Hermes\n   \u2502\n   \u2502 credential 9Router\n   \u25bc\n9Router\n   \u2502\n   \u2502 credential provider\n   \u25bc\nProvider<\/code><\/pre>\n\n\n\n
5. Dapat menjadi layer abstraksi<\/h3>\n\n\n\n
Hermes cukup berbicara dengan satu API.<\/p>\n\n\n\n
Router yang menangani detail provider di belakangnya.<\/p>\n\n\n\n
\n\n\n\n
20. Kekurangan dan Hal yang Perlu Diperhatikan<\/h1>\n\n\n\n
Layer tambahan juga berarti ada komponen tambahan.<\/p>\n\n\n\n
Tanpa 9Router:<\/p>\n\n\n\n
Hermes \u2192 OpenRouter<\/code><\/pre>\n\n\n\n
Dengan 9Router:<\/p>\n\n\n\n
Hermes \u2192 9Router \u2192 OpenRouter<\/code><\/pre>\n\n\n\n
Jika 9Router mati, Hermes tidak dapat mencapai provider.<\/p>\n\n\n\n
Selain itu, konfigurasi model dan credential harus benar di kedua sisi.<\/p>\n\n\n\n
Karena itu pengujian sebaiknya dilakukan secara bertahap:<\/p>\n\n\n\n
1. OpenRouter\n       \u2193\n2. 9Router \u2192 OpenRouter\n       \u2193\n3. Hermes \u2192 9Router \u2192 OpenRouter<\/code><\/pre>\n\n\n\n
Dengan cara ini jauh lebih mudah mengetahui lokasi masalah ketika terjadi error.<\/p>\n\n\n\n
\n\n\n\n
21. Konfigurasi Akhir<\/h1>\n\n\n\n
Secara ringkas, konfigurasi yang digunakan adalah:<\/p>\n\n\n\n
model:\n  default: openrouter\/openai\/gpt-4o-mini\n  provider: custom\n  base_url: http:\/\/localhost:20128\/v1\n  api_key: API_KEY_9ROUTER\n  api_mode: chat_completions<\/code><\/pre>\n\n\n\n
Kemudian pada 9Router:<\/p>\n\n\n\n
Provider:\nOpenRouter\n\nType:\nopenai-compatible\n\nBase URL:\nhttps://openrouter.ai\/api\/v1\n\nAPI Key:\nAPI_KEY_OPENROUTER<\/code><\/pre>\n\n\n\n
Model yang dipanggil oleh Hermes:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
\n\n\n\n
22. Kesimpulan<\/h1>\n\n\n\n
Dengan konfigurasi ini, Hermes Agent tidak lagi berkomunikasi langsung dengan OpenRouter.<\/p>\n\n\n\n
9Router ditempatkan sebagai API gateway di tengah.<\/p>\n\n\n\n
Arsitektur akhirnya:<\/p>\n\n\n\n
                     \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                    \u2502    Hermes Agent  \u2502
                    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
                             \u2502
                             \u2502 localhost:20128\/v1
                             \u25bc
                    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                    \u2502      9Router     \u2502
                    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
                             \u2502
                             \u2502 OpenRouter API
                             \u25bc
                    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                    \u2502    OpenRouter    \u2502
                    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
                             \u2502
                             \u25bc
                    \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
                    \u2502   GPT-4o-mini    \u2502
                    \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518<\/code><\/pre>\n\n\n\n
Dengan demikian, Hermes berfungsi sebagai AI Agent<\/strong>, 9Router sebagai API gateway\/router<\/strong>, OpenRouter sebagai model gateway<\/strong>, dan GPT-4o-mini sebagai model yang menjalankan inference<\/strong>.<\/p>\n\n\n\n
Setup ini juga membuat arsitektur lebih modular karena masing-masing komponen memiliki fungsi yang jelas.<\/p>\n\n\n\n
Yang paling penting, pengujian langsung terhadap endpoint:<\/p>\n\n\n\n
http://localhost:20128\/v1\/chat\/completions<\/code><\/pre>\n\n\n\n
dengan model:<\/p>\n\n\n\n
openrouter\/openai\/gpt-4o-mini<\/code><\/pre>\n\n\n\n
telah berhasil. Artinya jalur:<\/p>\n\n\n\n
9Router \u2192 OpenRouter \u2192 GPT-4o-mini<\/code><\/pre>\n\n\n\n
sudah berfungsi, dan Hermes kemudian dikonfigurasi menggunakan endpoint 9Router sebagai custom OpenAI-compatible provider.<\/p>\n\n\n\n
<\/p>\n\n\n\n
Kurniawan – xcodepod.cloud<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Hermes Agent + 9Router + OpenRouter: Membuat AI Agent dengan Endpoint OpenAI-Compatible Saat menggunakan AI Agent seperti Hermes Agent, kita tidak selalu harus menghubungkannya langsung ke provider AI. Kita bisa menambahkan sebuah layer perantara seperti 9Router. Dengan pendekatan ini, arsitektur menjadi lebih fleksibel karena Hermes Agent cukup berkomunikasi dengan satu endpoint lokal, sedangkan 9Router bertugas … Baca Selengkapnya<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8,11,9],"tags":[],"class_list":["post-729","post","type-post","status-publish","format-standard","hentry","category-artificial-intelligence","category-cloud","category-server"],"_links":{"self":[{"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/posts\/729","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/comments?post=729"}],"version-history":[{"count":4,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/posts\/729\/revisions"}],"predecessor-version":[{"id":742,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/posts\/729\/revisions\/742"}],"wp:attachment":[{"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/media?parent=729"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/categories?post=729"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/masterkurniawan.my.id\/index.php\/wp-json\/wp\/v2\/tags?post=729"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}