Hermes api Dokümantasyonu: Hızlı Başlangıç

Kurulum ve Kurulum

Hermes API'si OpenAI formatını konuşan herhangi bir istemci ile çalışır. Bir temel URL ve bir API anahtarına ihtiyacınız vardır. Get API key sayfasında Google veya e-posta aracılığıyla bir hesap oluşturun. Sistem anahtarınızı hemen gösterir. Telefon numarası gerekmez. Yedi gün için $0.50 deneme kredisi alırsınız. Daha sonra yalnızca kripto ile yükleyin.

• Temel URL: HTTPS://api.apihermes.cc/v1
• Auth header: Authorization: Bearer YOUR_API_KEY
• Model Kimliği: uncensored

Tercih ettiğiniz SDK'yı yükleyin ve temel URL'yi ayarlayın. Uç nokta, standart sohbet tamamlama parametrelerini bekler. Anahtarınızı güvende tutun. Yeni bir anahtar oluşturursanız, bir anahtar öncekini değiştirir.

Temel Sohbet Tamamlama İsteği

Temel bir istek mesaj gönderir ve metin yanıtı alır. Model ID'si sansürsüzdür. Yasal yetişkin içeriği reddetmeden işler. Kullandığınız token başına ödeme yaparsınız. Hatalar ve reddetmeler ücretsizdir. Bağlam penceresi toplam 100.000 token kapasitesine sahiptir.

İsteğinizi bir system mesajı ve user mesajı ile yapılandırın. API bir tamamlama döndürür. Çıktı uzunluğunu kontrol etmek için max_tokens'i ayarlayabilirsiniz. Varsayılan çıktı limiti 2.048 token'dır. İstek başına bunu 16.000 token'a kadar yükseltebilirsiniz. Akış (streaming) SSE üzerinden çalışır. İşlev çağırma mevcuttur. JSON modu desteklenir.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

İstek gövdesi 8 MB ile sınırlıdır. Dakikada 300 istek için hız sınırları vardır. Eşzamanlılık aynı anda sekiz istektir. Yeniden deneme mantığı, sunucu aşırı yükünü zarifçe yönetir.

SSE ile Akış Yanıtları

Akış, tokenları oluşturuldukları anda gönderir. Sunucu Sunucu Gönderilen Olaylar gönderir. Her chunk kısmi metin içerir. Son chunk, token kullanım istatistiklerini içerir. Bu yaklaşım, uzun yanıtlar için algılanan gecikmeyi azaltır. Sohbet arayüzleri için idealdir. Akışı doğru şekilde işlemelisiniz. Bağlantı kopmaları olabilir. API, akışın kendisi ötesinde teslimat sırasını garanti etmez.

stream parametresini true olarak ayarlayın. Veri satırlarını ayrıştırın. İçeriği birleştirin. Tamamlanma için finish_reason'ı kontrol edin. uncensored modeli herhangi bir OpenAI-uyumlu SDK ile çalışır. İstemciyi SSE'yi işleyecek şekilde yapılandırın. Belirteç sayısını izleyin. Temel URL aynı kalır. Kimlik doğrulama aynıdır. Ek kurulum gerekmez.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Hatalar akışta görünür. Bağlantıyı kapatarak bunları yönetin. Ön ödemeli kredi yalnızca tamamlanan tokenlar için düşer. Bu, kesintiler sırasında tasarruf sağlar. Kısmi çöp çıktılar için asla ödeme yapmazsınız. Sistem şeffaftır.

Fonksiyon Çağırma ve Araçlar

Fonksiyon çağırma modelin kod veya araçları yürütmesine olanak tanır. Araçları istek gövdesinde tanımlayın. Model bir araç çağrısı döndürür. Aracı yürütürsünüz. Sonucu geri gönderirsiniz. Model nihai yanıtı oluşturur. Bu karmaşık iş akışlarını mümkün kılar. Bu sadece bir sohbet sarmalayıcısı değildir. API araçları ve tool_choice destekler. Ajanlar veya otomasyon için bunu kullanın.

Araçlar dizisini oluşturun. Ad, açıklama ve parametreleri dahil edin. Modelin ne zaman bir aracı çağıracağına model karar verir. Argümanları siz ayrıştırmalısınız. İşlevi çalıştırın. Çıktıyı sohbete iletin. Model devam eder. Bu döngü nihai cevabı alana kadar tekrarlanır. Bağlam penceresi tüm araç etkileşimlerini izler. Token kullanımını takip edin. Araç çıktıları maliyetleri artırır. Son chunk'taki kullanımı izleyin.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apihermes.cc/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)

Uncensored model, çeşitli araç şemalarını işler. İçeriğe göre reddetmez. Rol yapma veya teknik görevler için bunu kullanın. API güvenilirdir. Hatalar yoktur. Ön ödemeli sistem adaleti sağlar. Akışı siz kontrol edersiniz. Temel URL tutarlıdır. Kimlik doğrulama basittir.

JSON Modu ve Parametreler

JSON modu modelin geçerli JSON çıkış yapmasını zorlar. response_format'ı json_object olarak ayarlayın. Bu yapılandırılmış veri için kullanışlıdır. Model markdown sarmalayıcılarından kaçınır. Ham JSON döndürür. Ayrıştırma için kullanın. Güvenilirliği artırır. Bağlam penceresi hala geçerlidir. Tokenlar için ödeme yaparsınız. Uncensored model formatı saygı duyar. İçeriğe dayalı reddetmez.

Parameters include temperature, top_p, stop, seed, presence_penalty, and frequency_penalty. Temperature controls randomness. Top_p controls diversity. Stop sequences halt generation. Seed ensures reproducibility. Presence and frequency penalties adjust token usage. Set these to refine the output. The API supports all standard parameters. Use them to tune the response. The base URL remains the same. Auth is identical.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apihermes.cc/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);

Hatalar HTTP durum kodları aracılığıyla işlenir. 401 geçersiz anahtar anlamına gelir. 402 kredi yok demektir. 429 hız sınırı anlamına gelir. Bunları kodunuzda ele alın. Ön ödemeli kredi yalnızca tamamlanan token'lar için düşer. Bu adaleti sağlar. Kısmi çıktılar için asla ödeme yapmazsınız. Sistem şeffaftır. Uncensored modeli güvenilirdir. Herhangi bir yasal görev için kullanın.

Hata Yönetimi ve Hız Sınırlamaları

API, standart HTTP durum kodlarını döndürür. 401 geçersiz bir API anahtarı olduğunu gösterir. 402 yetersiz ön ödemeli kredi olduğunu gösterir. 429 bir oran limiti olduğunu gösterir. Limit dakikada 300 istektir. Eşzamanlılık aynı anda sekiz istektir. İstek gövdeleri 8 MB ile sınırlıdır. Bu hataları zarifçe işleyin. Üstel geri çekilme ile yeniden deneyin. uncensored model yasal içeriği reddetmez. Hatalar ücretsizdir. Başarısız istekler için ödeme yapmazsınız. Ön ödemeli kredi güvenlidir. Süresi dolmaz. Çift ücretler için Destek sayfasını kullanın. Yalnızca kripto. USDT veya USDC. Bonuslar geçerlidir.