Narratium কাস্টম API সেটআপ: base URL, key, model।
Updated 2026-07-29
Narratium একটা open-source roleplay এবং storytelling client যা নিজের interface নিয়ে আসে কিন্তু নিজস্ব কোনো মডেল নেই: এর README ব্যবহারকারীদের OpenAI-format API, OpenRouter-style unified endpoint, এবং local Ollama-র দিকে নির্দেশ করে। এর API settings https://api.apisrouter.com/v1-এ এক key দিয়ে point করুন এবং পুরো catalog এর backend হয়ে যায়। বেশিরভাগ guide যা এড়িয়ে যায় তা এই পেজ স্পষ্টভাবে বলে: GitHub repository archived, তাই এই fact মাথায় রেখেই এটা চালান।
দ্রুত উত্তর: Narratium-এর যে values দরকার।
Narratium-এর LLM connection হলো standard OpenAI-compatible triple, যা এর API settings-এ enter করা হয়: একটা base URL, একটা API key, এবং একটা model name। এই gateway-এর জন্য সেগুলো হলো https://api.apisrouter.com/v1, আপনার sk-... key, এবং যেকোনো catalog id — story traffic-এর জন্য deepseek-v4-flash একটা sensible প্রথম pick। প্রজেক্টের README ঠিক এই ধরনের connection-ই recommend করে: সরাসরি OpenAI-format API, variety-র জন্য একটা unified multi-model endpoint, অথবা local মডেলের জন্য Ollama এবং LM Studio — সবই একই configuration surface দিয়ে। Exact field label web build এবং version-ভেদে ভিন্ন হয়, তাই label গুলো loosely এবং value গুলো exactly ধরুন: URL শেষ হয় /v1-এ, key clean paste হয়, model id catalog string-এর সাথে character for character মেলে।
Base URL: https://api.apisrouter.com/v1
API key: sk-... (from APIsRouter)
Model: deepseek-v4-flash (typed exactly; any catalog id works)Narratium আসলে কী, এবং এর status, সরাসরি বলা।
Narratium (GitHub-এ Narratium/Narratium.ai) নিজেকে roleplay-এর জন্য VSCode হিসেবে pitch করেছিল: AI-driven storytelling, worldbuilding, এবং long-form interactive fiction-এর জন্য একটা open-source client, সাথে SillyTavern character card compatibility, memory persistence, এবং একটা plugin system। Code-টা AGPL-licensed, এটা দ্রুত একটা real community আকর্ষণ করেছিল, এবং scene-এর মধ্যে এখনো এটা অন্যতম আকর্ষণীয় open client। এখন সেই অংশ যা বেশিরভাগ setup guide বাদ দেয়: GitHub repository archived এবং read-only (GitHub archive date দেখায় March 30, 2026)। Archived মানে broken নয় — code ঠিক ততটাই ভালো চলে যতটা freeze হওয়ার দিন চলত — কিন্তু এর মানে কোনো maintainer আর fix, dependency update, বা security patch ship করছে না, এবং প্রজেক্টের সাথে যুক্ত hosted instance গুলোকে best-effort হিসেবেই ধরা উচিত। আজ Narratium adopt করলে, নির্ভরযোগ্য পথ হলো source বা একটা release থেকে নিজে চালানো, এবং বাস্তবসম্মত expectation হলো একটা frozen feature set। সেই status API advice-কে একটা নির্দিষ্ট উপায়ে বদলে দেয়: একটা frozen client-ই ঠিক সেই situation যেখানে model side flexible রাখতে চান। Narratium আর নতুন provider integration যোগ করতে পারে না, কিন্তু এটা যে OpenAI-compatible endpoint ইতিমধ্যে বোঝে, সেটা সেই endpoint-এর পেছনে যত নতুন মডেল আসে সবকিছুই serve করতে থাকে। Gateway pattern কার্যকরভাবে এমন একটা client-কে future-proof করে যেটা আর এগোচ্ছে না।
সেটআপ walkthrough।
Troubleshooting universal pattern মেনে চলে: প্রথমে একটা curl request দিয়ে তিনটা value প্রমাণ করুন, এবং curl সফল হলেও app fail করলে, সাধারণ কারণ হলো URL-এ একটা বাড়তি path segment, key-তে whitespace, অথবা web build-এ একটা browser CORS block, যা developer console-এ visible। যেহেতু আর কোনো maintainer app-side quirk-এর জন্য fix ship করবে না, তাই এখানে curl-first habit একটু বেশিই গুরুত্বপূর্ণ: এটা সাথে সাথেই বলে দেয় connection-এর কোন দিক নিয়ে আপনি আসলে কিছু করতে পারেন।
- Narratium চালু করুন: GitHub source বা একটা release থেকে self-host করুন (repo read-only কিন্তু পুরোপুরি cloneable), অথবা যদি আপনার বিশ্বস্ত কোনো hosted instance এখনো চলে তাহলে সেটা ব্যবহার করুন।
- Settings খুলুন এবং API / LLM configuration section খুঁজুন।
- Ollama-র বদলে OpenAI-format connection type select করুন, যেহেতু আপনি একটা hosted endpoint-এ point করছেন।
- base URL https://api.apisrouter.com/v1 enter করুন এবং আপনার key paste করুন।
- model id ঠিক ঠিক টাইপ করুন: শুরুর জন্য deepseek-v4-flash।
- Save করুন এবং round trip confirm করতে একটা fresh story-তে একটা ছোট message পাঠান।
Card, world, এবং আপনি চলে গেলে কী টিকে থাকে।
Narratium SillyTavern-compatible character card পড়ে, যা এর সবচেয়ে গুরুত্বপূর্ণ compatibility fact। আপনার character গুলো portable artifact: অন্য কোথাও লেখা card import হয়, এবং persona ও world note-এ আপনি যে কাজ করেছেন তা এমন একটা client-এ আটকে নেই যার development থেমে গেছে। কখনো migrate করলে, SillyTavern, RisuAI, এবং Wyvern সবাই একই card lineage বোঝে, এবং নিচের setup পেজগুলো প্রতিটা cover করে। একই portability logic model side-এও প্রযোজ্য। Narratium যেহেতু একটা generic /v1 endpoint-এর সাথে কথা বলে, আপনার provider setup-এর কোনো কিছুই Narratium-specific নয়: একই key এবং base URL অন্য যেকোনো frontend-এ unchanged drop হয়। Portable card এবং portable endpoint-এর মাঝে, পুরো stack-এর switching cost শূন্যের কাছাকাছি নেমে আসে, যা এখনো enjoy করে ব্যবহার করা যেকোনো archived project-এর প্রতি সঠিক posture।
Narratium-এর long-form style-এর জন্য model pick।
Narratium-এর design লম্বা branching narrative-কে কেন্দ্র করে, যা model choice-কে long horizon-এ consistency-র দিকে ঝোঁকায়। deepseek-v4-flash catalog-এর সবচেয়ে কম রেটে everyday session বহন করে, dialogue-সহ যাকে roleplay community ক্রমাগত এর দামের চেয়ে ভালো rate করে। glm-5.1 এবং kimi-k2.6 voice variety-র জন্য rotate করে, আর glm-5.2 detail-heavy chapter-এ জেতে যেখানে এর long-horizon instruction adherence reasoning latency-কে ছাড়িয়ে যায়। claude-sonnet-4-6 এখনো সেই chapter-গুলোর জন্য safe-for-work prose ceiling যা এটার যোগ্য। Frontend যেহেতু প্রতি turn story context resend করে, input token cost-এ dominate করে, এবং একটা deliberate working window একটা maximal window-এর চেয়ে ভালো; নিচের context-length guide এর হিসাব করে দেখায়। এসবের কোনোটাতেই content policy বদলায় না: model policy এবং applicable platform terms লেখা অনুযায়ীই প্রযোজ্য, এবং policies-compared পেজ কোন family কোন content rating-এর সাথে fit করে তা factually cover করে।
ব্যবহার অনুযায়ী পেমেন্ট · অফিশিয়াল মূল্যের নিচে
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| মডেল | অফিশিয়াল মূল্য | আমাদের মূল্য |
|---|---|---|
| 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 |
আপনি কি এখনো একটা archived client adopt করবেন?
একটা honest cost-benefit, যেহেতু এই পেজ যেভাবেই হোক setup guide। পক্ষে: code open, interface structured long-form story-র জন্য সত্যিই ভালো, card ভেতরে-বাইরে portable, এবং একটা generic endpoint model side-কে চিরকাল current রাখে। বিপক্ষে: কোনো security patch নেই, কোনো bug fix নেই, dependency জায়গায় বসেই বয়স বাড়ছে, এবং যেকোনো hosted instance ধার করা সময়ে বেঁচে আছে। একটা metered key-এর বিরুদ্ধে locally চলা hobby client-এর জন্য, সেই risk profile অনেকের কাছে acceptable; অন্য user বা sensitive data থাকা যেকোনো কিছুর জন্য, তা নয়। মাঝের পথটাই এই পেজ শুরু থেকে বর্ণনা করে আসছে: নিজে চালান, portable layer-গুলোতে (card, lorebook, endpoint) আপনার investment রাখুন, এবং client-কে replaceable হিসেবে ধরুন। এই scene-এ frontend আসে আর যায়; portable card এবং একটা স্থিতিশীল /v1 endpoint-সমর্থিত একটা story এদের সবার চেয়ে বেশি টিকে থাকে।
সাধারণ প্রশ্ন
Narratium-এ কীভাবে একটা কাস্টম API base URL সেট করব?
API settings-এ, OpenAI-format connection choose করুন, তারপর base URL https://api.apisrouter.com/v1, আপনার key, এবং deepseek-v4-flash-এর মতো একটা exact model id enter করুন। README OpenAI-format API বা একটা unified multi-model endpoint recommend করে, যা ঠিক এই configuration।
Narratium কি এখনো maintained?
না। GitHub repository archived এবং read-only (GitHub archive date হিসেবে March 30, 2026 দেখায়), তাই কোনো fix বা update আর ship হচ্ছে না। code এখনো চলে এবং cloneable থেকে যায়; self-hosting এটা ব্যবহারের নির্ভরযোগ্য উপায়, expectation একটা frozen feature set-এ সেট করা।
Narratium কি SillyTavern character card-এর সাথে কাজ করে?
হ্যাঁ, SillyTavern format-এর সাথে card compatibility এর একটা documented feature, যা আপনার character-কে দুই দিকেই portable রাখে: card Narratium-এ import হয়, এবং পরে SillyTavern, RisuAI, বা Wyvern-এ move করলেও আপনার কাজ আটকে থাকে না।
একটা gateway দিয়ে Narratium-এর সাথে কোন মডেল কাজ করে?
endpoint যা serve করে তার সবকিছু, যেহেতু Narratium model name একটা plain string হিসেবে পাঠায়: volume-এর জন্য deepseek-v4-flash এবং glm-5.1, rotation-এর জন্য kimi-k2.6, detail-heavy chapter-এর জন্য glm-5.2, safe-for-work prose-এর জন্য claude-sonnet-4-6। Switching একটা settings change, এবং chat history client-এর সাথেই থাকে।
আমি কি Narratium সম্পূর্ণ locally চালাতে পারি?
হ্যাঁ, দুই অর্থে: client archived source থেকে self-host করে, এবং এর Ollama support locally-ও মডেল চালায়। বেশিরভাগ মানুষ যে hybrid-এ পৌঁছায় তা হলো একটা local client যার পেছনে একটা hosted endpoint, যা data handling আপনার হাতে রাখে অথচ এমন মডেল পর্যন্ত পৌঁছায় যা কোনো consumer GPU serve করে না।
একটা কাস্টম endpoint ব্যবহার করা কি কোনো terms-এর বিরুদ্ধে?
Narratium open source এবং ঠিক এই configuration-এর জন্যই তৈরি। একটা কাস্টম endpoint যা কখনো বদলায় না তা হলো model-side content policy: প্রতিটা family-র লিখিত নিয়ম যেখান থেকেই serve হোক প্রযোজ্য, এবং policies-compared পেজ সেগুলো factually cover করে।