Sansürsuz API Hızlı Başlangıç Rehberi

Kurulum ve Gerekli Kütüphaneler

Sansursuz API, OpenAI SDK'ları ve istemcileriyle doğrudan uyumlu çalışacak şekilde tasarlanmıştır. Entegrasyon kurulumu için tek yapmanız gereken, mevcut kodunuzdaki base_url değerini https://api.sansursuzapi.com/v1 olarak ayarlamak ve API anahtarınızı yapılandırmaktır. Kullandığınız dil için uygun SDK paketini yüklemeniz yeterlidir; ek bir sunucu yapılandırmasına veya karmaşık kimlik doğrulama mekanizmalarına gerek yoktur. Sistemimiz, standart Bearer token kimlik doğrulamasını kullanır ve anahtarınızı doğrudan istek başlıklarında iletiriz.

Temel İstek Örneği

API'yi kullanmaya başlamak için basit bir POST isteği göndererek metin üretimini tetikleyebilirsiniz. Aşağıdaki örnek, curl aracılığıyla uncensored modeline nasıl erişileceğini gösterir. İstek gövdesinde model adı, kullanıcı mesajı ve yanıt formatı belirtilir. Bu yapı, OpenAI'nin standart chat-completions şemasına uyar.

Kopyalacurl https://api.sansursuzapi.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 istek, modelin sansürsüz davranışını test etmek için ideal bir başlangıç noktasıdır. Yanıt olarak dönen JSON nesnesi, üretilen metni ve token istatistiklerini içerir. Hızlı testler için bu basit yapıyı kullanabilir, ardından projenizin ihtiyaçlarına göre parametreleri özelleştirebilirsiniz.

Stream ve Fonksiyon Çağırma

Büyük metin blokları veya uzun konuşma geçmişi senaryoları için akış (streaming) modunu kullanabilirsiniz. Bu mod, sunucudan gelen veriyi parça parça işlemenizi sağlar ve kullanıcı deneyimini iyileştirir. Ayrıca, modelin dış araçlarla etkileşime girmesini sağlayan fonksiyon çağırma (function calling) özelliği de desteklenir. Bu özellik, modelin belirli bir JSON şemasına göre veri döndürmesini ve bu veriyi uygulamanızda işlemesini sağlar.

Kopyalafrom openai import OpenAI

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

Kopyalaimport OpenAI from "openai";

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

Python ve Node.js SDK'ları, bu akış ve fonksiyon yapılarını yönetmek için gerekli araçları sunar. İsteğe bağlı olarak stream: true parametresi ile yanıtı parça parça alabilir veya tools yapısını kullanarak modelin veri üretimini yapılandırabilirsiniz.

Model Listesi ve Uyum

API'miz şu an için tek bir büyük dil modeli sunar: uncensored. Bu model, özel olarak ayarlanmış açık ağırlıklı bir yapıdadır ve standart modellerde görülen yapay filtrelemeleri kaldırmak için optimize edilmiştir. Model listesi endpoint'i (GET /v1/models) üzerinden mevcut modeli doğrulayabilirsiniz. Model, OpenAI'nin GPT, Claude, Gemini veya Grok serilerinden bağımsız olarak, bizim GPU sunucularımızda çalışır. Bu uyumluluk, mevcut OpenAI istemcilerinizi doğrudan kullanabilmenizi sağlar.

Hata Kodları ve Sınırlar

API kullanımı sırasında karşılaşabileceğiniz başlıca durum kodları şunlardır: 401 geçersiz veya eksik API anahtarı, 402 yeterli kredi bulunmaması ve 429 dakika başına 300 istek limitinin aşılması. Her hesap için tek bir API anahtarı geçerlidir; anahtar yenilendiğinde eski anahtar devre dışı kalır. İstek gövdesi 8 MB'ı geçmemelidir. Bağlam penceresi (context window) 64.000 token ile sınırlıdır; bu, hem prompt hem de tamamlama metni için toplam token sayısını ifade eder. Bu sınırlar, API'nin istikrarlı çalışması için kritiktir.

Fiyatlandırma ve Kredi Yönetimi

Sansursuz API, kullandıkça öde (pay-as-you-go) modeliyle çalışır. Giriş tokenları için 1 milyon token başına 0,25 $, çıkış tokenları için 1 milyon token başına 1,00 $ ücretlendirilir. Ödenen kredi süresiz olarak saklanır ve abonelik ücreti yoktur. Yeni hesaplar, kredi kartı gerekmeden 7 gün geçerli 0,50 $ deneme kredisi alır. Kredi bittiğinde hizmet kesilmez, yalnızca yeni istekler için kredi yüklemeniz gerekir. Toplamda +5% bonus 50 $ ve +10% bonus 100 $ yüklemelerde geçerlidir.

Streaming

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)