API Dokümantasyonu

Kimlik Doğrulama ve Temel URL

API, doğrulama için tek bir API anahtarı gerektirir. Google veya e-posta adresiyle kaydolduktan hemen sonra bu anahtarı alırsınız. Anahtarı Authorization üstbilgiyi Bearer token olarak kullanın. Temel URL https://api.topuncensored.com/v1. Bu URL, herhangi bir OpenAI-uyumlu SDK veya istemci kütüphanesi ile çalışır.

• Header'ı kullanın: Authorization: Bearer YOUR_API_KEY
• İstemcinizin base URL'ini sağlanan uç noktaya ayarlayın.

Bu yapı, kütüphaneleri değiştirirken temel mantığınızı değiştirmeden geçiş yapmanızı sağlar.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

Sohbet Tamamlamaları Uç Noktası

Metin prompt'larını /v1/chat/completions endpoint. Model kimliği uncensored. Bu uç nokta, mesajlarla standart sohbet biçimlendirmesini yönetir. Doğrudan metin yanıtları döndürür. Ek katmanlar veya sarmalayıcılar (wrappers) yoktur. 100,000 tokenlık bağlam penceresini siz kontrol edersiniz. 8 MB'ın altındaki istekler güvenilir çalışır. Doğrudan metin oluşturma için bunu kullanın.

İsteğinizi bir system prompt'u ve user mesajı ile yapılandırın. Model, yasal yetişkin içerikleri filtrelemeden yanıt verir. Eksik anahtarlar gibi hatalar 401 döndürür. Kredi bitti mi? 402 hatası alırsınız. Bunlar net sinyallerdir.

Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true. Oluşturuldukları gibi metin parçaları alırsınız. Bu, uzun çıktılar için algılanan gecikmeyi azaltır. Son parça token kullanım verilerini içerir. Gerçek zamanlı gösterimler veya aşamalı render için kullanın. Yüksek hacimli uygulamalar için verimlidir.

Son yanıtınızı oluşturmak için her parçayı ayrıştırın. Bu yöntem büyük çıktıları zarifçe yönetir. API standart Sunucu Tarafı Olaylarını destekler. Bu, etkileşimli uygulamalar için önerilen yaklaşımdır.

Copyfrom openai import OpenAI

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

Araç Çağırma ve JSON Modu

Yapılandırılmış etkileşimler için fonksiyon çağrısı kullanın. Araçlarınızı isteğinizde tanımlayın. Model yapılandırılmış argümanlar döndürür. Ayarlayın response_format için {"type": "json_object"} katı JSON çıktısı için. Bu, öngörülebilir veri formatları sağlar. Bu özellikleri birleştirerek sağlam entegrasyonlar elde edin. Çıktı yapısı üzerinde hassas bir kontrole sahip olursunuz.

Araç çağırmak standart OpenAI şemasıyla çalışır. JSON modu geçerli JSON'u zorlar. Bunları API entegrasyonları veya veri çıkarma için kullanın. Bu esneklik, karmaşık iş akışlarını destekler.

Copyimport OpenAI from "openai";

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

Parameters and Limits

Ayarla temperature, top_p, ve stop diziler. Ayarlayın max_tokens 16,000 olarak belirtin. Belirtilmezse varsayılan değer 2,048'dir. Tekrarlamayı presence_penalty ve frequency_penaltykullanın. seed belirleyici çıktılar için. Bu parametreler üretim kalitesini ince ayarlar. Çıktı stili üzerinde tam kontrolünüz vardır.

İstek limitleri dakikada 300 istektir. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. Bu limitler stabil performansı sağlar. Kullanımınızı panel üzerinden izleyin. Belirli kullanım durumunuz için parametreleri optimize etmek için ayarları değiştirin.

Hatalar ve Bağlam Penceresi

Hataları zarifçe yönetin. 401 geçersiz anahtarı gösterir. 402 yetersiz krediyi belirtir. 429 hız sınırlarını işaret eder. Bağlam penceresi toplam 100.000 token'dır. Çıktı 16.000 token ile sınırlıdır. Tokenlarınızı akıllıca yönetin. Hatalar krediyi tüketmez. Bu hata ayıklama sırasında tasarruf sağlar. Kullanım istatistikleri için son parçayı kullanın.

Token kullanımınızı takip edin. Oran sınırlarına takılmayın. Üssel geri çekilme ile yeniden deneyin. Bu, güvenilir çalışma sağlar. API sağlamlık için tasarlanmıştır. Hataları normal akışın bir parçası olarak işleyin.

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)