API Dokümantasyonu Sansürsüz Sohbet Tamamlamaları İçin

Hızlı Başlangıç: Python veya JavaScript ile Bağlayın

Temel URL'yi güncelleyerek ve API anahtarınızı ayarlayarak API'ye bağlanın. Uç nokta standart chat-completion isteklerini kabul eder ve metin döndürür. Arayüz tam olarak onların spesifikasyonuna uyduğu için resmi OpenAI SDK'larını kullanıyorsanız özel kütüphaneler kurmanıza gerek yoktur.

Bağlantıyı doğrulamak için basit bir HTTP isteğiyle başlayın. Temel bir istek göndermek için aşağıdaki curl komutunu kullanın. uncensored model. Değiştirin YOUR_API_KEY panonuzda oluşturulan anahtar ile.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Python geliştiricileri için süreç neredeyse aynıdır. İstemciyi anahtarınız ve doğru base URL ile başlatın. Bu, tüm isteklerin mevcut araçlarla uyumluluğu korurken uncensored sunucularımız üzerinden yönlendirilmesini sağlar.

Copyfrom openai import OpenAI

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

JavaScript users can achieve the same result using the Node SDK. Set the baseURL endpoint'imize özellik. Bu yaklaşım, API'yi minimum kod değişikliğiyle web sunucularına veya arka uç hizmetlerine entegre etmenizi sağlar.

Copyimport OpenAI from "openai";

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

Kimlik doğrulama ve API anahtarı yönetimi

Kimlik doğrulama, başlıkta geçirilen tek bir API anahtarına dayanır. Bu anahtarı Authorization header'ı her istek için kullanın. Anahtar eksikse veya geçersizse API hemen bir 401 hatası döndürür. Bu, ön ödemeli kredinize güvenli erişimi sağlar.

Anahtarınızı panelden oluşturun. Anahtar oluşturulduğunda bir kez gösterilir. Güvenli bir şekilde ortam değişkenlerinizde saklayın. Herkese açık olarak paylaşmayın. Her hesap aynı anda yalnızca bir aktif anahtarı destekler. Yeni bir anahtar oluşturmak öncekini anında geçersiz kılar.

Anahtarı isteklerinizde bu şekilde kullanın: Authorization: Bearer YOUR_API_KEY. Bu standart başlık biçimi tüm büyük SDK'larla çalışır. Geliştirme sırasında hızlı iterasyon için anahtarınızı elinizin altında tutun.

Sohbet Tamamlamaları uç noktası parametreleri

İstekleri /v1/chat/completions endpoint. Mesaj dizinizi ekleyin ve modeli uncensored. Parametreleri ayarlayabilirsiniz temperature ve top_p yaratıcılığı kontrol etmek için. Daha yüksek değerler daha çeşitli yanıtlar üretir.

Ayarla max_tokens çıktı uzunluğunu sınırlamak için. Belirtilmediğinde varsayılan 2.048 tokendır. Model, istem ve tamamlama için 100.000 tokenlık bir bağlam penceresi destekler. Bu, kesilme olmadan uzun konuşmalara olanak tanır. Şunu ayarlayın presence_penalty ve frequency_penalty rol yapma senaryolarındaki tekrarları azaltmak için.

Şu stop belirli ifadelerde üretimi durdurmak için parametre. Bu, diyalog yapısını zorlamaya yardımcı olur. The seed parametre, test için tekrarlanabilir çıktılar sağlar. Bu araçlar, modelin davranışı üzerinde hassas kontrol sağlar.

Akış yanıtları ve kullanım verileri

Ayarlayarak akışı etkinleştirin stream: true istekinizde. API, oluşturuldukları anda metin parçaları döndürür. Bu, son kullanıcılar için algılanan gecikmeyi azaltır. Her parça kısmi metin ve meta veri içerir.

Kullanım verileri son chunk'ta görünür. Bu, giriş ve çıkış token sayılarını içerir. Şunu kontrol edin: usage field son yanıt nesnesinde. Bu, ayrı API çağrıları olmadan doğru faturalandırma doğrulamasına olanak tanır. Token tüketimini gerçek zamanlı izleyin.

Akış sonlandırmasını dikkatlice yönetin. Bağlantıyı kapatmadan önce tüm parçaları işlediğinizden emin olun. Son parça, kapsamlı kullanım istatistiklerini içerir. Bu veri, üretim uygulamalarında maliyet ve performans izleme için önemlidir.

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)

Hata yönetimi ve hız sınırlamaları

API, anahtar başına dakikada 300 istek sınırı uygular. Eşzamanlı istekler anahtar başına sekizle sınırlıdır. İstek gövdesi 8 MB'ı aşmamalıdır. Bu sınırları aşmak 429 hatası döndürür. Geçici dalgalanmaları yönetmek için üstel geri çekilme uygulayın.

Yaygın hatalar arasında geçersiz anahtarlar için 401 ve yetersiz kredi için 402 bulunur. Bir 402 yanıtı önceden ödenen bakiyenizin tükendiğini gösterir. Hizmeti devam ettirmek için hesabınızı doldurun. Hatalar tokenları tüketmez, bu nedenle sorunu düzelttikten sonra yeniden denemek ücretsizdir.

Ayrıntılı hata mesajları için yanıt gövdesini kontrol edin. API, bir hata türü ve mesajı içeren bir JSON nesnesi döndürür. Bu bilgileri sorunları hızlıca hata ayıklamak için kullanın. Doğru hata yönetimi, yüksek trafik dönemlerinde kullanıcılarınız için sorunsuz bir deneyim sağlar.

JSON modu ve fonksiyon çağırma kılavuzu

JSON modunu response_format için {"type": "json_object"}. Bu, modelin geçerli JSON çıktısı vermesini zorlar. Yapılandırılmış veri çıkarımı veya API yanıtları için idealdir. İstenilen şemayı açıkça tanımladığınızdan emin olun.

Fonksiyon çağırma, modelin araçları çağırmasına olanak tanır. Araçları istek gövdesinde tanımlayın. Model uygun olduğunda araç çağrıları döndürür. Bu çağrıları uygulama mantığınızda işleyin. Bu, karmaşık çok adımlı iş akışlarını mümkün kılar.

JSON modunu sağlam entegrasyonlar için fonksiyon çağırma ile birleştirin. JSON çıktısını istemci tarafında doğrulayın. Kullanın tool_choice işlevlerin ne zaman çağrılacağını kontrol eden parametre. Bu esneklik çeşitli uygulama mimarilerini destekler. Optimal performans için araçlarınızın iyi tanımlandığından emin olun.

Model detayları ve bağlam penceresi sınırları

The uncensored model 100.000 token'lık bir bağlam penceresi destekler. Bu pencere hem girdi istemini hem de çıktı tamamlamasını kapsar. İstek başına maksimum çıktı 16.000 token'dır. Bu, cümle ortasında kesilmeden kapsamlı rol yapma senaryoları oluşturmanıza olanak tanır.

Model açık ağırlıklıdır ve kısıtlamasız içerik için ayarlanmıştır. Yasal yetişkin konularını reddetmez. GPT, Claude veya başka bir satıcının modeli değildir. İstekler özel sunucularımızda işlenir. Bu, tutarlı performans ve düşük gecikme süresi sağlar.

Kontekst kullanımını izleyerek limitler içinde kalın. API token kullanımını doğru şekilde takip eder. Hatalar ve reddetmeler token tüketmez. Bu şeffaf faturalandırma modeli maliyetlerinizi tahmin etmenize yardımcı olur. Değerini maksimize etmek için konteks pencerelerinizi planlayın.