Hermes Agent base_url değeri /v1 ile bitmeli mi?

Hayır. base_url değerini https://api.wokey.ai, provider değerini custom yapın.

api_mode: codex_responses satırını ne zaman eklerim?

Yalnızca gpt-6-sol gibi GPT modellerinde; en iyi önbellek isabet oranını bu sağlar. Claude ve diğer modellerde bu satırı eklemeyin.

API anahtarı nereye yazılır?

~/.hermes/config.yaml dosyasında model altındaki api_key alanına, yalnızca anahtarın kendisi yazılır.

İstemciler/Hermes Agent

Hermes Agent ile Wokey API kullanımı

Bir Wokey API anahtarı alın, Hermes Agent için base URL olarak Wokey’yi girin ve bağlantıyı tek bir curl isteğiyle doğrulayın.

Güncellendi 2026-11-10

Bu sayfadaexpand_more

Hazırlık
Yapılandırma
Formatlar
Sürekli açık agent
Doğrulama
Sorun giderme
SSS

API anahtarını ve base URL’yi hazırlayınlink

Tüm istemciler aynı Wokey API anahtarını ve aynı base URL’yi kullanır.

API anahtarı oluşturun

Giriş yapın ve API sayfasında bir platform anahtarı oluşturun. Aynı hesaptaki anahtarlar hesabın bakiyesini paylaşır.

API anahtarı oluşturkey

Wokey base URL’sini kullanın

İstemcinin base URL’si olarak gateway alan adını girin; /v1 eklenip eklenmeyeceğini aşağıdaki yapılandırma gösterir.

İstemciyi yapılandırınlink

Hermes Agent için model, özel sağlayıcı, base URL ve API anahtarını içeren ilk beş yapılandırma satırı yeterlidir. GPT modellerinde (örneğin gpt-6-sol) en iyi önbellek isabet oranı için api_mode: codex_responses ekleyin; Claude gibi diğer modellerde eklemeyin.

Hermes Agent

# ~/.hermes/config.yaml
model:
  default: claude-opus-5-5
  provider: custom
  base_url: https://api.wokey.ai
  api_key: YOUR_API_KEY
  # Yalnızca GPT modelleri (örneğin gpt-6-sol) için — en iyi önbellek isabet oranı için yorum işaretini kaldırın:
  # api_mode: codex_responses

API formatları ve base URL’lerlink

Bir istemci API formatını değiştirdiğinde base URL’nin /v1 ile bitip bitmeyeceği değişebilir.

Format	Base URL	Kullanım alanı
OpenAI Chat Completions	https://api.wokey.ai	DeepSeek, GLM, Kimi ve diğer modeller

Yapılandırıldığı yer: ~/.hermes/config.yaml

Hermes Agent uygulamasını Opus 5.5 ile sürekli açık bir agent olarak çalıştırmak: Claude Duet ile karşılaştırmalink

Anthropic, 2026-10-21 tarihinde Claude Duet'in araştırma önizlemesini açtı: Claude Opus 5.5 üzerine kurulu, sabah özeti gönderen, bağladığınız uygulamaları arka planda izleyen ve harekete geçmeden önce size soran proaktif bir agent. Duet yalnızca Claude hesabıyla giriş yapılarak kullanılabilir; API anahtarı veya özel base URL seçeneği yoktur, bu yüzden Wokey üzerinden çalıştırılamaz. Hermes Agent ise açık kaynaklı, kendi barındırdığınız sürekli açık bir agent'tır: Wokey'e bağlandığında aynı Opus 5.5 modelini kullanır; bekleme listesi ve bölge kısıtlaması yoktur.

	Claude Duet	Hermes Agent + Wokey
Model	Claude Opus 5.5, değiştirilemez	claude-opus-5-5 veya Wokey'deki başka herhangi bir model
Kimler kullanabilir	ABD'deki Claude Pro ve Max aboneleri, bekleme listesiyle; Team ve Enterprise henüz desteklenmiyor	Kendiniz kurarsınız; bir Wokey API anahtarı yeterlidir, bölge fark etmez
Maliyet	Önizleme süresince ek ücret yok, ancak planınızın kullanım limitlerini sohbet ve Claude Code ile paylaşır; arka plan kontrolleri de buna dahildir	Token başına ödeme, Wokey bakiyenizden düşülür; ne sıklıkta kontrol edeceğine siz karar verirsiniz
Nerede çalışır	Anthropic bulutunda kendi tarayıcısı olan bir sanal makine; telefonunuz ve dizüstü bilgisayarınız kapalıyken de çalışmaya devam eder	Kendi bilgisayarınız veya sunucunuz; kesintisiz çalışması için sürekli açık bir makinede barındırın
Onunla nasıl konuşulur	Duet uygulaması (iOS ve Android) ve claude.ai	Telegram ve Slack gibi sohbet uygulamaları
Bellek ve araçlar	Claude hesabınızın belleğini, skills öğelerini ve bağlayıcılarını devralır	Bellek, skills ve araçlar yerelde durur; kurulum ve yönetim sizdedir
İşlem öncesi onay	Mesaj göndermeden, ödeme yapmadan, imzalamadan veya silmeden önce sorar; menkul kıymet alım satımına ve hesaplar arası transfere hiçbir zaman izin verilmez	İzinleri ve onay kurallarını siz belirlersiniz; yalnızca gereken hesaplara erişim verin

Token başına faturalandırmada sık kontrol daha pahalıya gelir: her kontrol sistem prompt'unu ve belleği yeniden gönderir. Rutin kontroller için daha ucuz bir model (örneğin claude-sonnet-5-5 veya deepseek-v4.1-flash) kullanın, karar ve işlem gerektiğinde Opus 5.5'e geçin.
Chat Completions üzerinden Opus 5.5 yazmadan önce düşünür, bu yüzden ilk token geç gelir; arka planda çalışan bir agent bundan pek etkilenmez.
Yukarıdaki yapılandırma zaten varsayılan olarak claude-opus-5-5 kullanıyor; değişiklik gerekmez.

Duet bilgilerinin kontrol tarihi: 2026-10-22 · Duet kaynakları: Introducing Claude Duet · Claude Duet FAQ

curl ile doğrulayınlink

İstemci hata verirse önce curl ile anahtar ve base URL sorunlarını eleyin.

Hermes Agent varsayılan olarak OpenAI Chat Completions formatını kullanır. Bu istek 200 dönüyorsa anahtar ve base URL doğrudur. Göndermeden önce YOUR_API_KEY yerine kendi anahtarınızı yazın.

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" }
    ]
  }'

Hatalar ve sorun gidermelink

Önce kimlik doğrulama, bakiye, hız limiti, model kullanılabilirliği ve upstream zaman aşımı durumlarını ayırın.

401

invalid api key

Anahtar eksik, yanlış yazılmış veya silinmiş ya da Authorization ile x-api-key başlıkları çelişiyor.

402

insufficient balance

Hesap bakiyesi yetersiz. Daha fazla istek göndermeden önce bakiye yükleyin.

403

model_denylisted / account_restricted

Modele veya hesaptaki tüm modellere yapılan çağrılar, tekrarlanan ihlallerin ardından duraklatıldı. Bkz. “İhlal işlem ücretleri ve kısıtlamalar”.

403

request_blocked

Bu istek upstream’e ulaşmadan engellendi ve ücretlendirilmez; örneğin modelin az önce reddettiği bir isteğin değiştirilmeden yeniden gönderilmesi veya duraklatılmış bir son kullanıcı (X-End-User-Id). Hata mesajı neyin engellendiğini belirtir; isteği buna göre değiştirin veya daha sonra yeniden deneyin. Diğer istekler etkilenmez.

429

rate limited

İstekler çok sık. Daha sonra yeniden deneyin veya eşzamanlılığı azaltın. Yalnızca tek bir model ya da tek bir son kullanıcı (X-End-User-Id) sürekli 429 döndürüyorsa bu, ihlallerden sonra uygulanan geçici bir limit olabilir.

499

client disconnected

İstemci, yanıt tamamlanmadan bağlantıyı kapattı (kod downstream_aborted). Bu varsayılan olarak ücretsizdir. Bir hesabın son 24 saatte en az 50 istemci kopması olur ve bunlar isteklerinin %10’unu veya daha fazlasını oluşturursa, sonraki kopan istekler upstream’in bildirdiği kullanım üzerinden faturalandırılır: önbellek okuma ve yazma dahil işlenen girdi ve yalnızca upstream saydıysa çıktı. Upstream herhangi bir kullanım bildirmeden önceki kopma ücretsiz kalır. Faturalandırma başladığında hesaba bildirim gönderilir ve kopma oranı normale döndükten sonra bir saat içinde faturalandırma otomatik olarak durur. Olağan neden, çok kısa bir istemci veya proxy zaman aşımı ya da istekleri tamamlanmadan iptal eden bir programdır.

502

upstream unavailable

Upstream model hizmeti geçici olarak kullanılamıyor. Model değiştirin veya daha sonra yeniden deneyin.

504

upstream timeout

Upstream yanıtı zaman aşımına uğradı. Bağlamı kısaltın, max_tokens değerini düşürün veya yeniden deneyin.

529

upstream overloaded

Upstream model geçici olarak aşırı yüklü ve Wokey başka rotalarda zaten yeniden denedi (kod upstream_overloaded). Bunun bakiyenizle ilgisi yoktur. Kısa süre sonra yeniden deneyin veya model değiştirin.

Sık sorulan sorularlink

Hermes Agent base_url değeri /v1 ile bitmeli mi?: Hayır. base_url değerini https://api.wokey.ai, provider değerini custom yapın.
api_mode: codex_responses satırını ne zaman eklerim?: Yalnızca gpt-6-sol gibi GPT modellerinde; en iyi önbellek isabet oranını bu sağlar. Claude ve diğer modellerde bu satırı eklemeyin.
API anahtarı nereye yazılır?: ~/.hermes/config.yaml dosyasında model altındaki api_key alanına, yalnızca anahtarın kendisi yazılır.