API Dokümantasyonu

Hızlı Başlangıç: İlk İsteğinizi Bağlayın

Anahtarınızı dashboard'da oluşturun. Tüm istekler için temel URL HTTPS://api.filterno.cc/v1'dir. Anahtarınızı Authorization başlığında bir bearer token olarak iletin. Bu kurulum herhangi bir standart OpenAI-uyumlu istemci ile çalışır.

Basit bir tamamlama isteği ile bağlantıyı hemen test edin. Uç nokta standart sohbet formatlarını kabul eder ve içerik filtreleri olmadan ham metin döndürür.

YOUR_API_KEY'i hesabınıza verilen dizeyle değiştirin. İstek gövdesi modeli ve mesaj içeriğini tanımlar. Oluşturulan metni içeren bir yanıt alırsınız.

Uç nokta: POST /v1/chat/completions

Prompt'larınızı POST /v1/chat/completions'a gönderin. Bu, desteklediğimiz tek chat uç noktasıdır. Bir sistem talimatı ve dizi formatında kullanıcı mesajları sağlarsınız.

Model tanımlayıcısı "uncensored"dir. Metin girdisini işler ve metin çıktısı döndürür. Burada görsel veya ses üretimi beklemeyin.

Rastgeleliği kontrol etmek için sıcaklığı ayarlayın. Daha yüksek değerler daha yaratıcı çıktılar üretir. Daha düşük değerler belirleyici sonuçlar verir. API, bu uç nokta için şemasını sıkı bir şekilde takip eder.

Uç nokta: GET /v1/models

Kullanılabilir modelleri /v1/models uç noktasına GET isteği göndererek doğrulayın. Bu uç nokta desteklenen model kimliklerinin bir listesini döndürür. Yanıtta "uncensored" ifadesini görmelisiniz.

Bu uç nokta API anahtarınızın geçerli olduğunu doğrular. Ayrıca model detaylarını gösterir. Bağlantı sorunlarını halletmek için kullanın.

Yanıt, model kimliğini ve nesne türünü içerir. Fiyatlandırmayı veya limitleri listelemez. Token oranları için belgelere bakın.

Parametreler: Sıcaklık, Top-P ve Araçlar

Yaratıcılığı temperature ve top_p ile kontrol edin. Sıcaklık olasılık dağılımını ayarlar. Top_p düşük olasılıklı belirteçleri filtreler. Birlikte yaratıcılık ve odaklanma arasında denge kurarlar.

Yapılandırılmış etkileşimler için fonksiyon çağrısı kullanın. Araçları istek gövdesinde tanımlayın. Model bu işlevleri çağırabilir. Belirli davranışı zorlamak için tool_choice'u geçirin.

Üretimi erken sonlandırmak için stop dizilerini ayarlayın. Tekrarlanabilir sonuçlar için seed kullanın. Presence ve frequency cezaları tekrarları azaltır. Bu parametreler standart OpenAI kurallarını takip eder.

Akış Yanıtları (SSE) & Token Kullanımı

Akış özelliğini etkinleştirmek için stream parametresini true olarak ayarlayın. API Sunucu Tarafından Gönderilen Olaylar (SSE) döndürür. Her parça kısmi jeton verileri içerir.

Token kullanımı son chunk'ta görünür. Maliyetleri takip etmek için okuyun. Akış (streaming), uzun yanıtlar için algılanan gecikmeyi azaltır. Gerçek zamanlı uygulamalar için idealdir.

SSE veri yapısını dikkatlice ayrıştırın. Ağ kesintilerini zarifçe yönetin. API, parça sınırları aracılığıyla veri bütünlüğünü sağlar.

Limitler, Hatalar ve Token Aritmetiği

Anahtar başına dakikada 300 istek alırsınız. Eşzamanlılık, eşzamanlı 8 istekle sınırlıdır. Maksimum istek gövdesi boyutu 8 MB'tır.

Bağlam penceresi 100.000 token'dır. Bu, prompt ve tamamlamayı içerir. Maksimum çıktı 16.000 token'dır. Kullanımı sınırlamak için max_tokens ayarlayın.

Durum kodlarını kontrol ederek hataları yönetin. 401 geçersiz anahtar anlamına gelir. 402 kredi yok olduğunu gösterir. 429 hız sınırını işaret eder. 429'lar için üstel geri çekilme ile yeniden deneyin.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.filterno.cc/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ış

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)