API Hızlı Başlangıç & Entegrasyon

Temel URL ve Kimlik Doğrulama

Heretic Projesi, metin üretimi için tek bir barındırılmış uç nokta sağlar. Kullanın https://api.hereticproject.com/v1 temel URL olarak. Kimlik doğrulama, bearer token'ın Authorization header anahtarınızı. Anahtarınızı, panoda Google veya e-posta ile oturum açarak oluşturun. Sistem, her hesap için tek bir aktif anahtar verir; yeni bir anahtar oluşturmak öncekini hemen geçersiz kılar.

Sadece tüketilen token'lar için ödeme yaparsınız. Hatalar ve reddetmeler ön ödemeli krediden düşmez. Yeni bir hesaba yedi gün geçerli $0.50 deneme kredisi verilir. USDT (TRC20) veya USDC (Base) kullanarak $20 ile $500 arasında miktarlarda yükleme yaparsınız.

/v1/chat/completions Uç Noktası

Standart sohbet tamamlama uç noktasına mesaj gönderin. Model kimliği uncensoredRoller gibi rol nesnelerinden oluşan bir liste kabul eder. system, user, veya assistant. Model, yasal yetişkin, kurgusal veya tartışmalı konuları reddetmez. Doğrudan yanıtlar için ayarlanmış açık ağırlıklı bir modeldir.

İstekler oluşturulan metni içeren bir JSON nesnesi döndürür. Bağlam penceresi istem ve tamamlama için toplam 100,000 token destekler. Çıktı, daha düşük bir değer belirtmediğiniz sürece isteğe başına 16,000 token ile sınırlıdır. max_tokens değeri.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK Entegrasyonu

Resmi OpenAI Python kütüphanesini özel bir base URL ile kullanın. Base api_key API dizenize ayarlayın. Yapılandırın base_url Heretic Project sunucusuna bağlanın. Bu, size tanık yöntemleri kullanma imkanı tanır chat.completions.create() mevcut kod yapınızı önemli ölçüde değiştirmeden.

Kütüphaneyi pip aracılığıyla yükleyin. Kimlik bilgilerinizi istemci başlatmasına doğrudan iletin. Kütüphane seri hale getirmeyi otomatik olarak yönetir. Bu yaklaşım hem senkron hem de asenkron iş akışlarıyla çalışır. Olası ağ hatalarını zarifçe yönettiğinizden emin olun.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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 SDK Entegrasyonu

Node.js SDK Python sürümüyle aynı şekilde çalışır. İstemciyi API anahtarınız ve doğru temel URL ile başlatın. Tamamlama isteklerini aynı yöntem imzalarını kullanarak gönderebilirsiniz. Bu, yığınınızın farklı bölümleri arasında tutarlılık sağlar.

Yanıtları eşzamansız olarak yönetin. Akış yöntemini kullanırsanız SDK veri akışı yapar. Aksi takdirde tam JSON yanıtını döndürür. Bu esneklik hem toplu işleme hem de gerçek zamanlı arayüzlere destek olur. API anahtarınızı ortam değişkenlerinde güvende tutun.

Copyimport OpenAI from "openai";

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

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Sunucu, Sunucu Gönderilen Olaylar (SSE) gönderir. Her parça kısmi metin güncellemeleri içerir. Bu, son kullanıcılar için algılanan gecikmeyi azaltır. Token kullanım verileri, akışın son parçasında görünür.

Tam yanıtı biriktirmek için her delta nesnesini işleyin. Akış kapandığında veya bir hata oluştuğunda dinlemeyi bırakın. Bu yöntem sohbet arayüzleri için idealdir. Kullanıcılara düşüncelerin gerçek zamanlı oluşumunu görme imkanı tanır. Tam yanıtlara kıyasla ek yük minimumdur.

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)

Limitler, Hatalar ve Bağlam

Hizmet kesintilerinden kaçınmak için hız sınırlarına dikkat edin. Anahtar başına dakikada 300 istek yapmanıza izin verilir. Eşzamanlılık aynı anda istekle sınırlıdır. İstek gövdesi 8 MB'ı aşamaz. Bu sınırları aşmak 429 durum kodunu döndürür. Yeniden denemeden önce kısa bir süre bekleyin.

Kimlik doğrulama hataları 401 hatası döndürür. Bu anahtar geçersiz veya süresi dolduğunda olur. 402 hatası yetersiz ön ödemeli kredi olduğunu gösterir. Hata hataları Destek sayfası aracılığıyla ele alınır. Kredi asla süresi dolmaz. Model reşitlerle ilgili içerikleri reddeder. Diğer tüm yasal içerikler kabul edilir.