APIMaster.ai
APIMaster.ai Belgeleri
Quick startAPIMaster.aiMarketplace

Hermes Desktop ile APIMaster.ai

Windows veya macOS'te Hermes Desktop için OpenAI uyumlu API anahtarı ve temel URL'sini ayarlayın, ardından Ayarlar'dan bir model seçin.

APIMaster.ai, OpenAI ile uyumludur. Hermes iki ortam değişkenini okur, ardından modeli masaüstü arayüzünden seçersiniz.

Hızlı kurulum

Adım 1 — API Anahtarınızı Alın

  1. APIMaster konsolunu açın.
  2. API Anahtarınızı kopyalayın (genellikle sk- ile başlar).
  3. Gerçek bir anahtarı asla sohbete veya ekran görüntülerine yapıştırmayın; aşağıda your_apimaster_key yer tutucusunu kullanın.

Adım 2 — .env dosyasını düzenleyin

Windows

  1. Win + R tuşlarına basın, aşağıdakini yapıştırın ve Enter'a basın:

    %LOCALAPPDATA%\hermes

  2. .env dosyasını Not Defteri'nde açın (dosya yoksa oluşturun).

  3. Tipik tam yol:

    C:\Users\KullanıcıAdınız\AppData\Local\hermes\.env

macOS

Hermes Desktop, ~/.hermes dizinini CLI ile paylaşır (resmi dokümanlar). Anahtarları ~/.hermes/.env dosyasına koyun.

Seçenek A — Finder (önerilir)

  1. Git → Git'e Git… (Shift + Command + G).

  2. Aşağıdakini yapıştırın:

    ~/.hermes

    (~ = ana klasörünüz; .hermes Finder'da gizlidir, Git'e Git'i kullanmadığınız sürece.)

  3. .env dosyasını TextEdit'te açın (yoksa oluşturun).

Seçenek B — Terminal

open ~/.hermes

Tam yol

/Users/KullanıcıAdınız/.hermes/.env

Adım 3 — Bu satırları ekleyin

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL /v1 ile bitmelidir — yalnızca https://apimaster.ai değil.
  • = işareti etrafında boşluk olmamalı, Hermes dokümanları aksini söylemedikçe tırnak işareti kullanmayın.
  • Dosyayı kaydedin.

Adım 4 — Hermes Desktop'ı yeniden başlatın

Hermes'i tamamen kapatın (tepsi simgesi dahil), ardından tekrar açın.

Uygulamada modeli seçin

  1. Hermes Desktop'ı açın.

  2. Ayarlar → Model → Ana model'e gidin.

  3. Sağlayıcı: Özel uç nokta.

  4. Model: desteklenen bir model kimliği seçin, örneğin:

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

    Tam liste için pazar yerine veya yöneticinize bakın.

  5. Uygula'ya tıklayın, ardından Ayarlar'ı kapatın.

Hermes Desktop: Ayarlar → Model → Ana model

Test: bir model seçin ve mesaj gönderin

1. Ana modeli Ayarlar'da ayarlayın (gerekli)

  1. Ayarlar'ı açın (kenar çubuğu veya sol alt köşe).
  2. Model → Ana model'e gidin.
  3. Sağlayıcı: Özel uç nokta (veya gösteriliyorsa openai-api).
  4. Model açılır menüsünü açın ve bir kimliğe tıklayın (örn. gpt-5.4) — bir görünen ad yazmayın.
  5. Uygula'ya tıklayın ve Ayarlar'ı kapatın.

Uygula'dan sonra yeni sohbetler bu modeli kullanır; eski sohbetler öncekini kullanmaya devam edebilir.

2. Yeni bir sohbet başlatın

  1. Sohbet listesine dönün.
  2. Yeni sohbet (veya +) öğesine tıklayın.
  3. Eski bir konu değil, yeni bir oturum kullanın.

3. Etkin modeli kontrol edin (önerilir)

Giriş alanının yakınında openai-api / gpt-5.4 gibi bir şey görebilirsiniz. Yanlışsa, Ana modeli düzeltin, Uygula'ya tıklayın ve başka bir yeni sohbet açın. Bazı sürümler, besteleyicinin yanında küçük bir model açılır menüsü de sunar.

4. Bir test mesajı gönderin

Merhaba, ok ile yanıtla yazın ve Enter'a basın. Normal bir yanıt, Anahtar, temel URL ve modelin çalıştığı anlamına gelir.

5. Hala çalışmıyor mu?

Hata metnini (401, 404, zaman aşımı) kontrol edin, .env dosyasını düzenledikten sonra Hermes'in yeniden başlatıldığını doğrulayın veya aynı anahtarla API bağlantı testini çalıştırın.

SSS

Sorun Ne kontrol edilmeli
Gönderme başarısız URL https://apimaster.ai/v1; anahtar tamamen kopyalanmış; model kimliği tam; .env düzenlemesinden sonra Hermes yeniden başlatılmış
Klasör eksik Mac'te ~/.hermes kullanın (Application Support değil); Hermes'i bir kez başlatın veya mkdir -p ~/.hermes
Özel uç nokta yok Hermes'i en son sürüme güncelleyin
Yanlış modeller Kimlikler APIMaster'dan gelir; bkz. Desteklenen modeller

İsteğe bağlı: Aynı anahtarla API bağlantı testi.

Güvenlik

  • API anahtarlarını Slack, e-posta veya herkese açık belgelerde paylaşmayın.
  • Destek taleplerinde ve ekran görüntülerinde yalnızca yer tutucular kullanın.
  • Sızdırılırsa, konsoldaki anahtarı iptal edin, .env dosyasını güncelleyin ve Hermes'i yeniden başlatın.

Kontrol listesi

  • API Anahtarı konsoldan kopyalandı (gizli tutuldu)
  • .env dosyasında OPENAI_API_KEY ayarlandı
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (/v1 ile birlikte)
  • .env kaydedildi
  • Hermes tamamen yeniden başlatıldı
  • Sağlayıcı = Özel uç nokta, model kimliği seçildi, Uygula'ya tıklandı
  • Test mesajı yeni bir oturumda çalışıyor

Ayrıca bakınız