TR ▾
Base URL https://api.uncensoredaiapis.com/v1Model uncensored
API anahtarı al
Uncensored AIGeçiş Kılavuzu

OpenAI veya OpenRouter'dan sansürsüz bir AI API'sine geçiş yapın

Base URL'yi, API anahtarını ve model kimliğini küçük bir test istemcisinde değiştirerek bir geçişi başlatın. Üretim trafiğini değiştirmeden önce kendi kayıtlı promptlarınızın bir setini çalıştırın: uyumlu bir istek formatı, aynı yanıtlar anlamına gelmez. Bu kılavuz yapılandırmayı, akışı, araç çağrılarını ve LangChain veya LlamaIndex'de tekrarlanması gereken kontrolleri kapsar.

OpenAI veya OpenRouter'dan sansürsüz bir AI API'sine geçiş yapın

güncellendi

Temel noktalar

  • Sadece üç değeri değiştirin: base URL'yi https://api.uncensoredaiapis.com/v1, olarak ayarlayın, yeni anahtarınızı girin ve modeli "sansürsüz" olarak belirleyin.
  • Sohbet tamamlamaları, akış ve fonksiyon çağırma OpenAI formatında çalışır; embedding, görüntü, ses ve ince ayar mevcut değildir.
  • Base URL, anahtar ve modeli ortam değişkenlerine yerleştirin böylece eski ve yeni arka uçlar yan yana çalışır ve geri alma bir dosya takası ile yapılır.
  • max_tokens değerini açıkça belirleyin ve geçiş yapmadan önce 100.000 token'lık bağlam penceresini planlayın.

Geçiş yaptığınızda ne değişir

Uygulamanız zaten OpenAI veya OpenRouter sohbet tamamlamaları API'si ile iletişim kuruyorsa, bu sansürsüz AI API'sine geçiş bir yeniden yazma değil bir yapılandırma değişikliğidir. Üç değer değişir ve istek kodunuzdaki diğer her şey olduğu gibi kalır: base URL, API anahtarı ve model adı.

AyarÖnceSonra
Temel URLOpenAI veya OpenRouter URL'sihttps://api.uncensoredaiapis.com/v1
Kimlik doğrulamaMevcut hizmetinizden API anahtarıHesabınızdan buradan aldığınız anahtarı, Authorization: Bearer <key> şeklinde gönderin.
ModelGPT veya yönlendirilmiş model adı gibi bir model kimliğiuncensored
Uç Nokta/chat/completionsAynı: POST /v1/chat/completions

Tam olarak bir model vardır, bu nedenle seçim yapabileceğiniz bir model kataloğu yoktur. GET /v1/models uç noktası mevcuttur ve modeli listeler; bu da onu çağıran SDK yardımcı programlarının ve sağlık kontrollerinin çalışmasını sağlar. Mesajlar, akış ve fonksiyon çağırma zaten gönderdiğiniz aynı OpenAI formatlarını kullanır. Bu sayfa bir uygulama rehberidir; OpenRouter ile maliyet, gecikme süresi ve gizlilik karşılaştırmasını öğrenmek istiyorsanız, bunun yerine OpenRouter sansürsüz modeller makalesini okuyun.

İşte minimal Python farkı. Aramada başka hiçbir şey değişmez.

import os
from openai import OpenAI

# before
# client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
# model = "gpt-4o"

# after
client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)
model = "uncensored"

resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)
print(resp.choices[0].message.content)

OpenRouter kullanıcıları için de aynı durum geçerlidir: OpenRouter base URL'sini ve anahtarını değiştirin, üstbilgiler veya istek gövdesi aracılığıyla ilettiğiniz yönlendirmeye özgü ek öğeleri kaldırın (aşağıdaki uyumluluk tablosuna bakın).

Parametre ve özellik uyumluluğu

Bir sohbet uygulaması için önemli olan arayüz kapsanmıştır. Tablo, desteklenen olarak belgelenenleri, buna güvenmeden önce bir test isteği ile onaylamanız gerekenleri ve hiç bulunmayanları ayırır. Şüphe durumunda, başka bir hizmetle eşdeğerlik varsaymak yerine isteği bir hazırlık ortamında gönderin ve yanıtı karşılaştırın.

ÖğeKodNotlar
modelDestekleniyoruncensored kullanın. Sadece bir model vardır.
messages (sistem, kullanıcı, asistan, araç rolleri)DestekleniyorStandart OpenAI mesaj formatı. Bağlam penceresi, istem ve tamamlama için 100.000 token'dır.
max_tokensDestekleniyor100,000 tokenlık pencerenin sonuna kadar.
stream: trueDestekleniyorSunucu Tarafından Gönderilen Olaylar (SSE). Son kullanım verisi otomatik olarak eklenir.
tools, tool_choice, role tool mesajlarıDestekleniyorOpenAI fonksiyon çağırma formatı.
Örneklem ve durdurma seçenekleri (temperature, top_p, stop ve benzerleri)DestekleniyorStandart OpenAI alanları, gönderildiği gibi iletilir. Geçiş yaptıktan sonra temperature değerini yeniden ince ayarlayın: aynı değer yeni bir modelde farklı hissedilebilir.
Yönlendirme ekleri: yedek model listeleri, yönlendirme tercihleri, app-attribution üstbilgileriMevcut değilBir model vardır, bu nedenle yönlendirilecek bir şey yoktur. Bunları isteklerden ve yapılandırmadan kaldırın.
GömmeMevcut değilRAG boru hatları için ayrı bir embedding kaynağı tutun.
Görsel oluşturma, görüş, ses, videoMevcut değilAPI yalnızca metin içindir.
İnce ayarMevcut değilİnce ayar uç noktaları yok. Davranışı sistem istemleriyle şekillendirin.

Pratik sonuç, getirme için yerelleştirmeler kullanan bir boru hattının iki istemciye ihtiyaç duymasıdır: biri mevcut yerelleştirme hizmeti için, diğeri burada üretim için. Bu normal bir bölünmedir ve bir sonraki bölümdeki ortam değişkeni yaklaşımı bunu düzenli tutar.

Ortam değişkenleriyle yan yana çalıştırma

En güvenli geçiş, her iki arka ucu da canlı tutar ve çalışma zamanında birini seçer. Farklı olan üç değeri ortam değişkenlerine yerleştirin ve bunları tek bir yerden okuyun. Ardından, istek kodunuzu dallandırmadan bir geliştirme ortamını, trafiğin bir yüzdesini veya tek bir özelliği yeni API'ye yönlendirebilirsiniz.

# .env.openai
LLM_BASE_URL=your-current-base-url
LLM_API_KEY=paste-your-existing-key
LLM_MODEL=gpt-4o

# .env.uncensored
LLM_BASE_URL=https://api.uncensoredaiapis.com/v1
LLM_API_KEY=paste-your-key-here
LLM_MODEL=uncensored

Daha sonra tek bir fabrika istemciyi oluşturur:

import os
from openai import OpenAI

def make_client() -> tuple[OpenAI, str]:
    client = OpenAI(
        base_url=os.environ["LLM_BASE_URL"],
        api_key=os.environ["LLM_API_KEY"],
    )
    return client, os.environ["LLM_MODEL"]

client, model = make_client()
resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(model, "->", resp.choices[0].message.content)

Node.js ile aynı desen:

import OpenAI from "openai";

export function makeClient() {
  const client = new OpenAI({
    baseURL: process.env.LLM_BASE_URL,
    apiKey: process.env.LLM_API_KEY,
  });
  return { client, model: process.env.LLM_MODEL };
}

const { client, model } = makeClient();
const resp = await client.chat.completions.create({
  model,
  messages: [{ role: "user", content: "Reply with the single word: ready" }],
  max_tokens: 10,
});
console.log(model, "->", resp.choices[0].message.content);

Davranışı karşılaştırmak için aynı istem kümesini her iki yapılandırmaya da çalıştırın, örneğin test komutunuzdan önce set -a; source .env.uncensored; set +a komutunu kullanın. Değişken adları genel olduğu için eski arka ucu sonlandırdığınızda kod değişikliğine gerek kalmaz ve geri alma işlemi bir dosya değişimi ile yapılır.

LangChain, LlamaIndex ve diğer OpenAI uyumlu istemciler

OpenAI temel URL'sini geçersiz kılmaya olanak tanıyan herhangi bir çerçeve bu API ile çalışır, çünkü HTTP sözleşmesi aynıdır. Temel URL'yi, anahtarı ve model adını iletirsiniz; çerçeve geri kalanını halleder. LangChain için, langchain_openai paketi ChatOpenAI sınıfını sunar:

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    max_tokens=500,
)

print(llm.invoke("Give me a one-line pitch for a noir detective game.").content)

LlamaIndex için, sohbet tamamlama formatını uygulayan ancak OpenAI'nin kendisi olmayan sunucular için tasarlanmış olan llama-index-llms-openai-like paketinden OpenAI uyumlu LLM sınıfını kullanın:

import os
from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(
    api_base="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    is_chat_model=True,
)

print(llm.complete("Give me a one-line pitch for a noir detective game."))

Çerçeve kurulumlarında akılda tutulması gereken iki şey vardır. Birincisi, gömme modeli çağıran getirme özellikleri, bu API'de gömme modeli olmadığı için farklı bir gömme kaynağına ihtiyaç duyacaktır. İkincisi, çerçeveler bazılarında bağlam boyutu veya fonksiyon desteğine karar vermek için iç bir listeden model adı varsayabilir; bilinmeyen bir model hakkında bir uyarı görürseniz, bu kozmetiktir, ancak çerçevenizin varsayıdığı bağlam penceresinin 100.000 tokenı aşmadığından emin olun. Kütüphaneler arasında parametre adları biraz farklılık gösterir (base_url, api_base, baseURL), bu nedenle kütüphanenizin kullandığına bakın. Özel bir OpenAI temel URL'si kabul eden diğer araçlar, editör eklentileri ve sohbet ön uçları gibi, aynı üç değer desenini izler.

Geçiş yapmadan önce test kontrol listesi

Bu listeyi hazırlık ortamında çalıştırın. Her madde hızlıdır ve birlikte çoğu geçiş sürprizini yakalar.

  1. Kimlik doğrulama ve yönlendirme. Anahtarınızla GET /v1/models uç noktasını çağırın. 401 hatası, anahtarın veya başlığın yanlış olduğunu gösterir; 404 hatası, yolun yanlış olduğunu gösterir.
  2. Temel tamamlama. max_tokens ayarlanmış tek satırlık bir istem gönderin ve choices[0].message.content ile usagenün mevcut olduğunu doğrulayın.
  3. Akış. Gerçek UI yolunuzu stream: true ile çalıştırın. Ayrıştırıcının, boş choices listesi içeren son kullanım parçasını tolere ettiğinden emin olun.
  4. Fonksiyon çağırma. Tam bir döngü çalıştırın: istek, tool_calls, role tool yanıtı, nihai cevap. Kodunuzun fonksiyon çağırma içermeyen yanıtları işleyip işlemediğini kontrol edin.
  5. Uzun istemler. Gerçek maksimumunuza yakın bir istem gönderin. İstem ve max_tokens toplamı 100.000'i aşarsa yanıt pencerenin sonunda durur; 400 yalnızca istemin kendisi pencereye sığmadığında döner.
  6. Hata işleme. Yanlış anahtarı (401) simüle edin. Uygulamanızın JSON error.code değerini okuyup 402 no_credit, 403 content_blocked, 429 ve 503 upstream_busy hatalarını mantıklı şekilde işleyip işlemediğini doğrulayın.
  7. Çıktı kalitesi ve tonu. Gerçek istemlerin bir örneğini tekrar oynatın ve yanıtları mevcut modelinizle karşılaştırın. Başka bir modelin reddedilen yanıtları veya temkinli ifadeleri etrafında ayarlanmış istemler basitleştirilmeyi gerektirebilir.
  8. Maliyet takibi. usage verisini günlüğe kaydedin. Giriş her milyon token için 0,15$ ve çıkış her milyon token için 0,50$ olduğundan, mevcut token sayılarınızdan elde ettiğiniz tahminleri yeniden hesaplamak kolaydır.

Akış, fonksiyon ve yeniden deneme adımlarının çalıştırılabilir sürümleri için kod örnekleri sayfasına bakın.

Yaygın tuzaklar

Eski model adının yerinde bırakılması. En sık görülen hata, hala başka bir model kimliği içerdiğini söyleyen bir istektir. Modeli ortam değişkeni örneğinde olduğu gibi yapılandırmadan okuyun, böylece base URL ile birlikte hareket eder.

Eski anahtarın gönderilmesi. Başka bir hizmetten gelen bir anahtar 401 hatası döndürür. Buradaki anahtarlar bir hesaba bağlıdır, hesap başına bir tane vardır ve birini yeniden oluşturmak önceki anahtarı hemen geçersiz kılar; bu nedenle yeniden oluşturduktan sonra her dağıtımı güncelleyin.

Base URL'de /v1 eksik. Base URL /v1 ile bitmelidir. SDK'lar /chat/completions sonekini kendileri ekler; sonek içermeyen bir base URL 404 hatalarına neden olur.

Yok olan bir özelliğe güvenmek. Yerelleştirmeler, görüntüler, ses ve ince ayar çağrıları başarısız olacaktır. Geçiş yapmadan önce kod tabanınızı bunlar için denetleyin, geçiş yaptıktan sonra değil.

Çıktı sınırını görmezden gelmek. max_tokens ayarlamazsanız, yanıt pencerenin sonuna kadar uzayabilir. Başka bir hizmet varsayılan olarak daha uzun yanıtlar veriyorsa, küçük bir sınırın yanıtların finish_reason: length ile erken sonlanmasına neden olabileceğinden, değeri açıkça ayarlayın.

Bağlam taşması. Mevcut modelinizin daha büyük bir penceresi varsa, uzun geçmişler istem artı tamamlama için 100.000 tokenı aşabilir ve 400 hatası döndürebilir. Geçiş yapmadan önce kısaltma veya özetleme ekleyin.

Her şeyi yeniden denemek. Sadece 429 ve 503 hatalarını yeniden deneyin. 402, bakiyenin dolduğunu veya denemenin süresinin dolduğunu gösterir; yeniden denemek işe yaramaz. fiyatlandırma sayfasında açıklandığı gibi bakiye yükleyerek devam edin.

İçerik kuralları. Yasal yetişkin içeriği ve kurgu reddedilmez, ancak çocukların cinsel içeriği içeren içerikler her zaman 403 hatası ile engellenir; bu kurgu ve rol yapma dahil olmak üzere geçerlidir. Hizmet yetişkinler ve yasal kullanım içindir; bu nedenle ürününüzün ilgili yerlerde yaş sınırlaması uyguladığından emin olun.

Sorular ve cevaplar

OpenAI'dan geçiş yapmak için kodumu yeniden yazmam gerekiyor mu?

Genellikle hayır. İstemci yapılandırmanızda base_url, api_key ve model adını sansürsüz olarak değiştirin. Mesaj formatı, akış ve araç çağırma aynı OpenAI formatını izler.

Bu API ile birlikte OpenRouter kullanmaya devam edebilir miyim?

Evet. Base URL'i, anahtarı ve modeli ortam değişkenlerinden okuyun ve her ortamı veya özelliği istediğiniz arka uca yönlendirin. Kademeli bir geçiş sırasında ikisi paralel olarak çalışabilir.

Yerelleştirmelerim veya görüntü çağrılarım ne olur?

Burada çalışmazlar. API sadece metin içindir, gömme, görüntü, ses, video veya ince ayar yoktur, bu nedenle bunlar için ayrı bir kaynak tutun.

LangChain bu sansürsüz AI API'si ile çalışır mı?

Evet. langchain_openai kütüphanesinden ChatOpenAI'ı kullanın; base_url'yi https://api.uncensoredaiapis.com/v1, olarak ayarlayın, anahtarınızı girin ve model="uncensored" olarak belirleyin. Özel bir OpenAI base URL'si kabul eden her istemci aynı deseni izler.

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.