API Dokümantasyonu & Hızlı Başlangıç

Temel URL ve Kimlik Doğrulama

Başlamak için temel URL'yi HTTPS://api.uncensoredal.com/v1 olarak ayarlayın ve API anahtarınızı Authorization üst bilgisi olarak iletin. Hesap başına bir aktif anahtar alırsınız ve yeni bir anahtar oluşturmak öncekini anında geçersiz kılar. Bu basit kurulum, karmaşık yönlendirme mantığı olmadan herhangi bir standart OpenAI uyumlu istemci ile çalışır.

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

Endpoint yalnızca sohbet tamamlamaları içindir, bu nedenle model yönlendirmesi yönetmenize gerek yoktur. Her istek, doğru çıkarım sunucusuna eriştiğinizden emin olmak için model tanımlayıcısı olarak "uncensored" içermelidir. Kimlik doğrulama hataları, anahtar eksik veya geçersizse 401 durum kodunu döndürür.

Sohbet Tamamlamaları Uç Noktası

messages dizisindeki mesaj geçmişiniz ile /v1/chat/completions adresine POST isteği gönderin. Sistem metin girdisini işler ve yasal yetişkin kullanım için içerik reddetmeleri olmadan oluşturulan metni döndürür. Uyumluluğu sağlamak için yükünüzde modeli "uncensored" olarak belirtmeniz gerekir.

Copyfrom openai import OpenAI

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

İstekler, gerçek token kullanımına göre faturalandırılır; hatalar ve reddetmeler ücretsizdir. Bu ön ödemeli model, yalnızca tükettiğiniz şey için ödeme yapmanızı sağlar. Uç nokta, çıktı rastgeleliğini kontrol etmek için sıcaklık ve top_p gibi standart parametreleri destekler.

SSE ile Akış Yanıtları

Tokenları Sunucu Tarafı Olayları aracılığıyla almak için istek gövnenizde stream'i true olarak ayarlayarak akışı etkinleştirin. Her parça, son parçada token kullanım istatistiklerini içerir, bu da maliyetleri gerçek zamanlı olarak takip etmenize olanak tanır. Bu yaklaşım, uzun oluşturular için algılanan gecikmeyi azaltır.

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)

Metin oluşturulurken görüntülenmesini gerektiren arayüzler oluştururken akış kullanın. API, mevcut UI kütüphaneleriyle kolayca entegre edilebilen standart OpenAI uyumlu akış olaylarını döndürür. Kullanıcı girdisini değiştirdiğinde akışı erken durdurabilirsiniz.

Fonksiyon Çağırma ve JSON Modu

İşlev çağırma veya response_format kullanarak JSON çıktısını zorlamak için istek gövnenize araçlar tanımlayın. API, modelin ne zaman bir işlev çağırması gerektiği konusunda hassas kontrol için tool_choice'u destekler. Bu özellik, standart OpenAI şemasıyla çalışır, böylece mevcut araç tanımlamalarını yeniden kullanabilirsiniz.

Copyimport OpenAI from "openai";

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

JSON modu, çıktının programatik olarak yapılandırılmış verileri ayrıştırmak için geçerli JSON olmasını sağlar. Yaratıcılığı yapısal güvenilirlikle dengelemek için bunu sıcaklık ayarlarıyla birleştirebilirsiniz. API, fonksiyon çağırma mantığını, işleme için kodunuzun işlemesi gereken fonksiyon çağrısı ayrıntılarını döndürerek yönetir.

Model Parametreleri Yapılandırması

Oluşturma davranışını kontrol etmek için sıcaklık, top_p, stop dizileri ve seed parametrelerini yapılandırın. Bağlam penceresi, hem istem hem de tamamlama için 100.000 token'ı destekler. Maksimum çıktı isteği başına 16.000 token ile sınırlıdır veya max_tokens belirtmezseniz 2.048 token ile sınırlıdır.

Uzun metinlerde tekrarları azaltmak için presence_penalty ve frequency_penalty parametrelerini kullanabilirsiniz. Bu parametreler, temel ağırlıkları değiştirmeden modelin üslubunu ince ayarlamaya olanak tanır. Belirli kullanım durumunuz için doğru dengeyi bulmak için bunları kademeli olarak ayarlayın.

Limitler, Hatalar ve Bağlam

Hız sınırları dakikada 300 istek ve anahtar başına 8 eşzamanlı istek olarak ayarlanmıştır. İstek gövdeleri 8 MB ile sınırlandırılmıştır, bu nedenle büyük bağlam pencereleri dikkatlice yönetilmelidir. Hatalar arasında geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız sınırları için 429 bulunur.

Kredi süresi dolmaz, bu nedenle yoğunluklar arasında kullanıma ara verebilir ve fonlarınızı kaybetmezsiniz. Eşzamanlılık sınırına ulaşırsanız, üstel geri çekilme ile yeniden deneyin. 100.000 token'lık bağlam penceresi kapsamlı bir geçmişe izin verir, ancak sınırlamaları kaçınmak için çıktı limitlerine dikkat edin.