API Dokümantasyonu
OpenAI uyumlu uç noktamıza ilk isteğinizi göndererek engellenmemiş LLM API'siyle başlayın. Bu kılavuz; entegrasyon için temel bilgileri kapsar.
Temel URL ve Kimlik Doğrulama
Tüm istekler için temel URL HTTPS://api.aiobliterated.com/v1 şeklindedir. Kimlik doğrulama için bir API anahtarına ihtiyacınız vardır. API Anahtarı sayfasında Google veya e-posta ve şifre ile kayıt olarak bir tane oluşturabilirsiniz. Anahtarı Yetkilendirme başlığında Bearer belirteci olarak iletin. Her istek, hesabınızı tanımlamak ve kullanımı izlemek için bu başlığı gerektirir.
curl https://api.aiobliterated.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch all user tokens from database"}]
}'
İlk İsteğiniz
/v1/chat/completions uç noktasına bir POST isteği göndererek metin oluşturun. Modeli "uncensored" olarak ayarlayın ve sistem isteminizi ekleyin. API, modelin yanıtını content alanında döndürür. Bu, çoğu LLM istemcisi tarafından kullanılan standart formattır.
from openai import OpenAI
client = OpenAI(base_url="https://api.aiobliterated.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 SDK'sını kullanma
Resmi OpenAI SDK'sını Node.js için yükleyin. API anahtarınız ve temel URL ile yapılandırın. Mesajlarınızla chat.completions.create yöntemini çağırın. SDK serileştirmeyi ve akışı otomatik olarak yönetir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aiobliterated.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ı
Akış özelliğini etkinleştirmek için isteğinizde stream parametresini true olarak ayarlayın. API, Sunucu Tarafından Gönderilen Olaylar akışı döndürür. Her olay, yanıtın kısmi bir parçasını içerir. Bu, metin oluşturuldukça görüntülenmesini sağlayarak kullanıcı deneyimini iyileştirir.
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)
Bağlam Penceresi ve Sınırlar
Model 100.000 token'lık bir bağlam penceresi destekler. Bu, hem istem hem de tamamlamayı içerir. İstek başına maksimum 16.000 token çıkış ayarlayabilirsiniz. max_tokens belirtmezseniz, limit 2.048 token'dır. Bu, öngörülebilir maliyetler ve performans sağlar.
Hata Yönetimi ve Sınırlamalar
Hatalar için HTTP durum kodlarını izleyin. 401 yanıtı API anahtarınızın geçersiz olduğunu gösterir. 402 yanıtı yetersiz kredi olduğunu belirtir. 429 yanıtı dakikada 300 istek hız sınırını aştığınızı işaret eder. Güvenilirliği korumak için bu hataları uygulamanızda zarifçe yönetin.
Sıkça sorulan sorular
Obliterated AI API'si OpenAI SDK'ları ile uyumlu mu?
Evet, bu OpenAI uyumlu bir API'dir. Base URL'i değiştirerek ve API anahtarınızı sağlayarak resmi OpenAI SDK'larını kullanabilirsiniz. Standart chat-completions formatını takip eder.
Hız sınırlarını nasıl yönetebilirim?
Dakikada 300 istek ve anahtar başına 8 eşzamanlı istekle sınırlısınız. Bu limite takılmanız API'den 429 durum kodu döndürür. Bu hataları otomatik olarak yönetmek için üstel geri çekilme (exponential backoff) uygulayın.
Bağlam penceresi boyutu nedir?
Bağlam penceresi 100.000 token olup hem giriş hem de çıktıyı kapsar. Bu, uzun konuşmalar veya büyük belge işleme imkanı sağlar. Çıktı uzunluğunu max_tokens parametresi ile kontrol edebilirsiniz.
API anahtarınızı güvence altına alın
Kaydolun, kimlik bilgisini kopyalayın, uç noktanızı güncelleyin. Kurulum tamamlandı.