Hızlı Başlangıç: Uncensored API'yi Entegre Edin

Önkoşullar ve SDK Kurulumu

API, geçerli bir API anahtarı ve modern bir SDK gerektirir. Tercih ettiğiniz dil için kütüphaneyi pip veya npm aracılığıyla yükleyin. Kimlik doğrulama ve JSON ayrıştırmayı otomatik olarak yöneten standart OpenAI istemci kütüphanelerini destekliyoruz.

Python 3.8+ veya Node.js 18+ yüklü olduğundan emin olun. SDK'lar bağlantı havuzlaması ve yeniden deneme mantığını sizin için yönetir. Bu, boilerplate kodunu önemli ölçüde azaltır.

Copyfrom openai import OpenAI

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

Temel URL ve API Anahtarını Yapılandırma

İstemcinizi özel uç noktamıza yönlendirin. Panelden sağlanan temel URL'yi kullanın. API anahtarınızı Authorization başlığında iletin. Bu, isteklerin doğrudan sansürsüz altyapıya ulaşmasını sağlar.

Varsayılan OpenAI temel URL'sini kullanmayın. Anahtarınız yanlış yönlendirilirse başarısız olur. Veri göndermeden önce SDK yapılandırma nesnenizde temel URL'yi ayarlayın.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

İlk Sohbet Tamamlama İsteğinizi Gönderme

/v1/chat/completions adresine bir POST isteği gönderin. Model kimliğinizi ve bir messages dizisini dahil edin. Model hemen metin içeriğiyle yanıt verir. Karmaşık yönlendirme mantığı gerekmez.

Yükü basit tutun. Tek bir sistem prompt'u ve bir kullanıcı mesajıyla başlayın. Yanıt yapısının OpenAI standardıyla eşleştiğini doğrulayın. Bu, entegrasyonunuzun doğru çalıştığını onaylar.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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ını ve Araç Kullanımını İşleme

Akış özelliğini etkinleştirmek için stream parametresini true olarak ayarlayın. API, Sunucu Tarafından Gönderilen Olaylar aracılığıyla parçalar döndürür. Her parça kısmi metin veya jeton kullanım verileri içerir. Gerçek zamanlı çıktı görüntülemek için bu parçaları birleştirin.

İşlev çağırma için araç kullanımı desteklenir. Araçlarınızı istekte tanımlayın. Model, uygun olduğunda düz metin yerine araç çağrıları döndürür. Araç çağrılarını ayrıştırarak özel mantığınızı yürütün.

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)

Token Limitleri ve Bağlam Pencereleri

Bağlam penceresi toplamda 100.000 jetonu destekler. Bu, hem giriş hem de çıktı tokenlerini içerir. Yanıt uzunluğunu sınırlamak için max_tokens'i ayarlayın. Belirtilmezse varsayılan maksimum çıktı 2.048 tokendir.

Akış sırasında son parçada token kullanımını izleyin. Hatalar krediyi tüketmez. Bu, finansal risk olmadan güvenli deneyimlemenize olanak tanır. İstem yapınızı limite sığacak şekilde planlayın.

Yaygın Hataları Halletmek

İlk olarak API anahtarınızı kontrol edin. 401 hatası geçersiz veya süresi dolmuş bir anahtarı gösterir. 402 hatası önceden yüklenmiş kredinizin tükendiğini gösterir. Devam etmek için kripto aracılığıyla yükleyin.

429 hatası, hız sınırlamasını gösterir. Dakikada 300 istekle sınırlısınız. Eşzamanlılığı azaltın veya yeniden denemeden önce bekleyin. 8 MB gövde sınırı da aşıldığında 400 hatalarına neden olur.