Narratium özel API kurulumu: base URL, anahtar, model.

Updated 2026-07-29

Narratium, kendi arayüzünü getiren ama kendi modeli olmayan açık kaynaklı bir roleplay ve hikaye anlatımı istemcisidir: README'si kullanıcıları OpenAI formatlı API'lere, OpenRouter tarzı birleşik endpoint'lere ve yerel Ollama'ya yönlendirir. API ayarlarını tek bir anahtarla https://api.apisrouter.com/v1 adresine yönlendirin, böylece tüm katalog onun backend'i haline gelir. Bu sayfanın çoğu rehberin atladığı, açıkça belirttiği bir şey var: GitHub deposu arşivlenmiş durumda, bu yüzden onu bu gerçeği hesaba katarak çalıştırın.

Hızlı yanıt: Narratium'ın ihtiyaç duyduğu değerler.

Narratium'ın LLM bağlantısı, API ayarlarına girilen standart OpenAI uyumlu üçlüdür: bir base URL, bir API anahtarı ve bir model adı. Bu gateway için bunlar https://api.apisrouter.com/v1, sk-... anahtarınız ve herhangi bir katalog id'sidir; hikaye trafiği için makul ilk seçim deepseek-v4-flash'tır. Projenin README'si tam olarak bu bağlantı sınıfını önerir: doğrudan OpenAI formatlı API'ler, çeşitlilik için birleşik çoklu model endpoint'i veya yerel modeller için Ollama ve LM Studio — hepsi aynı yapılandırma yüzeyi üzerinden. Tam alan etiketleri web sürümü ve versiyonlar arasında değişir, bu yüzden etiketlere gevşek, değerlere ise tam olarak yaklaşın: URL /v1'de biter, anahtar temiz yapıştırılır, model id katalog dizesiyle karakter karakter eşleşir.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (from APIsRouter)
Model:     deepseek-v4-flash   (typed exactly; any catalog id works)

Narratium nedir ve durumu açıkça nedir.

Narratium (GitHub'da Narratium/Narratium.ai), kendini roleplay için VSCode olarak tanıttı: SillyTavern karakter kartı uyumluluğu, bellek kalıcılığı ve bir eklenti sistemine sahip, yapay zeka destekli hikaye anlatımı, dünya kurgusu ve uzun biçimli interaktif kurgu için açık kaynaklı bir istemci. Kod AGPL lisanslıdır, hızla gerçek bir topluluk çekmiştir ve sahnedeki daha ilginç açık istemcilerden biri olmaya devam etmektedir. Şimdi çoğu kurulum rehberinin atladığı kısım: GitHub deposu arşivlenmiş ve salt okunur durumda (GitHub arşiv tarihini 30 Mart 2026 olarak gösteriyor). Arşivlenmiş olmak bozuk demek değildir, kod donduğu günkü kadar iyi çalışmaya devam eder, ama hiçbir bakımcının düzeltme, bağımlılık güncellemesi veya güvenlik yaması yayınlamadığı anlamına gelir ve projeyle ilişkili barındırılan örnekler en fazla "elden geldiğince" olarak değerlendirilmelidir. Narratium'ı bugün benimsiyorsanız güvenilir yol onu kaynak koddan veya bir sürümden kendiniz çalıştırmaktır ve gerçekçi beklenti donmuş bir özellik setidir. Bu durum, API tavsiyesini belirli bir şekilde değiştirir: donmuş bir istemci, tam olarak model tarafının esnek kalmasını istediğiniz durumdur. Narratium artık yeni sağlayıcı entegrasyonları ekleyemez, ama zaten konuştuğu OpenAI uyumlu bir endpoint, o endpoint'in arkasında beliren her yeni modeli sunmaya devam eder. Gateway deseni, artık ilerlemeyen bir istemciyi etkin biçimde geleceğe hazırlar.

Kurulum rehberi.

Sorun giderme evrensel deseni izler: önce üç değeri bir curl isteğiyle kanıtlayın; curl başarılı olup uygulama başarısız olursa genellikle suçlu, fazladan bir yol segmenti içeren bir URL, anahtarda boşluk karakteri veya web sürümlerinde geliştirici konsolunda görülebilen bir tarayıcı CORS engelidir. Artık hiçbir bakımcı uygulama tarafındaki tuhaflıklar için düzeltme yayınlamayacağından, önce-curl alışkanlığı burada biraz daha fazla önem taşır: bağlantının hangi tarafında gerçekten bir şey yapabileceğinizi hemen size söyler.

  • Narratium'ı çalıştırın: GitHub kaynağından veya bir sürümden kendi barındırın (depo salt okunur ama tamamen klonlanabilir), ya da güvendiğiniz bir barındırılan örnek hâlâ çalışıyorsa onu kullanın.
  • Ayarları açın ve API / LLM yapılandırma bölümünü bulun.
  • Barındırılan bir endpoint'e yöneldiğiniz için Ollama yerine OpenAI formatlı bağlantı türünü seçin.
  • Base URL olarak https://api.apisrouter.com/v1 girin ve anahtarınızı yapıştırın.
  • Model id'sini tam olarak yazın: başlangıç için deepseek-v4-flash.
  • Kaydedin ve gidiş-dönüşü doğrulamak için yeni bir hikayede kısa bir mesaj gönderin.

Kartlar, dünyalar ve ayrılırsanız neyin hayatta kaldığı.

Narratium, SillyTavern uyumlu karakter kartlarını okur; bu, onunla ilgili tek en önemli uyumluluk gerçeğidir. Karakterleriniz taşınabilir yapılardır: başka yerde yazılmış kartlar içe aktarılır ve persona'lara ve dünya notlarına koyduğunuz emek, geliştirmesi durmuş bir istemciye kilitlenmez. Bir gün göç ederseniz SillyTavern, RisuAI ve Wyvern hepsi aynı kart soyunu konuşur ve aşağıda bağlantısı verilen kurulum sayfaları her birini kapsar. Aynı taşınabilirlik mantığı model tarafı için de geçerlidir. Narratium jenerik bir /v1 endpoint'iyle konuştuğu için sağlayıcı kurulumunuzda Narratium'a özgü hiçbir şey yoktur: aynı anahtar ve base URL değişmeden başka herhangi bir frontend'e bırakılabilir. Taşınabilir kartlar ile taşınabilir bir endpoint arasında, tüm yığının geçiş maliyeti sıfıra yuvarlanır; bu da hâlâ keyifle kullandığınız arşivlenmiş herhangi bir projeye karşı doğru tutumdur.

Narratium'ın uzun biçimli tarzı için model seçimleri.

Narratium'ın tasarımı uzun dallanan anlatıların merkezinde yer alır, bu da model seçimini uzun ufuklar boyunca tutarlılığa doğru ağırlıklandırır. deepseek-v4-flash, katalogdaki en düşük oranlarla günlük oturumları taşır ve roleplay topluluğu diyaloğunu fiyatının üzerinde derecelendirmeye devam eder. glm-5.1 ve kimi-k2.6, ses çeşitliliği için rotasyona girer; glm-5.2 ise uzun ufuklu talimat uyumunun akıl yürütme gecikmesine ağır bastığı detay yoğun bölümleri hak eder. claude-sonnet-4-6, bunu hak eden bölümler için iş yerine uygun nesir tavanı olmaya devam eder. Frontend her turda hikaye bağlamını yeniden gönderdiği için input token'ları maliyete hakim olur ve kasıtlı bir çalışma penceresi maksimal bir pencereden daha iyidir; aşağıda bağlantısı verilen bağlam uzunluğu rehberi hesaplamayı yapar. İçerik politikası bunların hiçbirinden etkilenmez: model politikaları ve geçerli platform şartları yazıldığı gibi uygulanır ve politika karşılaştırma sayfası hangi ailelerin hangi içerik derecelendirmelerine uyduğunu somut biçimde kapsar.

Kullandıkça öde · resmi fiyatların altında

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModelResmi FiyatBizim Fiyatımız
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.1$0.86 / $3.43 per M$0.90 / $3.40 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M

Arşivlenmiş bir istemciyi yine de benimsemeli misiniz?

Bu sayfa her hâlükârda kurulum rehberi olduğundan, dürüst bir maliyet-fayda analizi. Lehinde: kod açık, arayüz yapılandırılmış uzun biçimli hikayeler için gerçekten iyi, kartlar içe ve dışa taşınabilir ve jenerik bir endpoint model tarafını sonsuza dek güncel tutar. Aleyhinde: güvenlik yaması yok, hata düzeltmesi yok, bağımlılıklar yerinde yaşlanıyor ve herhangi bir barındırılan örnek ödünç zaman üzerinde yaşıyor. Ölçülü bir anahtara karşı yerel olarak çalışan hobi amaçlı bir istemci için bu risk profili birçok kişi için kabul edilebilir; başka kullanıcıları veya hassas verisi olan herhangi bir şey için değil. Orta yol, bu sayfanın baştan beri tarif ettiği yoldur: kendiniz çalıştırın, yatırımınızı taşınabilir katmanlarda (kartlar, lorebook'lar, endpoint) tutun ve istemciyi değiştirilebilir olarak değerlendirin. Bu sahnedeki frontend'ler gelir gider; taşınabilir kartlar ve istikrarlı bir /v1 endpoint'i tarafından desteklenen bir hikaye, hepsinden daha uzun yaşar.

Sık sorulan sorular

Narratium'da özel bir API base URL'si nasıl ayarlarım?

API ayarlarında OpenAI formatlı bağlantıyı seçin, ardından base URL olarak https://api.apisrouter.com/v1, anahtarınızı ve deepseek-v4-flash gibi tam bir model id'si girin. README, OpenAI formatlı API'leri veya birleşik çoklu model endpoint'ini önerir; bu tam olarak bu yapılandırmadır.

Narratium hâlâ bakımı yapılıyor mu?

Hayır. GitHub deposu arşivlenmiş ve salt okunur durumda (GitHub arşiv tarihini 30 Mart 2026 olarak gösteriyor), bu yüzden hiçbir düzeltme veya güncelleme yayınlanmıyor. Kod hâlâ çalışıyor ve klonlanabilir durumda; kendi barındırmak onu kullanmanın güvenilir yoludur, beklenti donmuş bir özellik setine ayarlanmalıdır.

Narratium, SillyTavern karakter kartlarıyla çalışıyor mu?

Evet, SillyTavern formatıyla kart uyumluluğu belgelenmiş özelliklerinden biridir; bu da karakterlerinizi her iki yönde de taşınabilir tutar: kartlar Narratium'a içe aktarılır ve daha sonra SillyTavern, RisuAI veya Wyvern'e geçerseniz emeğiniz mahsur kalmaz.

Bir gateway üzerinden Narratium ile hangi modeller çalışır?

Endpoint'in sunduğu her şey, çünkü Narratium model adını düz bir string olarak gönderir: hacim için deepseek-v4-flash ve glm-5.1, rotasyon için kimi-k2.6, detay yoğun bölümler için glm-5.2, iş yerine uygun nesir için claude-sonnet-4-6. Değiştirmek bir ayar değişikliğidir ve sohbet geçmişi istemcide kalır.

Narratium'ı tamamen yerel olarak çalıştırabilir miyim?

Evet, iki anlamda: istemci arşivlenmiş kaynaktan kendi barındırılır ve Ollama desteği de modelleri yerel olarak çalıştırır. Çoğu kişinin vardığı hibrit, arkasında barındırılan bir endpoint bulunan yerel bir istemcidir; bu, veri işlemeyi elinizde tutarken hiçbir tüketici GPU'sunun sunamayacağı modellere ulaşmanızı sağlar.

Özel bir endpoint kullanmak herhangi bir şartı ihlal eder mi?

Narratium açık kaynaklıdır ve tam olarak bu yapılandırma için inşa edilmiştir. Özel bir endpoint'in asla değiştirmediği şey, model tarafındaki içerik politikasıdır: her ailenin yazılı kuralları nereden sunulursa sunulsun geçerlidir ve politika karşılaştırma sayfası bunları somut biçimde kapsar.