Hermes Agent özel API'si: sağlayıcılar, taşıma protokolleri ve ilk çağrı kontrolleri

Hermes Agent özel endpoint'i dışa dönük olarak, ~/.hermes/config.yaml içindeki providers: altında adlandırılmış bir giriş olarak yapılandırılır; burada api temel URL, transport ise kablo protokolüdür. Bu, Hermes'in kendi API sunucusundan farklıdır; o ters yönde çalışır. Arama sonuçlarında her ikisine de “Hermes özel API'si” denir ve her biri için resmî belgeler aynı sorgulara göre sıralanır — bu yüzden önce yönü düzeltin.

Bu sayfa, Nous Research'ün açık kaynaklı ajanı Hermes Agent hakkındadır. 21 Eylül 2026'da GitHub API'si üzerinde yapılan kontrolde archived: false, disabled: false, bir MIT lisansı ve aynı gün yapılmış bir kod gönderimi görüldü; yayımlanan en yeni sürüm, 14 Eylül 2026'da v2026.9.14 etiketi verilmiş olan Hermes Agent v0.21.3'tür ve bir ön sürüm değildir. Bu sayfanın yapılandırma bilgilerini aldığı kaynaklar söz konusu depo ve hermes-agent.nousresearch.com'dur. hermes-agent.org, nousresearch.com dışındaki bir alan adından aynı projeyi ele alır ve Microsoft Clarity analizlerini yükler (21 Eylül 2026'da kontrol edilmiştir); projenin kendi kaynaklarından biri değildir, bu nedenle yapılandırma bilgilerini buradan almayın. Burada söz konusu olan, Nous'un açık ağırlıklı model ailesi Hermes 3 veya Hermes 4 ya da aynı adlı JavaScript motoru da değildir.

Hermes özel API'si adıyla anılan iki zıt şey

Her iki satır da 21 Eylül 2026'da okunan Hermes'in kendi sayfalarından alıntılanmıştır: sağlayıcı referansı ve API sunucusu sayfası. Kendi kurulumunuzda kontrol etmeye değer bir adlandırma ayrıntısı: API sunucusu sayfası, onu çalıştıran komut olarak hermes gateway'i belgelerken CLI referansı, hermes gateway'i run, start, stop ve status alt komutlarına sahip mesajlaşma hizmeti yöneticisi olarak tanımlar. Tahmin etmek yerine hermes gateway --help'i çalıştırın. Aşağıdaki her şey dışa dönük kısımdır.

Minimum dışa dönük yapılandırma

# ~/.hermes/config.yaml
providers:
  kunavo:
    api: https://api.kunavo.com/v1   # aliases accepted: base_url, url
    key_env: KUNAVO_API_KEY          # or inline api_key:, or key_cmd:
    transport: chat_completions      # set it by hand; see the transport section
    models:
      claude-sonnet-5:
        prompt_caching: true

model:
  default: claude-sonnet-5
  provider: custom:kunavo

KUNAVO_API_KEY=your-key

Sağlayıcı referansından alan alan: yapılandırma anahtarı providers.<name>, temel URL alanı api (base_url ve url takma adları da kabul edilir), kimlik bilgisi key_env, satır içi bir api_key veya bir key_cmd, protokol alanı ise transport olarak belirtilir. Aynı giriş ayrıca şu alan ve ayarları kabul eder: name, default_model, models, context_length, discover_models, extra_body, extra_headers, session_affinity_header, ssl_ca_cert / ssl_verify, catalog_provider ve enabled: false. Girdiyi model.provider: custom:kunavo ile veya oturum ortasında /model custom:kunavo:<model-id> ile seçin.

İki komut birbirinin yerine kullanılamaz. Bir sohbet oturumunun dışında çalıştırılan hermes model, tam sağlayıcı kurulum sihirbazıdır ve sağlayıcı ekleyebilen veya anahtar alabilen tek araçtır. Oturum içindeki /model, yalnızca zaten var olanlar arasında geçiş yapar. Kısa ömürlü token veren kurumsal uç noktalar için key_cmd, stdout'a bir token yazdıran bir komutu belirtir — yalın biçimde veya access_token alanına sahip JSON olarak — Hermes bu komutu çalıştırır ve tokenı süresi dolmadan kısa bir süre öncesine kadar önbelleğe alır; bu yöntem, aynı girdideki statik api_key veya key_env ayarına göre önceliklidir.

Alanı boş bırakmak yerine transport'u elle seçin

Sağlayıcı referansı, özel bir girdide transport için kabul edilen üç değeri listeler. Ayrıca hermes model Custom Endpoint sihirbazının artık protokolü açıkça sorduğunu ve yanıtı config.yaml dosyasına kaydettiğini; URL tabanlı otomatik algılamanın “alan boş bırakıldığında hâlâ yedek yöntem olarak gerçekleştiğini” söyler. Belgelerde açıkça belirtilen tek algılama kuralı, /anthropic yolunun anthropic_messages değerine eşlenmesidir; Kunavo temel URL'si bununla eşleşmez. Burada okunan hiçbir sayfada buluşsal yöntemin geri kalanı listelenmediği için, ne yapacağını tahmin etmek yerine alanı açıkça doldurmak gerekir. Kunavo /v1/chat/completions, /v1/messages ve /v1/responses uç noktalarını sunar; dolayısıyla kâğıt üzerinde her taşıma protokolünün karşılık gelen bir yolu vardır.

Anthropic satırı, kesin bir yanıt yerine bir çekince gerektirir. Hermes'in Azure Foundry kılavuzu, Anthropic SDK'sinin her isteğe /v1/messages yolunu eklemesi nedeniyle /v1 bölümünün temel URL'den çıkarıldığını belirtir — ancak bu cümle Azure başlığı altında yer alır ve sağlayıcı referansının kendi örneği (api: https://proxy.example.com/anthropic), Hermes'in genel bir proxy için hangi soneki eklediğini söylemez. Bu nedenle yukarıdaki iki aday da makuldür ve bunlardan biri çift /v1 nedeniyle 404 üretebilir. İlk çağrınızın gerçekten kaydettiği istek yolunu kontrol edin; temel URL belgesi, bu protokoldeki 404'lerin çoğuna yol açan origin ile /v1 arasındaki karışıklığı açıklar. Kimlik doğrulama daha küçük bir endişedir: Kunavo'nun Messages uç noktası hem Authorization: Bearer hem de x-api-key başlığını kabul eder; dolayısıyla Anthropic SDK'sinin genel bir proxy için gönderdiği başlık hangisi olursa olsun kabul edilmesi beklenir — ancak Hermes bu seçimi belgelemez, bu yüzden dürüst ifade “kabul edilmesi beklenir”dir.

Bu sayfanın kesin bir yanıt veremeyeceği açık bir soru daha var. Hermes, GPT-5.x ailesindeki model adları için sessizce codex_responses kullanımına geçtiğini, config.yaml dosyasında hâlâ chat_completions yazsa bile bunu yaptığını belgeler — ancak bu cümle provider: azure-foundry altında yer alırken model adı algılaması şeklinde ifade edilmiştir. provider: custom ayarıyla kullanılan bir GPT slug'ının aynı geçişi tetikleyip tetiklemediği belgelenmemiştir. GPT sınıfı bir model seçerseniz ilk çağrının hangi yola gittiğini kaydedin.

Transport başına özel endpoint'in ücretsiz elde edemediği şeyler

Bunların hiçbiri plan kısıtı değildir. Hermes Agent, projenin kendi ana sayfa SSS'sine göre “MIT lisansı altında ücretsiz ve açık kaynaklıdır”; providers: sözlüğü de bir seviye özelliği değil, normal yapılandırma olarak belgelenmiştir. Bunlar yetenek kısıtlarıdır ve kabloya göre farklılık gösterir.

Özellikle bir ağ geçidi için iki kaçış yolu vardır. catalog_provider bir Hermes sağlayıcı kimliğini veya models.dev kimliğini kabul eder ve girişteki modellerin bu kataloğun meta verilerini devralmasını sağlar — yalnızca aramalar yapılır; istekler hâlâ anahtarınızla api URL'nize gider. discover_models: false ise /models yoklamasını tamamen atlar ve yalnızca girişte listelediğiniz modelleri kullanır; bu, keşfin gürültülü veya yavaş olduğu durumlarda çözümdür. Kunavo'nun /v1/models yanıtının Hermes'in yoklamasını karşılayıp karşılamadığı burada test edilmemiştir; karşılamazsa bağlam algılama 128K varsayılanına düşer. Bu ayarların arkasındaki maliyet mantığı — yardımcı yuvalar, temsilci çalışanlar ve önbellek sürekliliği — burada tekrarlanmak yerine Hermes Agent fiyatlandırması bölümünde açıklanmıştır.

Gerçek çalışmayı taşımadan önce uygulamanız gereken doğrulama merdiveni

Bunlar, beklemeniz gereken gözlemle birlikte sizin çalıştırmanız için adımlardır; Kunavo'nun elde ettiği sonuçlar değildir. Kunavo'ya karşı hiçbir Hermes çalıştırması yapılmamıştır, Hermes için bir Kunavo kurulum kılavuzu yoktur ve bu sayfadaki hiçbir şey test edilmiş bir entegrasyon olarak okunmamalıdır. Çalışma rotanızı süreç boyunca kullanılabilir durumda tutun.

1. Sağlayıcıyı ekleyin, ardından tanılayın. hermes model bunu ekler; hermes doctor yapılandırma ve bağımlılık sorunlarını tanılamak için belgelenmiştir ve CLI referansı, çalıştırdığı iki özel uç nokta yapılandırma kontrolünü kaydeder — YAML listesi olmayan bir custom_providers anahtarı ve eşleşen providers: girdisi olmayan eski bir liste girdisi. Her ikisi de yalnızca uyarı üretir ve --fix bunları yeniden yazmaz.
2. Herhangi bir harcama yapmadan önce anahtarın yüklendiğini doğrulayın. hermes dump kopyalayıp yapıştırmaya hazır bir kurulum özeti yazdırır — sürüm, sağlayıcı, model ve API anahtarının mevcut olup olmadığı. Model kimliğinizi ve mevcut bir anahtarı görmeyi bekleyin. hermes prompt-size çevrimdışı çalışır ve her turun herhangi bir konuşma içeriğinden önce taşıdığı sabit bölüm olan sistem istemi ile araç şemalarının bayt dökümünü raporlar.
3. Akışsız tek bir metin turu. Yanıt bekleyin ve isteğin amaçladığınız yola gittiğini doğrulayın. “Çalışan” ancak anlamsız çıktı döndüren özel bir uç nokta, Hermes'in hızlı başlangıç sorun giderme tablosunda yer alır; tablo yanlış temel URL'yi, yanlış model adını veya gerçekte OpenAI uyumlu olmayan bir uç noktayı belirtir ve önce uç noktayı ayrı bir istemcide doğrulamanızı söyler.
4. Tek bir akışlı tur. Sonunda tek blok yerine artımlı çıktı bekleyin. Belirli bir uç noktanın akış çerçevelemesinin Hermes'in ilerleme ayrıştırmasını karşılayıp karşılamadığı bu sayfada test edilmemiştir.
5. Tek bir araç turu. Aracın yürütülmesini bekleyin. Çağrı bunun yerine metin olarak yazdırılırsa bu, taşımanın değil, sunucu tarafının araç çağırma desteğidir.
6. Ölçeri okuyun. /usage oturum içi belirteç, maliyet ve bağlam panelidir. Bunu, sağlayıcı hesabınızın fiilen kaydettiği ücretle karşılaştırın — bir aracının bildirilen belirteçler üzerinden yaptığı kendi hesabı bir tahmindir, muhasebe kaydı değildir. Kullanım belgesine bakın.

Merdivenin maliyeti ve oturum ortasında geçişin maliyeti

Yukarıdaki altı adımın toplamda 26.000 giriş belirteci gönderdiğini ve 1.150 çıkış belirteci aldığını varsayın — üç çağrının her birinde sabit sistem istemi ve araç şeması, ayrıca bir kez yeniden gönderilen bir araç sonucu. Bu varsayım yalnızca örnektir; hermes prompt-size kendi sabit isteminizi, bu sayfanın tahmin edebileceği bir sayıdan gerçeğe daha yakın olan bayt dökümü olarak raporlar. Ücretler, milyon belirteç başına güncel Kunavo kataloğu fiyatlarıdır.

Bu, ölçülmüş bir Hermes görevi veya fatura tavanı değil, katalog oranları üzerinden yapılan örnek belirteç hesabıdır. Önbellek yazmalarını, harici araçları ve vergiyi içermez. Sayının amacı küçüklüğünü göstermektir: bir rotayı doğrulamak, planlanmış bir haftalık çalışmadan sonra yanlış yapılandırmayı keşfetmekten çok daha düşük maliyetlidir.

İkinci sayı, /model komutunun gizlediği sayıdır. İstem önbellekleri isteği sunan modele göre anahtarlanır; bu nedenle konuşma ortasında yapılan herhangi bir model değişikliği, bir sonraki mesajın tüm konuşmayı önbellek tarifesi yerine tam giriş fiyatından yeniden okumasına neden olur. Hermes, önbellek tarifesini yaklaşık yüzde 75 ila 90 daha ucuz olarak tanımlar. Claude Sonnet 5 ile yürütülen 120.000 belirteçlik bir konuşmada, milyon başına $1,40 ile $0,14 önbellek okuma tarifesi arasındaki fark, o tek tur için yaklaşık $0,151 olur — bir kez önemsizdir, alışkanlık hâline geldiğinde ise önemsiz değildir. Kunavo'nun katalog tutarı bir üst sınır değil, faturalandırma tabanıdır: üst kaynak kendi ücretini bildirdiğinde fatura, katalog maliyeti ile üst kaynak maliyetinin geçerli fiyat artış katsayısıyla çarpımından büyük olanıdır. Minimum tutar, abonelik olmaksızın $10 tutarında ön ödemeli bir yüklemedir. Faturalandırma bölümüne bakın.

Yapılandırmayı yeniden geri almak

Hermes bir geri alma yolu belgeler; denemenin düşük riskli olmasının nedeni budur. Girişteki enabled: false onu silmeden gizler. config.yaml öğesinin belirli bir zamandaki kopyaları, backups/config/config.yaml.<reason>.<timestamp> öğesine hermes setup veya hermes migrate onu yeniden yazmadan önce ve ayrıştırdığı her seferde yazılır; aynı tekrarlar atlanır ve neden başına yalnızca en yeni beş kopya tutulur. Dosya daha sonra ayrıştırılamazsa Hermes yerleşik varsayılanlar yerine en yeni iyi kopyayı sunar. Yapılandırma referansı ayrıca model.base_url öğesini “sağlayıcı değişikliğinde temizlenir” şeklinde belirtir; bu nedenle yerleşik bir sağlayıcıya geri dönmek, eski temel URL'yi dosyada bırakmak yerine kaldırmak olarak belgelenmiştir — varsaymak yerine yazılan değeri sonradan kontrol edin.

Üç tuzak eski öğreticilerden kaynaklanır. Eski üst düzey custom_providers: listesi hâlâ çalışır ve hermes update bunu otomatik olarak providers: sözlüğüne taşır; burada eski model, default_model olur ve eski api_mode, transport olur. .env içindeki LLM_MODEL tamamen kaldırılmıştır — config.yaml tek doğruluk kaynağıdır. Ayrıca OPENAI_BASE_URL, iki güncel resmi sayfada iki farklı şekilde belgelenmiştir: sağlayıcı referansı bunun yalnızca openai-api sağlayıcısı için dikkate alındığını söylerken, ortam değişkenleri referansı bunu özel bir uç noktanın temel URL'si olarak listeler. Bu anlaşmazlık çözülmemiştir; bu nedenle uç noktayı config.yaml içinde yapılandırın ve rota olarak bu ortam değişkenine güvenmeyin.

Bir sağlayıcı seçiyor ve sağlayıcıyı bağlamıyorsanız, OpenAI uyumlu API uyumlu yüzeyin neleri kapsayıp kapsamadığını açıklar ve Hermes ile OpenClaw karşılaştırması iki aracıyı karşılaştırır. Bu rotayı finanse edilmiş bir anahtarla test etmeye hazır olduğunuzda Kunavo hesabı oluşturun.

Sık sorulan sorular

Hermes Agent belgeleri — sağlayıcı referansı, API sunucusu sayfası, model yapılandırma sayfası, yapılandırma sayfası, CLI referansı, eğik çizgi komutu referansı, hızlı başlangıç ve proje ana sayfası — 21 Eylül 2026'da okunmuştur. Depo durumu ve en son sürüm aynı gün GitHub API'sine karşı kontrol edilmiştir. Kunavo'nun üç API rotası kendi kaynak kodunda doğrulanmıştır. Her dolar tutarı, güncel katalog oranları üzerinden yapılan örnek belirteç hesabıdır; ölçülmüş bir görev maliyeti değildir. Hermes yapılandırması kaynak belgelerden aktarılmıştır; Kunavo'ya karşı hiçbir Hermes çalıştırması yapılmamıştır.