Heretic LLM: API Dokümantasyonu

Temel URL ve Kimlik Doğrulama

Heretic LLM API'sini kullanmaya başlamak için OpenAI uyumlu istemcinizi temel URL'mize yönlendirin: https://api.hereticllm.com/v1. API standart Bearer token kimlik doğrulaması kullanır. API anahtarını yalnızca e-posta ve şifre kullanarak kaydolarak oluşturabilirsiniz. Anahtar kayıttan hemen sonra gösterilir ve herhangi bir zamanda yeniden oluşturulabilir; bu durumda önceki anahtar geçersiz kılınır.

OPENAI_API_KEY ortam değişkenini ayarlayın veya anahtarı istemci yapılandırmanıza doğrudan iletin. Temel URL'nizin Heretic uç noktasına güncellendiğinden emin olun. Bu kurulum, temel URL'yi ve anahtarı değiştirerek resmi OpenAI SDK'larını sıfır kod değişikliği ile kullanmanızı sağlar.

İlk İstek

Sohbet tamamlamaları uç noktasına ilk isteğinizi gönderin. Model tanımlayıcısı uncensored'dir. Bu açık ağırlıklı model, yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır; sansürsüz kodlama, yaratıcı yazarlık veya araştırma için idealdir. Bağlam penceresi, hem istem hem de tamamlamalar için toplamda 100.000 token'a kadar destekler.

Aşağıda uç noktasını test etmek için temel bir cURL örneği verilmiştir. YOUR_API_KEY yerine gerçek anahtarınızı yazın.

Yanıt, oluşturulan metni içeren standart OpenAI formatında bir nesne olacaktır.

Copycurl https://api.hereticllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK Entegrasyonu

API'yi resmi openai paketini kullanarak Python uygulamalarınıza entegre edin. Kütüphane JSON serileştirmesini ve akışı otomatik olarak yönetir. İstemciyi API anahtarınız ve doğru temel URL ile başlatın. Ardından, model kimliği uncensored ile chat.completions.create'i çağırın.

Bu yaklaşım hem eşzamanlı hem de eşzamansız iş akışlarıyla sorunsuz çalışır. Model, standart istemlere, fonksiyon çağırma'ya ve akış parametrelerine diğer OpenAI uyumlu uç noktalar gibi yanıt verir. Modelin davranışını yönlendirmek için sistem istemlerini iletebilir veya doğrudan etkileşim için kullanıcı mesajlarını kullanabilirsiniz.

Copyfrom openai import OpenAI

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

Node.js SDK Entegrasyonu

JavaScript ve TypeScript projeleri için openai npm paketini kullanın. İstemciyi Heretic temel URL'si ve API anahtarınızla yapılandırın. API, araç tanımları ve fonksiyon çağırma dahil olmak üzere standart istek yapılarını destekler.

Yanıtı özellikle async/await desenleri kullanırken doğru şekilde işlediğinizden emin olun. Model, uygulama mantığınızda doğrudan işlenebilecek metin yanıtları döndürür. Bu entegrasyon, sansürsüz LLM yetenekleri gerektiren sohbet arayüzleri, otomatik ajanlar veya veri işleme pipeline'ları oluşturmak için idealdir.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.hereticllm.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ı

API isteğinizde stream parametresini true olarak ayarlayarak akışı etkinleştirin. API, metin oluşturuldukça metin parçalarını içeren bir SSE (Sunucu Tarafı Gönderimi) akışı döndürür. Bu, algılanan gecikmeyi azaltır ve sohbet uygulamaları için daha akıcı bir kullanıcı deneyimi sağlar.

Akıştaki her parça, yanıtın bir bölümünü içerir. Arayüzünüzü gerçek zamanlı olarak güncellemek için bu parçaları artımlı olarak işleyin. Akış özelliği OpenAI SDK'ları ile tamamen uyumludur; bu nedenle verileri verimli bir şekilde işlemek için standart stream yineleyicilerini veya olay dinleyicilerini kullanabilirsiniz.

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)

Hız Limitleri, Hatalar ve Bağlam

API, anahtar başına dakikada 300 istek ve 8 MB istek gövdesi boyutu için bir hız limiti uygular. Hız limitini aşarsanız 429 hatası alırsınız. Kimlik doğrulama hataları, geçersiz veya eksik API anahtarı gösteren 401 durumunu döndürür. Ön ödemeli krediniz tükendiğinde API, bakiye yüklemenizi gerektiren 402 hatasını döndürür.

Kredi süresi dolmaz ve para yatırma (USDT veya USDC) ile $10'dan itibaren bakiye yükleyebilirsiniz; daha büyük yatırımlar için bonus kredi alırsınız. Model 100.000 token'lık bir bağlam penceresi destekler. İstem ve tamamlamalarınızın bu sınıra sığdığından emin olun. Fiyatlandırma ve sınırlar hakkında daha fazla ayrıntı için Fiyatlandırma sayfasını ziyaret edin.