Hermes API: Sansürsüz Üretim İçin Geliştirici Kılavuzu

Hermes API nedir?

hermes api, büyük ticari sağlayıcılarda tipik olan içerik filtreleri olmadan ham metin üretimi gerektiren geliştiriciler için tasarlanmış sansürsüz büyük dil modeli uç noktasını ifade eder. Bu hizmet, genel amaçlı LLM API'lerine yönelik özel bir alternatiftir ve uncensored olarak etiketlenen tek bir modele odaklanır. İstekleri çeşitli satıcılara yönlendiren çok modellerli ağ geçitlerinin aksine, bu uç nokta özel sunucularda barındırılan, yetişkin, siyasi veya tartışmalı konulardaki soruları reddetmeyecek şekilde ayarlanmış tek bir açık ağırlıklı modeli sunar.

Birincil kullanım durumu, içerik denetiminin istemci tarafından yapıldığı veya modelin yasal yetişkin içeriği engellememesi gereken uygulamalara entegrasyondur. API kesinlikle metin-girdi, metin-çıktıdır. Gömme (embedding), görüntü üretimi veya ses işleme sunmaz. Yetişkin veya kısıtlamaya yer vermeyen yaratıcı yazım için saf metin üretme motoru arayan geliştiriciler, bu uç noktanın mevcut kod tabanlarına doğrudan entegrasyon için uygun olduğunu görecektir.

Bu bağımsız bir hizmet olduğunu belirtmek önemlidir. GPT, Claude veya diğer tedarikçi modellerini sunmaz. Model kendi altyapısında çalışır ve standart bir REST arayüzü üzerinden erişilir. hermes api adı, geliştiriciler arasında bu spesifik sansürsüz üretim yeteneğini, temel açık kaynak varyantlarından ayrı olarak ifade etmek için yaygın olarak kullanılır.

Neden Sansürsüz Bir Model Seçmelisiniz?

Standart LLM'ler, yetişkin temalar, siyasi muhalefet veya niş hobilerle ilgili anahtar kelimelere veya bağlama dayalı olarak tetiklenen reddetme mekanizmaları sıklıkla kullanır. İçerik platformları, rol yapma motorları veya yaratıcı yazım araçları oluşturan geliştiriciler için bu reddetmeler kullanıcı deneyimini bozabilir. Burada sağlanan gibi bir sansürsüz model, içeril yasal değilse (örneğin çocukların dahil olduğu durumlar), belirli bir ahlaki veya güvenlik kılavuzunu uygulamaktan ziyade istemi yanıtlamayı önceliklendirir.

Bir sansürsüz uç nokta seçmek, nihai çıktı üzerinde daha fazla kontrol sağlar. Modelden, 403 veya filtrelenmiş bir yanıt olmadan şiddet, cinsel temalar veya tartışmalı tarihi olayları betimlemesini istiyorsanız, bu API bu amaç için tasarlanmıştır. Özellikle ek güvenlik katmanları ticari sağlayıcılar tarafından eklenmeden temel modellerin davranışını isteyen uncensored llama ve uncensored mistral hayranları için özellikle faydalıdır.

• Tutarlılık: Model, belirsiz bağlama göre rastgele reddetmez.
• Yaratıcı Özgürlük: Kurgu, erotika veya sert mizah üretimi için idealdir.
• Basitlik: Tek model, tek davranış, karmaşık yönlendirme mantığı yok.

OpenAI SDK'ları ile Uyumluluk

Bu uç noktanın en büyük avantajı, OpenAI API spesifikasyonuna sıkı sıkıya bağlı kalmasıdır. Base URL ve API anahtarını değiştirerek resmi openai Python SDK'sını, Node.js istemcisini veya diğer herhangi bir OpenAI uyumlu kütüphaneyi kullanabilirsiniz. Uç nokta, standart istek gövdelerinin ve yanıt yapılarının kutudan çıkarken çalışmasını sağlayan POST /v1/chat/completions ve GET /v1/models destekler.

Entegre etmek için varsayılan base URL'yi https://api.openrouternsfw.com/v1 ile değiştirin ve API anahtarınızı sağlayın. İstek gövdesinde gönderdiğiniz model kimliği uncensored'dir. Bu, sohbet geçmişi, sistem istemleri ve kullanıcı mesajlarını işleme yönelik mevcut kodunuzun hiçbir değişiklik gerektirmediği anlamına gelir. Bu uyumluluk, OpenAI JSON yapısına zaten aşina olan uncensored grok ve deepseek api kullanıcılarına da uzanır.

Uç nokta, tokenların oluşturulurken işlenmesine olanak tanıyan Sunucu Tarafı Olayları (SSE) aracılığıyla akış yanıtlarını destekler. Ayrıca yapılandırılmış çıktı için fonksiyon çağırma (araçlar), JSON modu ve temperature ve top_p gibi standart parametreleri destekler. Bu, birçok standart LLM entegrasyonu için doğrudan değiştirilebilir bir alternatif yapar.

Yapılandırma: Sıcaklık ve Top P

Çıktının rastgeleliğini ve yaratıcılığını kontrol etmek standart parametreler aracılığıyla sağlanır. temperature değeri, sonraki tokenın olasılık dağılımını ayarlar. Düşük bir sıcaklık (örneğin 0,2) çıktıyı daha deterministik ve odaklı hale getirirken, yüksek bir sıcaklık (örneğin 0,8) yaratıcılığı ve çeşitliliği artırır. Yetişkin içerik üretimi için, ortalama bir sıcaklık genellikle tutarlılık ve çeşitlilik arasında en iyi dengeyi sağlar.

top_p parametresi, çekirdek örnekleme kontrolünü sağlar. Modelin yalnızca kümülatif olasılığı p'yi aşan tokenları dikkate almasını sınırlar. Bu, rastgeleliği kontrol etmenin başka bir yoludur ve genellikle sıcaklıkla birlikte kullanılır. Örneğin, top_p değeri 0,95 ise model yalnızca en olası %95 tokenı dikkate alır.

Diğer desteklenen parametreler arasında stop dizileri, tekrarlanabilirlik için seed ve tekrarı azaltmak için presence_penalty ile frequency_penalty yer alır. Bu yapılandırmalar, herhangi bir OpenAI uyumlu modelde yapacağınız gibi istek gövdesine iletilir. Bu ayarları özelleştirmek, hermes api çıktısını belirli stiller veya ayrıntı düzeyleri için ince ayarlamanızı sağlar.

Akış Yanıtlarını İşleme

Akış, gerçek zamanlı kullanıcı deneyimleri için hayati önem taşır. API, tam yanıtı beklemek yerine tokenların oluşturulurken alınmasına olanak tanıyan Sunucu Tarafı Olayları (SSE) destekler. Bu, algılanan gecikmeyi azaltır ve sohbet arayüzleri için kullanıcı deneyimini iyileştirir.

Resmi SDK'ları kullanırken akış, istekte stream=True ayarlanarak etkinleştirilir. SDK, veriler geldikçe veri parçalarını verir. Akıştaki son parça genellikle girdi ve çıktı token sayısını içeren kullanım istatistiklerini içerir. Bu, maliyetleri gerçek zamanlı olarak doğru bir şekilde izlemenize olanak tanır.

SDK dışı uygulamalar için SSE akışını doğrudan ayrıştırabilirsiniz. Her parça data: ile başlar ve ardından bir JSON nesnesi gelir. Son parça data: [DONE] içerecektir. İstemcinizin ağ kesintilerini zarif bir şekilde yönettiğinden emin olun, çünkü akış bağlantıları kopabilir. hermes api, kullanım verilerinin faturalandırma amacıyla son parçada güvenilir bir şekilde raporlandığını sağlar.

Token Verimliliği ve Sınırlamalar

Model, hem istemi hem de tamamlamayı içeren 100.000 tokenlık bir bağlam penceresi destekler. Bu, çoğu uzun formatlı içerik üretimi ve karmaşık akıl yürütme görevleri için yeterlidir. İstek başına ayrı bir çıktı sınırı yoktur ve max_tokens belirtmezseniz yanıt pencerenin sonuna kadar devam edebilir. Çok uzun yanıtlar için istemi parçalara ayırma veya birden fazla tamamlama isteği gönderme mantığı uygulamanız gerekebilir.

Fiyatlandırma şeffaftır ve token kullanımına dayanır. Girdi tokenları 1 milyon token başına $0,15, çıktı tokenları ise 1 milyon token başına $0,50'dir. Hatalar ve reddetmeler (küçük içerik filtresi için) ücretsizdir, bu nedenle yalnızca başarılı üretimler için ödeme yaparsınız. Bu model, yüksek hacimli metin üretimi için verimlidir.

• Bağlam Penceresi: Toplam 100.000 token.
• Maksimum Çıktı: 100,000 token'lık context penceresinin sonuna kadar.
• Hız limiti: Anahtar başına dakikada 300 istek.
• Eşzamanlılık: Anahtar başına 8 eşzamanlı istek.

Diğer Modellerle Karşılaştırma

hermes api değerlendirilirken, diğer uncensored llama veya uncensored mistral seçenekleriyle karşılaştırmak faydalı olacaktır. Ollama gibi kendi kendine barındırılan çözümlerin aksine, bu hizmet altyapı yönetimi gerektirmez. GPU yapılandırmasına veya model ağırlıklarının yönetimine gerek kalmadan güvenilir bir uç nokta elde edersiniz. Çok modellerli ağ geçitlerinin aksine, yönlendirme yükü olmadan tek ve tutarlı bir davranış sunar.

GPT-4o veya Claude gibi ticari modellerle karşılaştırıldığında, bu uç nokta yüksek hacimli metin üretimi için önemli ölçüde daha ucuzdur ve içerik filtreleri uygulamaz. Ancak, en büyük özel modellerin akıl yürütme yetenekleriyle eşleşmeyebilir. İçerik esnekliğinin, en iyi mantıktan daha önemli olduğu görevler için en uygunudur.

deepseek api kullanıcıları için fiyatlandırma yapısı rekabetçidir, ancak model mimarisi farklıdır. hermes api, sansürsüz metin üretimi için optimize edilmiştir; bu nedenle genel amaçlı bir AI'dan ziyade özel bir araçtır. Gömme veya görüntü üretimi gerekiyorsa, bu uç nokta yalnızca metin desteklediğinden farklı bir hizmet kullanmanız gerekecektir.

Kod Örnekleriyle Başlangıç

API'yi entegre etmek basittir. Google veya e-posta ile kaydolarak oluşturabileceğiniz bir API anahtarına ihtiyacınız vardır. Anahtar hemen sağlanır. Ardından, SDK'nızı base URL https://api.openrouternsfw.com/v1 ve model kimliği uncensored ile yapılandırın.

Resmi SDK'yı kullanan temel bir Python örneği:

Kopyalafrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouternsfw.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Ve bir Node.js örneği:

Kopyalaimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouternsfw.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Akış yanıtları için SDK, SSE ayrışmasını otomatik olarak halleder. Parçalar geldikçe bunlar üzerinde yineleme yapabilirsiniz. Bu, uygulamanızda gerçek zamanlı metin gösterimine olanak tanır. hermes api, yanıt formatının OpenAI standardıyla eşleşmesini sağlar; bu nedenle standart kullanım durumları için özel ayrıştırma mantığı gerekmez.

Daha fazla kılavuz

• OpenRouter'a Ücretsiz Alternatif? Gerçekte Ne Alırsınız
• Janitor AI'de OpenRouter Kullanımı: Proxy Kurulumu
• Sansürsüz LLM ile Açık Kaynaklı Discord Botu