# Hermes Agent'ı DeepSeek API ile Atlas Cloud'dan Çalıştırma > Atlas Cloud'un OpenAI uyumlu API'si aracılığıyla DeepSeek V4 modellerinde açık kaynaklı Hermes Agent'ı çalıştırmak için adım adım kılavuz, yapılandırma örnekleri ve fiyatlandırma ile. Hermes Agent’i, Nous Research’tan açık kaynaklı otonom ajanı kurdunuz ve şimdi arkasında, tüm gün çalışır durumda kalacak kadar ucuz ve gerçek araç çağrılarını kaldıracak kadar güçlü bir modele ihtiyacınız var. [DeepSeek](https://www.atlascloud.ai/models/list/llm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=run-hermes-agent-deepseek-api-atlascloud) V4, maliyet açısından bariz bir seçimdir ve Atlas Cloud, DeepSeek ailesini 300'den fazla modelle birlikte tek bir OpenAI uyumlu uç nokta üzerinden sunar. Bu kılavuz, Hermes Agent’ı Atlas Cloud’daki DeepSeek’e bağlama sürecini, temel URL ve model kimliklerinden çalışan bir `config.yaml` dosyasına kadar adım adım anlatır; böylece ajan, ikinci bir SDK’ya ihtiyaç duymadan üretim kalitesinde bir altyapıda çalışır. ## Neyi bağlıyorsunuz Hermes Agent, kendi sunucunuzda çalışan, kalıcı ve kendini geliştiren bir ajandır. Model ve sağlayıcıdan bağımsız olacak şekilde tasarlanmıştır; bu nedenle DeepSeek token’larının doğrudan DeepSeek’ten mi yoksa bir ağ geçidi üzerinden mi geldiği umurunda değildir, yeter ki uç nokta OpenAI API şeklini konuşsun. Atlas Cloud, metin, görüntü ve video modellerini tek bir OpenAI uyumlu API anahtarı ve tek bir faturalama hesabı üzerinden sunan, tam modal yapay zeka çıkarım platformudur. Yüzey OpenAI uyumlu olduğu için Hermes’i bağlamak, bir temel URL ve anahtar değişikliğidir, yeniden yazma değil. Bu eşleştirme, kalıcı bir ajan için önemlidir. Hermes, haftalarca çalışacak, bellek ve yeniden kullanılabilir beceriler biriktirecek şekilde inşa edilmiştir; bu nedenle arkasındaki model, tek seferlik bir çağrıdan ziyade yinelenen bir maliyettir. DeepSeek V4, bu yinelenen maliyeti düşük tutarken araç çağrısı kalitesinden ödün vermez ve Atlas Cloud üzerinden yönlendirmek, bir sohbet turunu yanıtlayan anahtarın daha sonra bir beceri gerektiğinde bir görüntü veya video klibi oluşturabilmesi anlamına gelir. Sadece ucuz bir model seçmiyorsunuz, ajanın asla aşamayacağı bir uç nokta seçiyorsunuz. Tüm kurulumu belirleyen iki gerçek vardır ve bir yapılandırma dosyasına dokunmadan önce bunları tam olarak doğru anlamakta fayda var: * Atlas Cloud temel URL’si `https://api.atlascloud.ai/v1` şeklindedir. * Atlas Cloud’daki DeepSeek model kimlikleri `deepseek-ai/` önekini taşır, örneğin `deepseek-ai/deepseek-v4-pro`. Bu, Hermes'in yerleşik DeepSeek sağlayıcısıyla kullandığı ve DeepSeek'in kendi uç noktasını işaret eden çıplak `deepseek-v4-pro`'dan farklıdır. Atlas Cloud üzerinden yönlendirirken, yerleşik sağlayıcıyı değil, tam önekli kimliği ve özel bir OpenAI uyumlu sağlayıcıyı kullanırsınız. ## Adım 1: Atlas Cloud API anahtarınızı alın console.atlascloud.ai adresinde oturum açın, API Anahtarları'nı açın, API Anahtarı Oluştur'a tıklayın ve güvenli bir yere kopyalayın. Erişim kullandıkça öde şeklindedir, bu nedenle depozito veya minimum harcama yoktur. Kaydolursunuz, bir anahtar alırsınız ve istek başına ödeme yaparsınız. Anahtarı sürüm kontrolünün dışında tutun. Hermes, sırları ayarlardan bilinçli olarak ayırır: `config.yaml` hassas olmayan yapıyı tutar ve işlenmeye veya paylaşılmaya uygundur, `~/.hermes/.env` ise anahtarları tutar ve varsayılan olarak git tarafından yok sayılır. Atlas Cloud anahtarını `.env` dosyasına koymak ve yapılandırmadan adıyla referans almak, kimlik bilgilerini sızdırmadan ajan kurulumunuzun sürümünü kontrol etmenizi sağlar. ``` echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env ``` ## Adım 2: Arayabileceğiniz DeepSeek model kimliklerini onaylayın Atlas Cloud, canlı model listesini herkese açık bir uç noktada yayınlar, böylece bir kimliği asla tahmin etmeniz gerekmez. Hızlı bir çağrı, API'nin kabul ettiği tam dizeleri döndürür. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Listeyi önce sorgulamak gereksiz bir iş değildir. Model kimlikleri yeni sürümler çıktıkça değişir ve bir blog yazısından veya eski bir betikten alınan güncel olmayan bir kimlik, ilk çağrının başarısız olmasının en yaygın nedenidir. `/v1/models` uç noktası, API'nin bugün neyi kabul edeceğine dair kesin bilgidir; bu nedenle bir yapılandırma dosyasını düzenlemeden önce kontrol etmek, bilinmeyen model hatalarından oluşan bir turu kurtarır. En sık kullanacağınız DeepSeek girişleri şunlardır: | Model Kimliği | En iyi olduğu yer | Bağlam penceresi | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | Ana ajan döngüsü, kodlama, araç çağrıları | 1M token | | `deepseek-ai/deepseek-v4-flash` | Yardımcı görevler, yüksek verim | 1M token | | `deepseek-ai/deepseek-v3.2` | Maliyete duyarlı genel sohbet | 163K token | DeepSeek V4 Pro, Atlas Cloud'da milyon giriş token başına 1,68 $ ve milyon çıkış token başına 3,38 $ olarak listelenirken, V4 Flash giriş için 0,14 $ ve çıkış için 0,28 $ olarak listelenir. Bu fark, ana ve yardımcı işleri aşağıdaki yapılandırmanın yaptığı gibi ikisi arasında bölmenin tüm nedenidir. ## Adım 3: Hermes'i Atlas Cloud'a yönlendirin Atlas Cloud, Hermes'in yerleşik DeepSeek sağlayıcısından ziyade özel bir OpenAI uyumlu uç nokta olduğundan, onu `~/.hermes/config.yaml` dosyasında açıkça tanımlarsınız. Sağlayıcı bloğu, temel URL'yi ve anahtarınızı tutan ortam değişkenini adlandırır; model bloğu ise önekli DeepSeek kimliğini seçer. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` Dosyayı kaydedin, ardından ajanı başlatın. ``` hermes ``` İlk mesaj normal bir yanıt döndürürse, bağlantı doğrudur. Bir kimlik doğrulama hatası alırsanız, `.env` dosyasındaki anahtar yanlıştır veya yüklenmemiştir; bilinmeyen model hatası alırsanız, `deepseek-ai/` önekini 2. Adımdaki `/v1/models` çıktısına karşı yeniden kontrol edin. Buradaki en yaygın hata, Atlas Cloud'un yanıt vermesini beklerken Hermes'in yerleşik `deepseek` sağlayıcısına uzanmaktır. Yerleşik sağlayıcı, DeepSeek'in kendi uç noktasına ve çıplak model adlarına sabit kodlanmıştır; bu nedenle DeepSeek hesabınızı mutlu bir şekilde faturalandıracak ve Atlas Cloud'u tamamen görmezden gelecektir. Atlas Cloud üzerinden yönlendirme, kasıtlı bir özel sağlayıcı seçimidir: kendi `base_url`'niz, Atlas Cloud anahtarınız ve önekli `deepseek-ai/` model kimlikleriniz. Bu üçünü bir arada tutun ve iki yol asla karışmaz. ## Adım 4: Ucuz işleri Flash'a gönderin Hermes arka planda çok sayıda düşük değerli çağrı çalıştırır: web özetleme, görüntü analizi, bağlam sıkıştırma, komut onayı. Bunlar için V4 Pro oranları ödemek israftır. Yardımcı yuvaları V4 Flash'a yönlendirin, böylece ana döngü daha güçlü modeli korurken arka plan işleri maliyetin çok küçük bir kısmıyla çalışır. ``` auxiliary: web_extract: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash timeout: 120 ``` Her yardımcı yuva, kendi sağlayıcısını, modelini, temel URL'sini, anahtarını ve geri dönüş zincirini kabul eder; böylece her arka plan görevini bağımsız olarak ayarlayabilirsiniz. ## Adım 5: Dayanıklılık için bir geri dönüş ekleyin Uzun süre çalışan bir ajan, er ya da geç bir hız sınırına veya zaman aşımına uğramış bir bağlantıya takılacaktır. Bir geri dönüş zinciri, hataya düşmek yerine çalışmaya devam etmesini sağlar. Burada sıkıştırma görevi önce V4 Flash'ı dener, ardından vazgeçmeden önce ikinci bir Atlas Cloud modeline geri döner. ``` auxiliary: compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash fallback_chain: - provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v3.2 ``` Hermes, biri başarılı olana kadar her girişi sırayla dener; böylece tek bir sağlayıcı aksaklığı ajanı durdurmaz. Bir programa göre gözetimsiz çalışan bir ajan için bu, sessizce kendini toparlayan bir cron işi ile sabah 3'te ölen ve size bir yığın izi bırakan arasındaki farktır. ## Bu kurulum ne zaman doğru seçimdir Hermes'i Atlas Cloud üzerinden DeepSeek'te çalıştırmak, ajanın dokunduğu her şey için tek bir anahtar ve tek bir fatura istediğinizde en anlamlı hale gelir. Aynı uç nokta aynı zamanda görüntü ve video modellerini de sunduğundan, yalnızca metinle başlayan bir ajan daha sonra yeni bir entegrasyon veya ikinci bir satıcı hesabı olmadan görüntüler veya klipler oluşturabilir. Ajanınız asla DeepSeek dışında bir şey çağırmayacaksa, DeepSeek'in kendi API'sine yönelik yerleşik DeepSeek sağlayıcısı daha basit yoldur. Atlas Cloud rotası, tek bir OpenAI uyumlu yüzey arkasında modaliteler arasında modeller eklemek için yer istediğinizde yerini kazanır. Tüm model kimliklerini ve canlı fiyatları, bunların herhangi birini bir yapılandırma dosyasına işlemeden önce atlascloud.ai/models adresinde kendiniz doğrulayabilirsiniz; bu, DeepSeek serisi geliştikçe sürdürülmesi gereken bir alışkanlıktır. İlgili uygulama rehberliği için bkz. [OpenAI uyumlu bir uygulamayı diğer LLM'lere geçirme](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) ve [üretim için bir yapay zeka çıkarım API'sini değerlendirme](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).