OpenRouter NSFW kullanıcıları için hızlı başlangıç

Temel URL ve Kimlik Doğrulama

Mevcut sağlayıcınızın base URL'ini https://api.openrouternsfw.com/v1 ile değiştirin. Kimlik doğrulama standart Authorization: Bearer <key> başlığını kullanır. Anahtarınızı Google veya e-posta ile kaydolmadan hemen sonra API anahtarını al sayfasından elde edersiniz. Telefon numarası gerekmez ve anahtar yalnızca bir kez görüntülenir, bu yüzden sayfadan ayrılmadan önce kopyalayın.

Hizmetimiz bağımsız bir API'dir, diğer satıcıların modellerini satan bir aracı değildir. İsteklerde gönderdiğiniz model tanımlayıcısı uncensored olup, kendi sunucularımızda çalışır. Yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde ayarlanmıştır ancak GPT, Claude veya başka bir adlandırılmış satıcı modeli değildir.

İstemci kitaplığınızın bu yeni base URL'yi kullanacak şekilde yapılandırıldığından emin olun. Tüm istekler geçerli bir API anahtarını başlıkta içermelidir. Anahtar eksik veya geçersizse sunucu 401 hatası döndürür. Ön ödemeli krediniz yoksa 402 hatası alırsınız. Bunlar, sunucu hataları değil kimlik doğrulama veya ödeme sorunlarını gösteren standart HTTP durum kodlarıdır.

Sohbet Tamamlamaları Uç Noktası

Temel işlevsellik POST /v1/chat/completions uç noktası aracılığıyla sağlanır. Bu uç nokta, model adını, messages dizisini ve isteğe bağlı parametreleri içeren bir JSON gövdesi kabul eder. Oluşturulan metni, token kullanım istatistiklerini ve bitiş nedenini içeren bir JSON nesnesi döndürür. Bu yapı resmi OpenAI SDK'ları ve çoğu OpenAI uyumlu istemci kitaplıklarıyla uyumludur.

Bir SDK kullanmayı tercih ederseniz özel HTTP istemcileri yazmanıza gerek yoktur. Ancak yapılandırmayı base URL'mize işaret edecek şekilde güncellemeniz gerekir. Aşağıdaki örnek, cURL kullanarak standart bir tamamlama isteğini gösterir. Bu istek, sansürsüz modele bir istem gönderir ve met yanıtı bekler.

Kopyalacurl https://api.openrouternsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Bu API'nin yalnızca metin sunduğunu unutmayın. Embedding, görüntü, ses veya video oluşturma uç noktaları yoktur. Uygulamanız çok modlu girdiler veya çıktılar gerektiriyorsa, bunları ayrıca yönetmeniz gerekir. Hizmetimiz yalnızca yüksek kaliteli metin oluşturma ve sansürsüz model üzerine odaklanır.

Python SDK Entegrasyonu

Python SDK'sı entegrasyon sürecini basitleştirir. İstemciyi doğru base URL ve API anahtarınızla başlatın. Kitaplık HTTP isteklerini ve JSON ayrışmasını sizin için halleder. Model ID'sini uncensored olarak belirterek özel modelimizi kullandığınızdan emin olabilirsiniz.

Kopyalafrom openai import OpenAI

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

Bu kod parçacığı, mesaj gönderme ve yanıt alma işlemini gösterir. İstemci bağlantıyı ve hata bildirimini otomatik olarak yönetir. Sunucu bir hata döndürürse SDK bir özel durum oluşturur. Daha iyi bir kullanıcı deneyimi sağlamak için bu özel durumları uygulama mantığınızda ele almalısınız.

Python SDK'sı yalnızca bir seçenektir. HTTP isteklerini destekleyen herhangi bir dili kullanabilirsiniz. Uç nokta yapısı seçtiğiniz istemciden bağımsız olarak aynı kalır. Bu esneklik, sansürsüz modeli önemli kod değişiklikleri olmadan mevcut herhangi bir iş akışına entegre etmenizi sağlar.

Node SDK Kullanımı

Node SDK'sı Python sürümüne benzer şekilde çalışır. İstemciyi base URL ve API anahtarıyla yapılandırın, ardından chat completions yöntemini çağırın. Bu yaklaşım, metni eşzamansız olarak oluşturması gereken sunucu tarafı uygulamaları veya arka uç hizmetleri için idealdir.

Kopyalaimport OpenAI from "openai";

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

Node.js geliştiricileri bu API'yi mevcut projelerine kolayca entegre edebilir. SDK, JSON verilerinin serileştirilmesini ve ters serileştirilmesini yönetir. Çıktının rastgeleliğini kontrol etmek için temperature veya top_p gibi ek parametreler de belirtebilirsiniz.

İsteklerin eşzamansız doğasını doğru şekilde ele aldığınızdan emin olun. Yanıt verilerini yönetmek için async/await veya Promise zincirlerini kullanın. Bu, model metni oluştururken beklerken uygulamanızın yanıt verir kalmasını sağlar. Node SDK'sı, ölçeklenebilir metin oluşturma hizmetleri oluşturmak için güvenilir bir seçenektir.

Akışlı Yanıtlar

İsteğinizde stream parametresini true olarak ayarlayarak akışı etkinleştirin. Sunucu, tek bir JSON yanıtı yerine bir dizi Sunucu Tarafı Olayı (SSE) gönderecektir. Her olay, oluşturulan metnin kısmi bir parçasını içerir.

Kopyalastream = 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)

Akış, çıktı oluşturuldukça görüntülemek istediğiniz gerçek zamanlı uygulamalar için kullanışlıdır. Akışın son parçası, istek için toplam token kullanımını içerir. Bu, tüm yanıt tamamlanmadan beklemeden maliyetleri doğru bir şekilde izlemenizi sağlar.

Metnin doğru bir şekilde birleştirildiğinden emin olmak için akış olaylarını dikkatlice yönetin. Parçaları aldıkları sırayla birleştirin. Sunucu, parçaların sırayla gönderildiğini garanti eder. Bağlantı kesilirse isteği yeniden göndermeniz gerekebilir. Akış, metin oluşturma görevleri için kullanıcı deneyimini geliştiren güçlü bir özelliktir.

Hız Limitleri ve Bağlam Penceresi

Her API anahtarı dakikada 300 istek ve 8 eşzamanlı istekle sınırlıdır. İstek gövdesinin boyutu 8 MB ile sınırlandırılmıştır. Bu limitleri aşarsanız sunucu 429 durum kodunu döndürür. Bu, belirli bir zaman penceresinde çok fazla istek gönderdiğinizi gösteren standart bir HTTP durum kodudur. Bu hataları istemcinizde zarifçe yönetmek için üstel geri çekilme (exponential backoff) uygulamanız gerekir.

Bağlam penceresi, birleştirilmiş istem ve tamamlama için 100.000 tokene kadar destekler. Ayrı bir çıktı sınırı yoktur. max_tokens parametresini belirtmezseniz, yanıt pencerenin sonuna kadar devam edebilir. Çıktı uzunluğunu max_tokens'i daha düşük bir değere ayarlayarak sınırlayabilirsiniz.

Ön ödemeli kredinizi etkili bir şekilde yönetmek için token kullanımınızı izleyin. Hatalar ve reddiye token tüketmez, bu nedenle başarısız istekler için ücretlendirilmezsiniz. Bu, yalnızca başarılı metin oluşturma için ödeme yaptığınızdan emin olur. Hizmetinizdeki kesintileri önlemek için hız limitlerinize dikkat edin.