Apakah base_url Hermes Agent perlu diakhiri /v1?

Tidak. Atur base_url ke https://api.wokey.ai dan provider ke custom.

Kapan saya menambahkan api_mode: codex_responses?

Hanya untuk model GPT seperti gpt-6-sol, karena memberikan tingkat cache hit terbaik. Jangan tambahkan untuk Claude dan model lainnya.

Di mana API key diisi?

Di kolom api_key di bawah model pada ~/.hermes/config.yaml, hanya key-nya saja.

Klien/Hermes Agent

Menggunakan Wokey API di Hermes Agent

Siapkan API key Wokey, arahkan Hermes Agent ke base URL Wokey, lalu pastikan koneksinya dengan satu request curl.

Diperbarui 2026-11-10

Di halaman iniexpand_more

Persiapan
Konfigurasi
Format
Agent always-on
Verifikasi
Pemecahan masalah
Pertanyaan umum

Siapkan API key dan base URLlink

Semua klien memakai API key Wokey yang sama dan base URL yang sama.

Buat API key

Masuk, lalu buat key platform di halaman API. Semua key dalam satu akun memakai saldo yang sama.

Buat API keykey

Gunakan base URL Wokey

Isi base URL klien dengan domain gateway; konfigurasi di bawah menunjukkan apakah /v1 perlu ditambahkan.

Konfigurasikan klienlink

Hermes Agent hanya memerlukan lima baris konfigurasi pertama untuk model, provider kustom, base URL, dan API key. Untuk model GPT (misalnya gpt-6-sol), tambahkan api_mode: codex_responses agar tingkat cache hit optimal; jangan tambahkan untuk model lain seperti Claude.

Hermes Agent

# ~/.hermes/config.yaml
model:
  default: claude-opus-5-5
  provider: custom
  base_url: https://api.wokey.ai
  api_key: YOUR_API_KEY
  # Hanya untuk model GPT (misalnya gpt-6-sol) — hapus tanda komentar agar tingkat cache hit optimal:
  # api_mode: codex_responses

Format API dan base URLlink

Saat satu klien berganti format API, base URL bisa berubah antara diakhiri /v1 atau tidak.

Format	Base URL	Cocok untuk
OpenAI Chat Completions	https://api.wokey.ai	DeepSeek, GLM, Kimi, dan model lainnya

Lokasi konfigurasi: ~/.hermes/config.yaml

Menjalankan Hermes Agent sebagai agent always-on dengan Opus 5.5: perbandingannya dengan Claude Duetlink

Pada 2026-10-21 Anthropic membuka research preview Claude Duet, agent proaktif berbasis Claude Opus 5.5 yang mengirim ringkasan pagi, memantau aplikasi yang Anda hubungkan di latar belakang, dan meminta persetujuan Anda sebelum bertindak. Duet hanya bisa dipakai dengan masuk ke akun Claude; tidak ada API key maupun base URL kustom, sehingga tidak bisa dijalankan lewat Wokey. Hermes Agent adalah agent always-on open source yang Anda host sendiri: setelah terhubung ke Wokey, agent ini memakai model Opus 5.5 yang sama, tanpa daftar tunggu dan tanpa batasan wilayah.

	Claude Duet	Hermes Agent + Wokey
Model	Claude Opus 5.5, tidak bisa diganti	claude-opus-5-5, atau model lain mana pun di Wokey
Siapa yang bisa memakai	Pelanggan Claude Pro dan Max di AS, lewat daftar tunggu; Team dan Enterprise belum didukung	Anda pasang sendiri; cukup dengan API key Wokey, di wilayah mana pun
Biaya	Tanpa biaya tambahan selama preview, tetapi berbagi batas penggunaan paket Anda dengan chat dan Claude Code, termasuk pemeriksaan di latar belakang	Bayar per token dari saldo Wokey Anda; Anda yang menentukan seberapa sering agent memeriksa
Tempat berjalan	Mesin virtual dengan browser sendiri di cloud Anthropic; tetap bekerja saat ponsel dan laptop Anda mati	Komputer atau server Anda sendiri; host di mesin yang selalu menyala agar bekerja sepanjang waktu
Cara berbicara dengannya	Aplikasi Duet (iOS dan Android) dan claude.ai	Aplikasi chat seperti Telegram dan Slack
Memori dan tools	Membawa memori, skills, dan konektor dari akun Claude Anda	Memori, skills, dan tools tersimpan secara lokal; Anda yang memasang dan mengelolanya
Persetujuan sebelum bertindak	Bertanya dulu sebelum mengirim pesan, membayar, menandatangani, atau menghapus; perdagangan sekuritas dan transfer antarrekening tidak pernah diizinkan	Anda yang mengatur izin dan aturan persetujuan; beri akses hanya ke akun yang diperlukan

Dengan penagihan per token, pemeriksaan yang sering berarti biaya lebih besar: setiap pemeriksaan mengirim ulang system prompt dan memori. Pakai model yang lebih murah (misalnya claude-sonnet-5-5 atau deepseek-v4.1-flash) untuk pemeriksaan rutin, lalu beralih ke Opus 5.5 untuk keputusan dan tindakan.
Lewat Chat Completions, Opus 5.5 berpikir dulu sebelum menulis, sehingga token pertama datang lambat; agent yang bekerja di latar belakang jarang terpengaruh.
Konfigurasi di atas sudah memakai claude-opus-5-5 secara default; tidak perlu diubah.

Informasi Duet diperiksa pada 2026-10-22 · Sumber informasi Duet: Introducing Claude Duet · Claude Duet FAQ

Verifikasi dengan curllink

Jika klien menampilkan error, pastikan dulu API key dan base URL benar dengan curl.

Hermes Agent secara default memakai format OpenAI Chat Completions. Jika request ini mengembalikan 200, berarti API key dan base URL sudah benar. Ganti YOUR_API_KEY dengan key Anda sebelum mengirimnya.

cURL

curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Error dan pemecahan masalahlink

Bedakan dulu kasus autentikasi, saldo, rate limit, ketersediaan model, dan timeout upstream.

401

invalid api key

Key tidak ada, salah ketik, sudah dihapus, atau header Authorization / x-api-key saling bertentangan.

402

insufficient balance

Saldo akun terlalu rendah. Isi saldo sebelum mengirim request lagi.

403

model_denylisted / account_restricted

Panggilan ke model tersebut, atau ke semua model di akun, dijeda setelah pelanggaran berulang. Lihat “Biaya penanganan pelanggaran dan pembatasan”.

403

request_blocked

Request ini diblokir sebelum sampai ke upstream dan tidak dikenai biaya, misalnya pengiriman ulang tanpa perubahan atas request yang baru saja ditolak model, atau pengguna akhir yang dijeda (X-End-User-Id). Pesan error menyebutkan apa yang diblokir; ubah request sesuai pesan tersebut atau coba lagi nanti. Request lain tidak terpengaruh.

429

rate limited

Request terlalu sering. Coba lagi nanti atau kurangi konkurensi. Jika hanya satu model, atau satu pengguna akhir (X-End-User-Id), yang terus mengembalikan 429, itu mungkin batas sementara setelah pelanggaran.

499

client disconnected

Klien menutup koneksi sebelum respons selesai (kode downstream_aborted). Secara default ini gratis. Begitu sebuah akun memiliki setidaknya 50 pemutusan dari sisi klien dalam 24 jam terakhir dan jumlah itu mencapai 10% atau lebih dari request-nya, request terputus berikutnya ditagih sesuai penggunaan yang dilaporkan upstream: input yang diproses, termasuk cache read dan cache write, serta output hanya jika upstream menghitungnya. Pemutusan sebelum upstream melaporkan penggunaan apa pun tetap gratis. Akun diberi tahu saat penagihan dimulai, dan penagihan berhenti otomatis dalam satu jam setelah tingkat pemutusan kembali normal. Penyebab umumnya adalah timeout klien atau proxy yang terlalu singkat, atau program yang membatalkan request sebelum selesai.

502

upstream unavailable

Layanan model upstream sementara tidak tersedia. Ganti model atau coba lagi nanti.

504

upstream timeout

Respons upstream melewati batas waktu. Persingkat konteks, kurangi max_tokens, atau coba lagi.

529

upstream overloaded

Model upstream sementara kelebihan beban dan Wokey sudah mencoba ulang di rute lain (kode upstream_overloaded). Ini tidak berkaitan dengan saldo Anda. Coba lagi sebentar lagi atau ganti model.

Pertanyaan umumlink

Apakah base_url Hermes Agent perlu diakhiri /v1?: Tidak. Atur base_url ke https://api.wokey.ai dan provider ke custom.
Kapan saya menambahkan api_mode: codex_responses?: Hanya untuk model GPT seperti gpt-6-sol, karena memberikan tingkat cache hit terbaik. Jangan tambahkan untuk Claude dan model lainnya.
Di mana API key diisi?: Di kolom api_key di bawah model pada ~/.hermes/config.yaml, hanya key-nya saja.