Narratium custom API سیٹ اپ: base URL، key، model۔
Updated 2026-07-29
Narratium ایک open-source roleplay اور storytelling client ہے جو اپنا interface لاتا ہے اور اپنا کوئی model نہیں: اس کا README users کو OpenAI-format APIs، OpenRouter-طرز کے unified endpoints، اور local Ollama کی طرف اشارہ کرتا ہے۔ اس کی API settings کو ایک key کے ساتھ https://api.apisrouter.com/v1 پر point کریں اور پورا catalog اس کا backend بن جاتا ہے۔ ایک بات جو یہ صفحہ صاف بیان کرتا ہے اور زیادہ تر گائیڈز چھوڑ دیتے ہیں: GitHub repository archived ہے، تو یہ fact قیمت میں شامل کر کے چلائیں۔
فوری جواب: وہ values جو Narratium کو چاہئیں۔
Narratium کا LLM connection وہی معیاری OpenAI-compatible تین چیزیں ہیں، اس کی API settings میں درج: ایک base URL، ایک API key، اور ایک model name۔ اس gateway کے لیے یہ ہیں https://api.apisrouter.com/v1، آپ کی sk-... key، اور کوئی بھی catalog id، story traffic کے لیے deepseek-v4-flash عقلمندانہ پہلا انتخاب ہے۔ project کا README بالکل اسی طرح کا connection تجویز کرتا ہے: OpenAI-format APIs براہ راست، تنوع کے لیے ایک unified multi-model endpoint، یا local models کے لیے Ollama اور LM Studio، سب اسی configuration surface کے ذریعے۔ exact field labels web build اور versions کے درمیان مختلف ہوتے ہیں، تو labels کو ڈھیلے انداز میں اور values کو بالکل exact treat کریں: URL /v1 پر ختم ہو، key صاف paste ہو، model id catalog string سے حرف بہ حرف میچ کرے۔
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 کے طور پر پیش کرتا تھا: AI-driven storytelling، worldbuilding، اور long-form interactive fiction کے لیے ایک open-source client، SillyTavern character card مطابقت، memory persistence، اور ایک plugin system کے ساتھ۔ Code AGPL-licensed ہے، اس نے تیزی سے ایک حقیقی community کھینچی، اور یہ scene کے دلچسپ ترین open clients میں سے ایک رہتا ہے۔ اب وہ حصہ جو زیادہ تر setup گائیڈز چھوڑ دیتی ہیں: GitHub repository archived اور read-only ہے (GitHub archive date 30 مارچ 2026 دکھاتا ہے)۔ Archived کا مطلب broken نہیں، code بالکل ویسے ہی چلتا ہے جیسے وہ freeze ہونے والے دن چلتا تھا، مگر اس کا مطلب ہے کوئی maintainer fixes، dependency updates، یا security patches نہیں بھیج رہا، اور project سے وابستہ hosted instances کو زیادہ سے زیادہ best-effort سمجھنا چاہیے۔ اگر آپ آج Narratium اپناتے ہیں، بھروسے مند راستہ اسے خود source یا release سے چلانا ہے، اور حقیقت پسندانہ توقع ایک frozen feature set ہے۔ وہ status API advice کو ایک مخصوص طریقے سے بدلتا ہے: ایک frozen client بالکل وہی صورتحال ہے جہاں آپ چاہتے ہیں کہ model side لچکدار رہے۔ Narratium اب نئے provider integrations شامل نہیں کر سکتا، مگر ایک OpenAI-compatible endpoint جس سے یہ پہلے سے بات کرتا ہے وہ کوئی بھی نئے models serve کرتا رہتا ہے جو اس endpoint کے پیچھے آئیں۔ Gateway pattern عملی طور پر ایک ایسے client کو future-proof کرتا ہے جو اب آگے نہیں بڑھ رہا۔
سیٹ اپ واک تھرو۔
Troubleshooting universal pattern پر چلتی ہے: پہلے curl request کے ساتھ تین values ثابت کریں، اور اگر curl کامیاب ہو جبکہ app fail ہو، عام مجرم ایک stray path segment والا URL، key میں whitespace، یا web builds پر browser CORS block ہیں، جو developer console میں نظر آتے ہیں۔ چونکہ اب کوئی maintainer app-side quirks کے لیے fix نہیں بھیجے گا، curl-first عادت یہاں تھوڑی زیادہ اہم ہے: یہ فوراً بتا دیتی ہے کہ connection کے کس طرف آپ واقعی کچھ کر سکتے ہیں۔
- Narratium چلائیں: GitHub source یا کسی release سے self-host کریں (repo read-only ہے مگر مکمل طور پر cloneable)، یا اگر کوئی قابلِ اعتماد hosted instance اب بھی چل رہا ہو تو وہ استعمال کریں۔
- Settings کھولیں اور API / LLM configuration سیکشن ڈھونڈیں۔
- Ollama کی بجائے OpenAI-format connection type منتخب کریں، چونکہ آپ ایک hosted endpoint پر point کر رہے ہیں۔
- base URL https://api.apisrouter.com/v1 درج کریں اور اپنی key paste کریں۔
- model id بالکل ٹائپ کریں: شروع کرنے کے لیے deepseek-v4-flash۔
- Save کریں اور راؤنڈ ٹرپ confirm کرنے کے لیے کسی نئی story میں ایک مختصر message بھیجیں۔
Cards، worlds، اور اگر آپ چھوڑ دیں تو کیا بچتا ہے۔
Narratium SillyTavern-compatible character cards پڑھتا ہے، جو اس کے بارے میں سب سے اہم مطابقت fact ہے۔ آپ کے characters portable artifacts ہیں: کہیں اور لکھے گئے cards import ہوتے ہیں، اور personas اور world notes میں آپ کی investment کسی ایسے client میں locked نہیں جس کی development رک چکی ہو۔ اگر آپ کبھی migrate کریں، SillyTavern، RisuAI، اور Wyvern سب اسی card lineage میں بات کرتے ہیں، اور نیچے linked setup صفحات ہر ایک کو cover کرتے ہیں۔ وہی portability logic model side پر بھی لاگو ہوتی ہے۔ چونکہ Narratium ایک generic /v1 endpoint سے بات کرتا ہے، آپ کے provider setup میں کچھ بھی Narratium-specific نہیں: وہی key اور base URL بغیر کسی تبدیلی کے کسی دوسرے frontend میں drop ہو جاتے ہیں۔ portable cards اور ایک portable endpoint کے درمیان، پورے stack کی switching cost تقریباً صفر ہو جاتی ہے، جو کسی بھی archived project کے لیے صحیح رویہ ہے جسے آپ اب بھی استعمال کرنا پسند کرتے ہیں۔
Narratium کے long-form انداز کے لیے model انتخاب۔
Narratium کا design لمبی branching narratives کے گرد بنا ہے، جو model انتخاب کو لمبے horizons پر consistency کی طرف جھکاتا ہے۔ deepseek-v4-flash روزمرہ sessions کو catalog کی سب سے کم rates پر چلاتا ہے، مکالمے کے ساتھ جسے roleplay کمیونٹی مسلسل اس کی قیمت سے اوپر rate کرتی ہے۔ glm-5.1 اور kimi-k2.6 آواز میں تنوع کے لیے rotate ہوتے ہیں، اور glm-5.2 detail-heavy chapters میں جگہ کماتا ہے جہاں اس کی long-horizon instruction adherence اس کی reasoning latency پر بھاری پڑتی ہے۔ claude-sonnet-4-6 ان chapters کے لیے safe-for-work prose ceiling رہتا ہے جو اس کے لائق ہوں۔ چونکہ frontend ہر turn پر story context دوبارہ بھیجتا ہے، input tokens لاگت پر حاوی رہتے ہیں، اور ایک جان بوجھ کر رکھی گئی working window maximal سے بہتر ہے؛ نیچے linked context-length گائیڈ یہ حساب کرتی ہے۔ Content policy ان میں سے کسی سے نہیں بدلتی: model policies اور applicable platform terms جوں کے توں لاگو رہتے ہیں، اور policies-compared صفحہ حقیقتاً بیان کرتا ہے کون سی families کس content rating کے لیے موزوں ہیں۔
استعمال کے مطابق ادائیگی · سرکاری قیمت سے کم
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 اپنانا چاہیے؟
ایک ایماندارانہ cost-benefit، چونکہ یہ صفحہ ہر صورت setup گائیڈ ہے۔ حق میں: code open ہے، interface structured long-form stories کے لیے واقعی اچھا ہے، cards دونوں طرف portable ہیں، اور ایک generic endpoint model side کو ہمیشہ current رکھتا ہے۔ خلاف: کوئی security patches نہیں، کوئی bug fixes نہیں، dependencies جوں کی توں پرانی ہو رہی ہیں، اور کوئی بھی hosted instance ادھار وقت پر جی رہا ہے۔ کسی hobby client کے لیے جو locally ایک metered key کے خلاف چلے، یہ risk profile بہت سے لوگوں کے لیے قابلِ قبول ہے؛ کسی بھی ایسی چیز کے لیے جس میں دوسرے users یا sensitive data ہو، یہ نہیں۔ درمیانی راستہ وہی ہے جو یہ صفحہ شروع سے بیان کر رہا ہے: اسے خود چلائیں، اپنی investment portable layers (cards، lorebooks، endpoint) میں رکھیں، اور client کو replaceable سمجھیں۔ اس scene کے frontends آتے جاتے رہتے ہیں؛ portable cards اور ایک stable /v1 endpoint سے سہارا لینے والی story ان سب سے زیادہ عرصہ چلتی ہے۔
عمومی سوالات
میں Narratium میں custom API base URL کیسے set کروں؟
API settings میں، OpenAI-format connection چنیں، پھر base URL https://api.apisrouter.com/v1، اپنی key، اور deepseek-v4-flash جیسی exact model id درج کریں۔ README OpenAI-format APIs یا ایک unified multi-model endpoint تجویز کرتا ہے، جو بالکل یہی configuration ہے۔
کیا Narratium اب بھی maintained ہے؟
نہیں۔ GitHub repository archived اور read-only ہے (GitHub 30 مارچ 2026 کو archive date کے طور پر دکھاتا ہے)، تو کوئی fixes یا updates نہیں بھیجے جا رہے۔ Code پھر بھی چلتا ہے اور cloneable رہتا ہے؛ self-hosting اسے استعمال کرنے کا بھروسے مند طریقہ ہے، توقعات ایک frozen feature set پر set کر کے۔
کیا Narratium SillyTavern character cards کے ساتھ کام کرتا ہے؟
جی ہاں، SillyTavern format کے ساتھ card مطابقت اس کی documented features میں سے ایک ہے، جو آپ کے characters کو دونوں سمتوں میں portable رکھتی ہے: cards Narratium میں import ہوتے ہیں، اور اگر آپ بعد میں SillyTavern، RisuAI، یا Wyvern پر جائیں تو آپ کا کام پھنستا نہیں۔
gateway کے ذریعے Narratium کے ساتھ کون سے models کام کرتے ہیں؟
وہ سب کچھ جو endpoint serve کرے، چونکہ Narratium model name کو plain string کے طور پر بھیجتا ہے: volume کے لیے deepseek-v4-flash اور glm-5.1، rotation کے لیے kimi-k2.6، detail-heavy chapters کے لیے glm-5.2، safe-for-work prose کے لیے claude-sonnet-4-6۔ سوئچ کرنا ایک settings تبدیلی ہے، اور chat history client کے ساتھ رہتی ہے۔
کیا میں Narratium مکمل طور پر locally چلا سکتا ہوں؟
جی ہاں، دو معنوں میں: client archived source سے خود self-host کرتا ہے، اور اس کا Ollama support بھی models locally چلاتا ہے۔ زیادہ تر لوگ جس hybrid پر settle ہوتے ہیں وہ ایک local client کے پیچھے ایک hosted endpoint ہے، جو data handling آپ کے ہاتھ میں رکھتا ہے جبکہ ایسے models تک پہنچتا ہے جو کوئی consumer GPU serve نہیں کرتا۔
کیا custom endpoint استعمال کرنا کسی شرط کے خلاف ہے؟
Narratium open source ہے اور بالکل اسی configuration کے لیے بنایا گیا ہے۔ ایک custom endpoint جو کبھی نہیں بدلتا وہ model-side content policy ہے: ہر family کے لکھے ہوئے rules جہاں بھی serve ہو لاگو رہتے ہیں، اور policies-compared صفحہ انہیں حقیقتاً cover کرتا ہے۔