Süzgeçsiz AI API Hızlı Başlangıç Kılavuzu
Bu hızlı başlangıç kılavuzu, üçüncü taraf hız sınırlamalarını ve sansür katmanlarını atlayarak uncensored Dolphin API'sini standart OpenAI-uyumlu SDK'larla entegre etmenize yardımcı olur.
Kimlik doğrulama ve base URL kurulumu
Doğrudan barındırılan uç noktamıza bağlanmak için sağlanan temel URL ve API anahtarı ile istemcinizi yapılandırın. Google veya e-posta aracılığıyla kaydolduktan hemen sonra tek bir aktif anahtar alırsınız, telefon numarası gerekmez. Temel URL HTTPS://api.uncensoreddolphinopenrouter.com/v1'dir ve model tanımlayıcısı "uncensored"dir. Bu kurulum, temel_url'yi değiştirmek ve API anahtarınızı Authorization başlığında sağlamak suretiyle herhangi bir OpenAI-uyumlu istemci ile çalışır. Aylık abonelikler veya karmaşık yönlendirmeler yoktur, doğrudan modele erişim sağlanır.
İlk sohbet tamamlamanızı gönderme
uncensored modelden metin yanıtları oluşturmak için chat completions endpoint'ine bir POST isteği gönderin. Standart OpenAI formatını kullanarak basit prompt'lar veya yapılandırılmış mesajlar gönderebilirsiniz. API, yasal yetişkin içerikler için ek güvenlik reddi olmadan doğrudan bir metin yanıtı döndürür. İstek gövdesinde model alanını "uncensored" olarak ayarladığınızdan emin olun. Bu endpoint yalnızca chat completions'u destekler, embedding veya görsel oluşturma desteklemez. Deneme krediniz veya ödenmiş bakiyenizle hemen testlere başlayabilirsiniz.
Python SDK Kullanımı
Temel URL ve API anahtarınızla OpenAI istemcisini başlatarak istekleri programlı olarak gönderin. Bu yaklaşım, temel URL'yi barındırılan uç noktamıza ayarlayarak ve kimlik doğrulama için API anahtarınızı ileterek uncensored LLM'i mevcut Python uygulamalarınıza minimal kod değişikliğiyle entegre etmenizi sağlar. İstemci HTTP isteklerini yönetir ve daha fazla işlem için yanıt nesnesini döndürür. Çıktı stilini kontrol etmek için sıcaklık ve top_p gibi parametreleri ayarlayabilirsiniz. Bu yöntem, özel arayüzler oluşturma veya iş akışlarını otomatikleştirme için idealdir.
Node SDK Kullanımı
OpenAI Node istemcisini API ile etkileşim kurmak için özel temel URL ve API anahtarınızla yapılandırın. Bu, tanıdık SDK kalıplarını kullanan Node.js uygulamalarına sorunsuz entegrasyon sağlar. İstemciyi HTTPS://api.uncensoreddolphinopenrouter.com/v1 adresine yönlendirin ve kimlik doğrulama için anahtarınızı sağlayın. Ardından, istediğiniz parametrelerle sohbet tamamlama yöntemini çağırabilirsiniz. Yanıt, oluşturulan metni ve token kullanım istatistiklerini içerir. Bu kurulum, ünsüzlenmiş metin oluşturma gerektiren sunucu tarafı uygulamaları veya arka uç hizmetleri için mükemmeldir.
Akış yanıtlarını işleme
Gerçek zamanlı token güncellemeleri almak için isteğinizde stream parametresini true olarak ayarlayarak akış özelliğini etkinleştirin. API, tokenlar oluşturulurken anında geri bildirim sağlamak için Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Her parça kısmi metin içerir ve son parça kullanım verilerini içerir. Bu yaklaşım, çıktıyı aşamalı olarak görüntüleyerek kullanıcılar için algılanan gecikmeyi azaltır. SSE akışını ayrıştırarak UI'nizi gerçek zamanlı olarak güncelleyebilirsiniz. Akış özelliği, fonksiyon çağırma veya JSON modu içerenler de dahil olmak üzere tüm sohbet tamamlama istekleri için desteklenir.
Token limitlerini ve maliyetleri anlama
Bağlam penceresi, istem ve tamamlama birlikte olmak üzere 100.000 tokene kadar destekler. İstek başına maksimum çıktı 16.000 token'dır. Fiyatlandırma, 1M giriş tokenı başına $0.15 ve 1M çıktı tokenı başına $0.50'dir ve yalnızca gerçek kullanım için ücretlendirilir. Hatalar ve reddetmeler ücretsizdir, bu da yalnızca başarılı tamamlamalar için ödeme yapmanızı sağlar. Ön ödemeli kredi süresi dolmaz ve kripto ile en az $20 ile yükleyebilirsiniz. Bu şeffaf fiyatlandırma modeli, gizli ücretler olmadan maliyetlerinizi etkili bir şekilde yönetmenize yardımcı olur.
Hız limitleri ve eşzamanlılık
Her API anahtarı kararlı performansı sağlamak için dakikada 300 istek ve 8 eşzamanlı istek ile sınırlıdır. Maksimum istek gövdesi boyutu 8 MB'tır ve büyük bağlam pencerelerini karşılar. Bu limitleri aşarsanız, hız sınırının aşıldığını belirten bir 429 hatası alırsınız. Mevcut bir anahtarı değiştirmek için yeni bir anahtar oluşturabilirsiniz; bir hesap başına yalnızca bir anahtar aktiftir. Bu limitler, yüksek kullanılabilirliği korurken kötüye kullanımı önler. Optimal performans için kullanımınızı izleyerek bu sınırlar içinde kalın.
cURL
curl https://api.uncensoreddolphinopenrouter.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List five key differences between python and rust"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoreddolphinopenrouter.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoreddolphinopenrouter.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ış
stream = 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)Sık sorulan sorular
Uncensored Dolphin API, OpenRouter modelleri ile uyumlu mu?
Evet, API'miz tamamen OpenAI uyumludur; bu nedenle OpenRouter modelleri için kullanılan standart SDK'larla çalışır. Ancak bağımsız bir hizmetiz ve OpenRouter ile aynı modeli veya altyapıyı sunmayız. Üçüncü taraf hız sınırlamaları olmadan doğrudan erişim için istemci kodunu kullanabilir ve base URL'yi bizim hizmetimize yönlendirebilirsiniz.
Bir 402 hatası alırsam ne olur?
402 hatası, hesabınızın isteği işlemek için yetersiz bakiyeye sahip olduğunu gösterir. Bakiyenizi TRC20 üzerinde USDT veya Base üzerinde USDC kullanarak yükleyebilirsiniz; tutarlar $20 ile $500 arasında değişir. Daha büyük yüklemeler için bonus bakiye eklenir ve bakiyeniz süresi dolmaz. 401 (geçersiz anahtar) gibi hatalar API anahtarınızı kontrol etmenizi gerektirirken, 429 (hız sınırı) dakikada 300 istek limitini aştığınızı belirtir.
Bu API'yi fonksiyon çağrısı ve JSON modu için kullanabilir miyim?
Evet, API, response_format parametresi aracılığıyla işlev çağırma ve JSON modu destekler. İsteğinizde araçları tanımlayabilir ve yapılandırılmış JSON yanıtları alabilirsiniz. Bu, yapılandırılmış veri veya dinamik araç kullanımı gerektiren uygulamalarla gelişmiş entegrasyon sağlar. Sansürsüz model bu formatları güvenilir şekilde işler ve karmaşık iş akışları için uygundur.
Anahtarınızı şimdi alın
Kaydolun, anahtarı alın, temel URL'yi güncelleyin. İşin özü budur.