# Cara menjalankan Hermes Agent dengan DeepSeek API dari Atlas Cloud > Panduan langkah demi langkah untuk menjalankan Hermes Agent sumber terbuka pada model DeepSeek V4 melalui API kompatibel OpenAI milik Atlas Cloud, dengan contoh konfigurasi dan harga. Anda telah menginstal Hermes Agent, agen otonom sumber terbuka dari Nous Research, dan sekarang Anda memerlukan model di belakangnya yang cukup murah untuk dibiarkan berjalan sepanjang hari dan cukup kuat untuk menangani panggilan alat nyata. [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 adalah pilihan yang jelas dari segi biaya, dan Atlas Cloud menyediakan keluarga DeepSeek melalui satu titik akhir yang kompatibel dengan OpenAI bersama dengan 300+ model lainnya. Panduan ini memandu Anda dalam menghubungkan Hermes Agent ke DeepSeek di Atlas Cloud, mulai dari base URL dan ID model hingga `config.yaml` yang berfungsi, sehingga agen berjalan di infrastruktur kelas produksi tanpa SDK kedua. ## Apa yang Anda hubungkan Hermes Agent adalah agen persisten yang terus berkembang dan berjalan di server Anda sendiri. Agen ini dirancang agnostik terhadap model dan penyedia, sehingga tidak peduli apakah token DeepSeek berasal langsung dari DeepSeek atau melalui gateway, selama titik akhirnya berbicara dalam bentuk API OpenAI. Atlas Cloud adalah platform inferensi AI multimodal yang mengekspos model teks, gambar, dan video melalui satu kunci API yang kompatibel dengan OpenAI dan satu akun penagihan. Karena permukaannya kompatibel dengan OpenAI, menghubungkan Hermes hanya memerlukan perubahan base URL dan kunci, bukan penulisan ulang. Pemasangan itu penting untuk agen persisten. Hermes dibangun untuk berjalan selama berminggu-minggu, mengakumulasi memori dan keterampilan yang dapat digunakan kembali, sehingga model di belakangnya adalah biaya berulang, bukan panggilan satu kali. DeepSeek V4 menjaga biaya berulang tetap rendah tanpa mengorbankan kualitas pemanggilan alat, dan merutekannya melalui Atlas Cloud berarti kunci yang sama yang menjawab percakapan nantinya dapat menghasilkan gambar atau klip video saat suatu keterampilan membutuhkannya. Anda tidak hanya memilih model murah, Anda memilih titik akhir yang tidak akan dilampaui oleh agen. Dua fakta menentukan keseluruhan pengaturan, dan keduanya perlu dipastikan dengan benar sebelum Anda menyentuh file konfigurasi: * Base URL Atlas Cloud adalah `https://api.atlascloud.ai/v1`. * ID model DeepSeek di Atlas Cloud memiliki awalan `deepseek-ai/`, misalnya `deepseek-ai/deepseek-v4-pro`. Ini berbeda dengan `deepseek-v4-pro` telanjang yang digunakan Hermes dengan penyedia DeepSeek bawaannya, yang mengarah ke titik akhir DeepSeek sendiri. Saat Anda merutekan melalui Atlas Cloud, Anda menggunakan ID berawalan lengkap dan penyedia khusus yang kompatibel dengan OpenAI, bukan yang bawaan. ## Langkah 1: Dapatkan kunci API Atlas Cloud Anda Masuk ke console.atlascloud.ai, buka API Keys, klik Create API Key, dan salin ke tempat yang aman. Aksesnya bersifat bayar sesuai pemakaian, jadi tidak ada deposit dan tidak ada pengeluaran minimum. Anda mendaftar, mendapatkan kunci, dan membayar per permintaan. Jauhkan kunci dari version control. Hermes memisahkan rahasia dari pengaturan dengan sengaja: `config.yaml` menyimpan struktur non-sensitif dan aman untuk di-commit atau dibagikan, sementara `~/.hermes/.env` menyimpan kunci dan diabaikan oleh git secara default. Menempatkan kunci Atlas Cloud di `.env` dan mereferensikannya dengan nama dari konfigurasi memungkinkan Anda membuat versi pengaturan agen tanpa membocorkan kredensial. ``` echo "ATLASCLOUD_API_KEY=kunci-atlas-cloud-anda" >> ~/.hermes/.env ``` ## Langkah 2: Konfirmasi ID model DeepSeek yang dapat Anda panggil Atlas Cloud menerbitkan daftar model langsungnya di titik akhir publik, sehingga Anda tidak perlu menebak ID. Panggilan cepat mengembalikan string persis yang diterima API. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Menanyakan daftar terlebih dahulu bukanlah pekerjaan yang sia-sia. ID model dapat berubah seiring rilis versi baru, dan ID usang dari posting blog atau skrip lama adalah penyebab paling umum kegagalan panggilan pertama. Titik akhir `/v1/models` adalah sumber kebenaran untuk apa yang akan diterima API hari ini, jadi memeriksanya sebelum Anda mengedit konfigurasi menghemat waktu untuk kesalahan model tidak dikenal. Entri DeepSeek yang paling sering Anda gunakan adalah: | ID Model | Terbaik untuk | Jendela konteks | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | Loop agen utama, coding, panggilan alat | 1M token | | `deepseek-ai/deepseek-v4-flash` | Tugas tambahan, throughput tinggi | 1M token | | `deepseek-ai/deepseek-v3.2` | Obrolan umum sensitif biaya | 163K token | DeepSeek V4 Pro tercantum seharga $1,68 per juta token input dan $3,38 per juta token output di Atlas Cloud, sementara V4 Flash seharga $0,14 input dan $0,28 output. Kesenjangan itulah alasan utama untuk membagi pekerjaan utama dan tambahan di antara keduanya, seperti yang dilakukan konfigurasi di bawah. ## Langkah 3: Arahkan Hermes ke Atlas Cloud Karena Atlas Cloud adalah titik akhir khusus yang kompatibel dengan OpenAI, bukan penyedia DeepSeek bawaan Hermes, Anda mendefinisikannya secara eksplisit di `~/.hermes/config.yaml`. Blok provider memberi nama base URL dan variabel lingkungan yang menyimpan kunci Anda, dan blok model memilih ID DeepSeek berawalan. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` Simpan file, lalu mulai agen. ``` hermes ``` Jika pesan pertama mengembalikan balasan normal, koneksinya benar. Jika Anda mendapatkan kesalahan otentikasi, kunci di `.env` salah atau tidak dimuat; jika Anda mendapatkan kesalahan model tidak dikenal, periksa kembali awalan `deepseek-ai/` terhadap output `/v1/models` dari Langkah 2. Kesalahan paling umum di sini adalah menggunakan penyedia `deepseek` bawaan Hermes sambil berharap Atlas Cloud akan menjawab. Penyedia bawaan terhubung secara tetap ke titik akhir DeepSeek sendiri dan nama model telanjangnya, sehingga akan dengan senang hati menagih akun DeepSeek Anda dan mengabaikan Atlas Cloud sepenuhnya. Merutekan melalui Atlas Cloud adalah pilihan penyedia khusus yang disengaja: `base_url` Anda sendiri, kunci Atlas Cloud Anda, dan ID model `deepseek-ai/` berawalan. Jaga ketiganya tetap bersama dan kedua jalur tidak akan pernah tertukar. ## Langkah 4: Kirim pekerjaan murah ke Flash Hermes menjalankan banyak panggilan bernilai rendah di belakang layar: peringkasan web, analisis visi, kompresi konteks, persetujuan perintah. Membayar tarif V4 Pro untuk itu adalah pemborosan. Arahkan slot tambahan ke V4 Flash sehingga loop utama mempertahankan model yang lebih kuat sementara tugas latar belakang berjalan dengan biaya yang jauh lebih kecil. ``` 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 ``` Setiap slot tambahan menerima penyedia, model, base URL, kunci, dan rantai fallbacknya sendiri, sehingga Anda dapat menyesuaikan setiap tugas latar belakang secara independen. ## Langkah 5: Tambahkan fallback untuk ketahanan Agen yang berjalan lama pada akhirnya akan mencapai batas kecepatan atau koneksi yang timeout. Rantai fallback membuatnya tetap bekerja alih-alih menghasilkan kesalahan. Di sini tugas kompresi mencoba V4 Flash terlebih dahulu, kemudian beralih ke model Atlas Cloud kedua sebelum menyerah. ``` 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 mencoba setiap entri secara berurutan hingga salah satu berhasil, sehingga gangguan penyedia tunggal tidak menghentikan agen. Untuk agen yang berjalan tanpa pengawasan sesuai jadwal, ini adalah perbedaan antara cron job yang pulih secara diam-diam dan yang mati pada jam 3 pagi dan meninggalkan stack trace di pagi hari. ## Kapan pengaturan ini tepat Menjalankan Hermes di DeepSeek melalui Atlas Cloud paling masuk akal ketika Anda menginginkan satu kunci dan satu tagihan untuk semua yang disentuh agen. Karena titik akhir yang sama juga menyajikan model gambar dan video, agen yang awalnya hanya teks nantinya dapat menghasilkan gambar atau klip tanpa integrasi baru atau akun vendor kedua. Jika agen Anda hanya akan memanggil DeepSeek dan tidak ada yang lain, penyedia DeepSeek bawaan yang diarahkan ke API DeepSeek sendiri adalah jalur yang lebih sederhana. Rute Atlas Cloud layak digunakan setelah Anda menginginkan ruang untuk menambahkan model di berbagai modalitas di belakang satu permukaan yang kompatibel dengan OpenAI. Anda dapat mengonfirmasi setiap ID model dan harga langsung sendiri di atlascloud.ai/models sebelum Anda melakukan semua ini ke file konfigurasi, yang merupakan kebiasaan yang perlu dipertahankan seiring perkembangan lini DeepSeek. Untuk panduan implementasi terkait, lihat [beralih aplikasi yang kompatibel dengan OpenAI ke LLM lain](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) dan [mengevaluasi API inferensi AI untuk produksi](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).