Entegrasyon Kılavuzu: uncensored sohbet tamamlamalar

Temel URL ve Kimlik Doğrulama

Entegrasyonunuzun temeli temel URL ile başlar. Kullanın https://api.loginllm.com/v1 tüm istekler için. Bu uç nokta tamamen OpenAI ile uyumludur, yani mevcut anahtarlarınızı istemci mantığınızı yeniden yazmadan değiştirebilirsiniz.

Kimlik doğrulama tek bir API anahtarına dayanır. Bu anahtarı API anahtarı al Google veya e-posta şifresi ile giriş yapın. Sistem hesabınız başına bir aktif anahtar verir; yeni bir anahtar oluşturmak önceki anahtarı hemen geçersiz kılar. Bu anahtarı güvende tutun, çünkü ön ödemeli kredilerinizi kontrol eder.

Anahtarı Authorization üstbilgiyi Bearer token olarak kullanın. API için karmaşık OAuth akışlarına veya oturum çerezlerine gerek yoktur.

Basit bir curl komutuyla bağlantıyı hemen test edebilirsiniz. Bu, uygulama geliştirme aşamasına geçmeden önce ağınızın sunucularımıza yönelik HTTPS trafiğine izin verdiğinden emin olmanızı sağlar.

Sohbet/tamamlamalar Uç Noktası

Şuraya mesaj gönderin POST /v1/chat/completions endpoint. Bu, metin oluşturma için standart arayüzdür. Modeli uncensored ve istek gövdesinde bir mesaj listesi sağlayın.

Her mesaj bir rol gerektirir (system, user, veya assistant) ve içerik. Sistem bu girdileri işler ve bir tamamlama döndürür. Model yönlendirmesini yönetmeniz veya birden fazla varyant arasından seçim yapmanız gerekmez; kısıtlamasız çıktı için optimize edilmiş tek bir açık ağırlıklı modeli barındırıyoruz.

Bu yaklaşım kodunuzu basit tutar. Birden fazla model sürümünü yönetme veya satıcıya özgü tuhaflıklarla başa çıkma yükünden kaçınırsınız. Yanıt yapısı OpenAI formatıyla eşleşir ve geniş SDK uyumluluğu sağlar.

Bakiyenizi düzenli olarak kontrol edin. Krediler, gerçek token kullanımına göre düşürülür ve hatalar kredileri tüketmez.

Sunum Sunulan Olaylar ile Akış

Gerçek zamanlı kullanıcı deneyimleri için, akışı etkinleştirmek üzere ayarlayın stream: true istekinizde. API, tek bir JSON nesnesi yerine Sunucu Tarafından Gönderilen Olaylar (SSE) akışı döndürür.

Her olay parçası oluşturulan metnin bir bölümünü içerir. Bu metni kullanıcı arayüzünüzde artımlı olarak işleyebilirsiniz; bu, son kullanıcı için algılanan gecikmeyi önemli ölçüde azaltır. Akıştaki son parça, istek için toplam token kullanımını içerir.

Bu özellik, kullanıcıların anında geri bildirim beklediği sohbet arayüzleri için önemlidir. Uygulamanızın ana iş parçacığını engellemeden uzun yanıtları işlemesine olanak tanır.

Bu parçaları toplamak için basit bir olay dinleyicisi uygulayın. Tam yanıtı oluşturmak için birleştirin veya geldikçe canlı olarak görüntüleyin.

Fonksiyon Çağırma ve Araçlar

API, yapılandırılmış araç kullanımı desteği sunar. İşlevleri tools şemanızı içeren dizi.

Model bir işlev çağrısı oluşturduğunda, işlev adını ve argümanları yapılandırılmış bir biçimde döndürür. Uygulamanız işlevi yürütür ve sonucu nihai bir yanıt için modele geri gönderir.

Bu yetenek, mantığı kod olarak yazmaya gerek kalmadan karmaşık iş akışlarını mümkün kılar. Harici veri kaynaklarını, hesaplayıcıları veya özel iş mantığını doğrudan sohbete entegre edebilirsiniz.

Araç tanımlarınızın kesin olduğundan emin olun. Model, her işlev için beklenen girdi ve çıktı formatlarını anlamak için bu şemalara güvenir.

Bağlam Penceresi ve Sınırlar

Model 100.000 token'lık bir bağlam penceresi destekler. Bu pencere hem istem hem de tamamlamayı içerir. Maksimum çıkış uzunluğunu max_tokens parametre.

Eğer max_tokens ayarlanmamışsa, yanıt pencerenin sonuna kadar uzayabilir. Daha yüksek bir değer ayarlamak, 100,000 token sınırına kadar daha uzun yanıtlar oluşturmanıza olanak tanır. Bu, detaylı raporlar veya kod parçacıkları oluşturmak için kullanışlıdır.

Hız sınırlarınızı dikkatlice izleyin. API ana başına dakikada 300 istek ve 8 eşzamanlı istek izni verir. Bu limitleri aşmak bir 429 hatasıyla sonuçlanır.

İstek gövdesi boyutu 8 MB ile sınırlıdır. Büyük bağlam pencereleri daha fazla kredi tüketir, bu nedenle bellek gereksinimlerinizi bütçenizle dengeleyin.

Hata Yönetimi ve Token Kullanımı

Sorunsuz bir kullanıcı deneyimi sağlamak için hataları zarifçe yönetin. 401 hatası geçersiz veya süresi dolmuş bir API anahtarı olduğunu gösterir. Yeniden kimlik doğrulama yapın veya kontrol panelinizden yeni bir anahtar oluşturun.

402 hatası, ön ödemeli bakiyenizin yetersiz olduğunu gösterir. Hizmeti devam ettirmek için USDT (TRC20) veya USDC (Base) ile bakiye yükleyin. Krediler süresi dolmaz, bu nedenle uygun olduğunda para ekleyebilirsiniz.

429 hatası, hız sınırını aştığınızı gösterir. İstekleri otomatik olarak yeniden denemek için istemcinizde üstel geri çekilme uygulayın. Kalan kota bilgisi için her zaman yanıt başlıklarını kontrol edin.

Token kullanımı son akış chunk'ında veya tamamlanma yanıtında raporlanır. Bu verileri kullanarak promptlarınızı optimize edin ve maliyetleri etkili bir şekilde yönetin.

cURL

Copycurl https://api.loginllm.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python loop"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)