TR ▾
API anahtarı al

Uncensored Endpoint: Base URL, Model Kimliği ve Limitler

Buradaki uncensored uç nokta, yasal yetişkin kullanımı için içerik reddetmeleri olmadan yanıt veren host edilmiş bir OpenAI-uyumlu metin API'sidir. Bu sayfa, kod yazmadan önce ihtiyaç duyacağınız base URL, model kimliği, yöntemler, limitler ve hata kodlarını listeler.

güncellendi

Temel noktalar

  1. Temel URL https://api.uncensoredendpoint.com/v1'dir ve tek model ID'si uncensored'dır.
  2. İki yöntem mevcuttur: POST /v1/chat/completions ve GET /v1/models.
  3. Bağlam penceresi 100.000 token olup, istem ve tamamlama birlikte.
  4. Tam bir anahtar 8 eşzamanlı istek ve dakika başına 300 istek izni verir.
Bir dizüstü bilgisayarı bir API sunucusuna bağlayan veri borusunun izometrik illüstrasyonu

Bağlantı ayarları bir bakışta

Değerlere ihtiyacınız varsa, işte burada. Bu sayfadaki diğer her şey, bunların pratikte nasıl davrandığını açıklar.

AyarDeğer
Temel URLhttps://api.uncensoredendpoint.com/v1
Model kimliğiuncensored
Kimlik doğrulama başlığıAuthorization: Bearer YOUR_KEY
Uç noktalarPOST /v1/chat/completions, GET /v1/models
Bağlam penceresi100.000 token, istem ve tamamlama toplamı
Maksimum istek gövdesi8 MB
Tam anahtar limitleri8 eşzamanlı istek, dakika başına 300 istek
Deneme anahtarı limitleri2 eşzamanlı istek, dakika başına 60 istek
Fiyat1M girdi token başı $0.15, 1M çıktı token başı $0.50

Servis, OpenAI sohbet tamamlama API'si ile aynı iletim formatını kullanır. Size özel bir base URL ve bir API anahtarı girmenize izin veren bir araç varsa, bu servise bağlanabilir. API anahtarı sayfasından bir anahtar alırsınız ve dokümantasyon daha kısa bir formatta aynı referansı taşır.

Her yöntemin ne yaptığı

Yalnızca iki rota vardır, bu da API yüzeyini küçük tutar.

  • GET /v1/models model listesini döndürür. uncensored adında bir girdi göreceksiniz. İstemcilerin çoğu bu rotayı bir model açılır menüsünü doldurmak için kullanır, bu nedenle anahtarınızın ve URL'nizin doğru olduğunu doğrulamanın da hızlı bir yoludur.
  • POST /v1/chat/completions asıl işi yapan yöntemdir. Bir mesaj listesi alır ve bir tamamlama döndürür; bu ya tek bir JSON yanıtı olarak ya da bir server-sent event akışı olarak olur.

Eski metin tamamlama rotası, yanıtlar rotası, embedding rotaları, resim rotaları ve ses rotaları ürünün bir parçası değildir. Bir kütüphane bunlardan birini denerse bir hata bekleyin ve kütüphaneyi chat moduna geçirin.

Bir terminalden hızlı bir kontrol:

curl https://api.uncensoredendpoint.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

uncensored içeren bir JSON listesi anahtarın çalıştığını gösterir. HTTP 401, anahtarın eksik, yanlış yazılmış veya içinde istenmeyen bir boşluk veya yeni satır bulunduğunu gösterir; bu, anahtar bir shell değişkeninden geldiğinde en yaygın nedendir.

İlk istek: curl, Python ve Node ile

Üç örnek de aynı şeyi gönderir: bir sistem mesajı, bir kullanıcı mesajı, düşük bir sıcaklık. YOUR_KEY değerini değiştirin veya API_KEY ortam değişkenini ayarlayın.

curl https://api.uncensoredendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain what a context window is in two sentences."}
    ],
    "temperature": 0.7
  }'

Resmi Python SDK ile, istemciye yalnızca iki ek argüman geçirmeniz yeterlidir:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredendpoint.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "Explain what a context window is in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Ve aynı SDK ile Node'da:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredendpoint.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are a concise assistant." },
    { role: "user", content: "Explain what a context window is in two sentences." },
  ],
});
console.log(resp.choices[0].message.content);

Yanıt, istem ve tamamlama token sayılarını içeren bir usage nesnesi içerir. Buna dikkat edin: bu iki sayı, faturalandırma yaptığınız şeydir. Yanıt başlıkları ayrıca X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency taşır. Bir şeyler yanlış görünürse destek tarafından sorulan ilk şey bu olduğu için her çağrıda istek kimliğini günlüğe kaydedin.

Akış, araç çağırma ve JSON modu

Üç özellik çoğu gerçek uygulamayı kapsar ve hepsi zaten bildiğiniz OpenAI yapılarını izler.

Akış

stream: true ayarlayın ve server-sent event'leri okuyun. Kullanım, akışın sonunda raporlanır, böylece ikinci bir istek olmadan token saymaya devam edebilirsiniz. Kapasite planlaması için önemli bir ayrıntı: bir akışlı istek, akış bitene kadar eşzamanlılık slotunu tutar. Bir cevabı damla damla okuyan yavaş bir istemci, slotu tüm süre boyunca meşgul tutar.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Araç çağırma

tools ve isteğe bağlı olarak tool_choice geçirin. Model bir fonksiyon çağırmaya karar verdiğinde, yanıtta tool_calls alırsınız (akış yapıyorsanız akışlı olarak da). Fonksiyonu kendiniz çalıştırın ve sonucu role: "tool" ile bir mesaj olarak geri gönderin. Model tek bir açık ağırlıklı modeldir, bu nedenle araç şemalarınızı birkaç gerçekçi istemle test edin ve parametre açıklamalarını kısa ve kelimesi kelimesine tutun.

JSON modu

Geçerli JSON çıktısı istemek için response_format: {"type":"json_object"} gönderin. İsteğinizde JSON istediğinizi ve beklediğiniz alanları açıkça belirtin. Yine de savunmacı ayrıştırma yapın ve çıktıya körü körüne güvenmek yerine bir ayrıştırma hatasında bir kez yeniden deneyin.

Örneklem kontrolleri geçirilir: temperature, top_p, stop, seed ve sıklık ile varlık cezaları.

100.000-token penceresi pratikte

Bağlam penceresi 100.000 token'dır ve bu sayı hem istemi hem de tamamlamayı kapsar. Tamamlama, istemin serbest bıraktığı her şeyi kullanabilir ve max_tokens isteğe bağlıdır. 90.000 token istem gönderirseniz, cevaba en fazla yaklaşık 10.000 token kalır.

İngilizce metin için kabaca bir kural, bir tokenın bir kelimeden biraz daha az olduğu yönündedir, bu nedenle 100.000 token yaklaşık 70.000 kelimeye denk gelir. Bu, uzun bir el yazması bölümü seti, bir kod tabanının büyük bir kısmı veya birkaç saatlik sohbet geçmişi için yeterlidir. Bunu yararlı kılan üç alışkanlık:

  • Geçmişi kasıtlı olarak kısaltın. Sohbet istemcileri her adımda tüm konuşmayı yeniden gönderir, bu nedenle maliyet ve gecikme bununla birlikte artar. Sistem istemini, eski adımların bir özetini ve son birkaç mesajı koruyun.
  • Çıktı boyutu önemliyse max_tokens ayarlayın. İsteğe bağlıdır, ancak uzun bir istemde kontrolsüz bir cevaptan sizi korur.
  • 8 MB gövde limitine dikkat edin. Bu, token penceresinden bağımsızdır. Düz metin nadiren 8 MB'a ulaşır, ancak bir isteme yapıştırılan base64 blobları ulaşabilir.

Faturalandırma token başına yapıldığı için, tam pencere bir istek, kısa bir isteye kıyasla gerçek para maliyetine sahiptir. fiyatlandırma sayfası oranları içerir ve her isteği giriş token sayısı çarpı $0.15 artı çıkış token sayısı çarpı $0.50 olarak hesaplayabilirsiniz; her ikisi de bir milyona bölünür.

Hız limitleri ve 429 ailesi

Tam bir anahtar aynı anda 8 istek ve dakika başına 300 istek izni verir. Deneme anahtarı daha sıkıdır: aynı anda 2 ve dakika başına 60. Bir sınırı aştığınızda API HTTP 429 ile yanıt verir ve hata kodu hangi sınırı aştığınızı söyler:

Hata koduAnlamıNe yapılmalı
rate_limitedDakika başına çok fazla istekYavaşlayın; çağrıları dakika boyunca dağıtın
concurrencyAynı anda çok fazla istek çalışıyorKendi tarafınızda kuyruk oluşturun; paralel worker'ları 8'e (deneme sürümünde 2) kadar sınırlandırın
429 ile Retry-After: 5Geçici aşırı yükleme5 saniye bekleyin, ardından yeniden deneyin

En basit savunma, kendi kodunuzda anahtarınıza boyutlandırılmış bir semafor kullanmaktır. Python ile asyncio'da, her çağrının etrafına asyncio.Semaphore(8) eklemek concurrency hatasını tamamen ortadan kaldırır. Retry-After başlığını onurlandıran ve başlık yoksa kısa bir üstel gecikmeye düşen bir yeniden deneme ekleyin. Akışların tam uzunlukları boyunca bir slot tuttuğunu unutmayın, bu nedenle sekiz uzun akışın bir topluluğu, dakika başına sayı düşük olsa bile dokuzuncu bir isteği bloke edecektir.

Başarısız veya reddedilen istekler faturalandırılmaz, bu nedenle bir yeniden deneme döngüsü, başarısız olan denemeler için size maliyet çıkarmaz.

Model nedir ve ne değildir

Servis, bağımsız bir sağlayıcı tarafından barındırılan ve yasal yetişkin kullanımı için içerik reddetmeleri olmadan yanıtlamak üzere ayarlanmış tek bir açık ağırlıklı model üzerinde çalışır. Büyük bir satıcının resmi API'si değildir ve satıcılar arasında seçim yapan bir yönlendirici değildir. Tek bir model, uncensored vardır, bu nedenle seçilecek bir şey yoktur ve karşılaştırılacak bir fiyatlandırma katmanı yoktur.

Limitler açıktır. Metin girer ve metin çıkar. Resim, ses veya video üretimi, embedding ve ince ayar yoktur. Tek sabit içerik kuralı, reşit olmayanlar ile ilgili cinsel içeriğin asla izin verilmemesidir. İstemler eğitim için kullanılmaz.

Bu çerçeve, bir proje planlarken yardımcı olur. Yetişkinler için kurgu ve rol yapma araçları, arkadaş uygulamaları, model davranışı üzerine araştırma ve modelin geri çekilmeden kaba veya hassas metinleri işleyen araçlar doğal uyumluluk alanlarıdır. Arama için gömme (embedding) değerlerine ihtiyacınız varsa, bu kısım için ayrı bir sağlayıcıya ihtiyacınız olacaktır ve yine de üretim için bu uç nokta kullanabilirsiniz.

Üretime geçmeden önce

Çalışan bir demo beş dakikalık iş gerektirir. Güvenilir bir hizmet ise biraz daha fazla zaman alır. Deneme sürümünü deneyin: yeni kullanıcılar, kayıt olduktan sonra anahtar sayfasında tek tıkla kişi başı bir kez olmak üzere 7 gün geçerli ve ödeme gerektirmeyen $0,50 kredi alabilir. Kayıt işlemi Google veya e-posta ve şifre ile yapılır. Entegrasyonunuzu kontrol etmek için yüzlerce kısa test çağrısı için bu yeterlidir.

Gerçek trafiğe geçtiğinizde, $20 ile $500 arasında herhangi bir tam tutarı bakiye yükleyin. Ödeme kripto (TRC20 üzerinde USDT, Base üzerinde USDC) ile yapılır. Kredi asla sona ermez ve abonelik yoktur, bu nedenle bakiye harcamayıncaya kadar oturur. Bonus $50'den %5, $100'den %10 ve $200'den %15'tir.

Sonra kısa bir listeyi işleyin: anahtarı bir ortam değişkeninde veya bir gizli değerler yöneticisinde saklayın, istemci tarafı kodunda değil; X-Request-Id'i günlüğe kaydedin; X-Balance-USD'i izleyin ki bakiye bitmeden uyarı verebilesiniz; paralel işçileri sınırlandırın; ve 429'ı sıkı bir döngü yerine gecikme ile işleyin. API anahtarları için üretim kontrol listesi anahtar işlemini daha ayrıntılı olarak inceler ve dokümantasyon parametre referansını içerir.

Sorular ve cevaplar

Özel bir SDK'ya ihtiyacım var mı?

Hayır. Herhangi bir OpenAI SDK veya istemcisi çalışır. Base URL'yi ve anahtarı değiştirin, modeli uncensored olarak ayarlayın ve kodunuzun geri kalanı aynı kalır.

Görsel veya embedding üretebilir mi?

Hayır. API yalnızca metin içindir. Görüntü, ses veya video oluşturma, gömme (embeddings) ve ince ayar (fine-tuning) yoktur.

Hız limitine (rate limit) ulaştığımda ne olur?

HTTP 429 alırsınız. Dakika başına istek sayısını aştığınızda hata kodu rate_limited, çok fazla istek aynı anda çalıştığında concurrency olur. Bir süre bekleyip yeniden deneyin.

Sert bir içerik kuralı var mı?

Evet. Reşit olmayanları içeren cinsel içerik asla kabul edilmez. Model, yasal yetişkin kullanımı için geri kalan her şeyi reddetmeden yanıtlamak üzere ayarlanmıştır.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve base URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı alDokümantasyonu oku