Files
OmniRoute/docs/i18n/pa/docs/guides/USER_GUIDE.md
Diego Rodrigues de Sa e Souza b637350680 fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940)
1,104 mirrors rewritten over five passes of run-translation on the 22-source core set: the 14 sources edited since their translation, the 322 mirrors that were still English copies, and the frontmatter the old extractor leaked into the newer locales' bodies. The pipeline now caches per-`## `-section hashes and retranslates only changed sections, never reuses a section that is still English, rebuilds English-copy / leaked mirrors even when the source is unchanged, merges the state on save (parallel runs), and the drift gate (scoped to the core set) is blocking. Final audit: 0 stale, 0 English copies, 0 leaked frontmatter across 1,430 core mirrors.

⚠️ base-red inherited: #12732
2026-09-17 02:55:31 -03:00

107 KiB
Raw Blame History

User Guide (ਪੰਜਾਬੀ)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW


🌐 ਭਾਸ਼ਾਵਾਂ: 🇺🇸 English | 🇪🇹 አማርኛ | 🇸🇦 العربية | 🇦🇿 Azərbaycan dili | 🇧🇬 Български | 🇧🇩 বাংলা | 🇨🇿 Čeština | 🇩🇰 Dansk | 🇩🇪 Deutsch | 🇬🇷 Ελληνικά | 🇪🇸 Español | 🇪🇪 Eesti | 🇮🇷 فارسی | 🇫🇮 Suomi | 🇫🇷 Français | 🇮🇪 Gaeilge | 🇮🇳 ગુજરાતી | 🇳🇬 Hausa | 🇮🇱 עברית | 🇮🇳 हिन्दी | 🇭🇷 Hrvatski | 🇭🇺 Magyar | 🇦🇲 Հայերեն | 🇮🇩 Bahasa Indonesia | 🇳🇬 Igbo | 🇮🇹 Italiano | 🇯🇵 日本語 | 🇬🇪 ქართული | 🇰🇭 ខ្មែរ | 🇮🇳 ಕನ್ನಡ | 🇰🇷 한국어 | 🇱🇹 Lietuvių | 🇱🇻 Latviešu | 🇮🇳 മലയാളം | 🇮🇳 मराठी | 🇲🇾 Bahasa Melayu | 🇲🇹 Malti | 🇲🇲 မြန်မာ | 🇳🇵 नेपाली | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇮🇳 ଓଡ଼ିଆ | 🇮🇳 ਪੰਜਾਬੀ | 🇵🇭 Filipino | 🇵🇱 Polski | 🇵🇹 Português (Portugal) | 🇧🇷 Português (Brasil) | 🇷🇴 Română | 🇷🇺 Русский | 🇱🇰 සිංහල | 🇸🇰 Slovenčina | 🇸🇮 Slovenščina | 🇷🇸 Српски | 🇸🇪 Svenska | 🇰🇪 Kiswahili | 🇮🇳 தமிழ் | 🇮🇳 తెలుగు | 🇹🇭 ไทย | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇵🇰 اردو | 🇺🇿 Oʻzbekcha | 🇻🇳 Tiếng Việt | 🇳🇬 Yorùbá | 🇨🇳 中文 (简体) | 🇹🇼 中文 (繁體)

ਪ੍ਰਦਾਤਾਵਾਂ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ, ਕੰਬੋ ਬਣਾਉਣ, CLI ਟੂਲਾਂ ਨੂੰ ਏਕੀਕ੍ਰਿਤ ਕਰਨ ਅਤੇ OmniRoute ਨੂੰ ਡਿਪਲੋਇ ਕਰਨ ਲਈ ਸੰਪੂਰਨ ਗਾਈਡ।


ਵਿਸ਼ਾ-ਸੂਚੀ


💰 ਇੱਕ ਨਜ਼ਰ ਵਿੱਚ ਕੀਮਤਾਂ

ਪੱਧਰ ਪ੍ਰਦਾਤਾ ਲਾਗਤ ਕੋਟਾ ਰੀਸੈੱਟ ਸਭ ਤੋਂ ਢੁਕਵਾਂ
💳 ਸਬਸਕ੍ਰਿਪਸ਼ਨ Claude Code (Pro) $20/ਮਹੀਨਾ 5 ਘੰਟੇ + ਹਫ਼ਤਾਵਾਰੀ ਪਹਿਲਾਂ ਤੋਂ ਸਬਸਕ੍ਰਾਈਬ ਕੀਤੇ ਉਪਭੋਗਤਾ
Codex (Plus/Pro) $20-200/ਮਹੀਨਾ 5 ਘੰਟੇ + ਹਫ਼ਤਾਵਾਰੀ OpenAI ਉਪਭੋਗਤਾ
GitHub Copilot $10-19/ਮਹੀਨਾ ਮਹੀਨਾਵਾਰ GitHub ਉਪਭੋਗਤਾ
🔑 API KEY DeepSeek ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਸਸਤੀ ਤਰਕ-ਸਮਰੱਥਾ
Groq ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਬੇਹੱਦ ਤੇਜ਼ ਇਨਫ਼ਰੈਂਸ
xAI (Grok) ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ Grok 4 ਤਰਕ-ਸਮਰੱਥਾ
Mistral ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ EU ਵਿੱਚ ਹੋਸਟ ਕੀਤੇ ਮਾਡਲ
Perplexity ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਖੋਜ ਨਾਲ ਸੰਵਰਧਿਤ
Together AI ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਓਪਨ-ਸੋਰਸ ਮਾਡਲ
Fireworks AI ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਤੇਜ਼ FLUX ਚਿੱਤਰ
Cerebras ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਵੇਫ਼ਰ-ਸਕੇਲ ਗਤੀ
Cohere ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ Command R+ RAG
NVIDIA NIM ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ਐਂਟਰਪ੍ਰਾਈਜ਼ ਮਾਡਲ
Baidu Qianfan ਵਰਤੋਂ ਅਨੁਸਾਰ ਭੁਗਤਾਨ ਕੋਈ ਨਹੀਂ ERNIE ਮਾਡਲ
💰 ਸਸਤਾ GLM-4.7 $0.6/1M ਰੋਜ਼ਾਨਾ ਸਵੇਰੇ 10 ਵਜੇ ਬਜਟ ਬੈਕਅੱਪ
MiniMax M2.1 $0.2/1M ਹਰ 5 ਘੰਟਿਆਂ ਬਾਅਦ ਸਭ ਤੋਂ ਸਸਤਾ ਵਿਕਲਪ
Kimi K2 $9/ਮਹੀਨਾ ਨਿਸ਼ਚਿਤ 10M ਟੋਕਨ/ਮਹੀਨਾ ਅਨੁਮਾਨਯੋਗ ਲਾਗਤ
🆓 ਮੁਫ਼ਤ Qoder $0 ਪ੍ਰਦਾਤਾ ਦੀਆਂ ਸੀਮਾਵਾਂ ਲਾਗੂ ਮੌਜੂਦਾ ਕੈਟਾਲਾਗ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ
Kiro $0 ~50 ਕ੍ਰੈਡਿਟ/ਮਹੀਨਾ ਮੁਫ਼ਤ Claude

🎯 ਵਰਤੋਂ ਦੇ ਮਾਮਲੇ

ਮਾਮਲਾ 1: "ਮੇਰੇ ਕੋਲ Claude Pro ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਹੈ"

ਸਮੱਸਿਆ: ਕੋਟਾ ਬਿਨਾਂ ਵਰਤੋਂ ਦੇ ਖ਼ਤਮ ਹੋ ਜਾਂਦਾ ਹੈ, ਭਾਰੀ ਕੋਡਿੰਗ ਦੌਰਾਨ ਦਰ ਸੀਮਾਵਾਂ ਲੱਗ ਜਾਂਦੀਆਂ ਹਨ

ਕੌਂਬੋ: "maximize-claude"
  1. cc/claude-opus-4-7        (ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਦੀ ਪੂਰੀ ਵਰਤੋਂ ਕਰੋ)
  2. glm/glm-4.7               (ਕੋਟਾ ਮੁੱਕਣ 'ਤੇ ਸਸਤਾ ਬੈਕਅੱਪ)
  3. if/qwen3.8-max-preview       (ਐਮਰਜੈਂਸੀ ਲਈ ਮੁਫ਼ਤ ਵਿਕਲਪ)

ਮਹੀਨਾਵਾਰ ਲਾਗਤ: $20 (ਸਬਸਕ੍ਰਿਪਸ਼ਨ) + ~$5 (ਬੈਕਅੱਪ) = ਕੁੱਲ $25
ਬਨਾਮ $20 + ਸੀਮਾਵਾਂ ਤੱਕ ਪਹੁੰਚਣਾ = ਨਿਰਾਸ਼ਾ

ਮਾਮਲਾ 2: "ਮੈਂ ਸਿਫ਼ਰ ਲਾਗਤ ਚਾਹੁੰਦਾ ਹਾਂ"

ਸਮੱਸਿਆ: ਸਬਸਕ੍ਰਿਪਸ਼ਨਾਂ ਦਾ ਖ਼ਰਚ ਨਹੀਂ ਝੱਲ ਸਕਦਾ, ਭਰੋਸੇਯੋਗ AI ਕੋਡਿੰਗ ਦੀ ਲੋੜ ਹੈ

ਕੌਂਬੋ: "zero-cost"
  1. if/kimi-k2.7-code          (ਸੂਚੀਬੱਧ ਮੁਫ਼ਤ ਪਹੁੰਚ; ਦਰ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)
  2. kr/qwen3-coder-next        (Kiro ਦਾ ਮੁਫ਼ਤ ਵਿਕਲਪ)

ਮਹੀਨਾਵਾਰ ਲਾਗਤ: $0
ਗੁਣਵੱਤਾ: ਆਪਣੇ ਵਰਕਲੋਡ ਲਈ ਮਾਡਲ, ਸੀਮਾਵਾਂ, ਪਰਦੇਦਾਰੀ ਅਤੇ SLA ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ

ਮਾਮਲਾ 3: "ਮੈਨੂੰ ਬਿਨਾਂ ਕਿਸੇ ਰੁਕਾਵਟ ਦੇ 24/7 ਕੋਡਿੰਗ ਚਾਹੀਦੀ ਹੈ"

ਸਮੱਸਿਆ: ਸਮਾਂ-ਸੀਮਾਵਾਂ ਹਨ, ਡਾਊਨਟਾਈਮ ਬਰਦਾਸ਼ਤ ਨਹੀਂ ਕਰ ਸਕਦਾ

ਕੌਂਬੋ: "always-on"
  1. cc/claude-opus-4-7        (ਸਭ ਤੋਂ ਵਧੀਆ ਗੁਣਵੱਤਾ)
  2. cx/gpt-5.5                (ਦੂਜੀ ਸਬਸਕ੍ਰਿਪਸ਼ਨ)
  3. glm/glm-4.7               (ਸਸਤਾ, ਰੋਜ਼ਾਨਾ ਰੀਸੈੱਟ ਹੁੰਦਾ ਹੈ)
  4. minimax/MiniMax-M2.1      (ਸਭ ਤੋਂ ਸਸਤਾ, 5 ਘੰਟਿਆਂ ਬਾਅਦ ਰੀਸੈੱਟ)
  5. if/deepseek-v4-flash       (ਸੂਚੀਬੱਧ ਮੁਫ਼ਤ ਪਹੁੰਚ; ਦਰ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)

ਨਤੀਜਾ: 5 ਬੈਕਅੱਪ ਪੱਧਰ ਲਚੀਲਾਪਣ ਵਧਾਉਂਦੇ ਹਨ; ਅੱਪਸਟ੍ਰੀਮ ਉਪਲਬਧਤਾ ਦੀ ਗਾਰੰਟੀ ਨਹੀਂ ਹੈ
ਮਹੀਨਾਵਾਰ ਲਾਗਤ: $20-200 (ਸਬਸਕ੍ਰਿਪਸ਼ਨਾਂ) + $10-20 (ਬੈਕਅੱਪ)

ਮਾਮਲਾ 4: "ਮੈਨੂੰ OpenClaw ਵਿੱਚ ਮੁਫ਼ਤ AI ਚਾਹੀਦਾ ਹੈ"

ਸਮੱਸਿਆ: ਮੈਸੇਜਿੰਗ ਐਪਾਂ ਵਿੱਚ ਪੂਰੀ ਤਰ੍ਹਾਂ ਮੁਫ਼ਤ AI ਸਹਾਇਕ ਦੀ ਲੋੜ ਹੈ

ਕੌਂਬੋ: "openclaw-free"
  1. if/qwen3.8-max-preview     (ਸੂਚੀਬੱਧ ਮੁਫ਼ਤ ਪਹੁੰਚ; ਦਰ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)
  2. if/deepseek-v4-flash       (ਸੂਚੀਬੱਧ ਮੁਫ਼ਤ ਪਹੁੰਚ; ਦਰ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)
  3. if/kimi-k2.7-code          (ਸੂਚੀਬੱਧ ਮੁਫ਼ਤ ਪਹੁੰਚ; ਦਰ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)

ਮਹੀਨਾਵਾਰ ਲਾਗਤ: $0
ਇਨ੍ਹਾਂ ਰਾਹੀਂ ਪਹੁੰਚ: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

📖 ਪ੍ਰੋਵਾਈਡਰ ਸੈੱਟਅੱਪ

CSV ਜਾਂ JSON ਫ਼ਾਈਲ ਤੋਂ API-ਕੁੰਜੀ ਕਨੈਕਸ਼ਨਾਂ ਨੂੰ ਇਕੱਠੇ ਜੋੜਨ ਲਈ, ਡੈਸ਼ਬੋਰਡ → ਪ੍ਰੋਵਾਈਡਰ → ਫ਼ਾਈਲ ਤੋਂ ਇੰਪੋਰਟ ਕਰੋ ਦੀ ਵਰਤੋਂ ਕਰੋ। ਕਾਲਮ ਸਥਿਤੀ ਅਨੁਸਾਰ ਹਨ (provider,name,apiKey,baseUrl,priority); provider ਪਹਿਲਾਂ ਤੋਂ ਹੀ ਇੱਕ ਪ੍ਰਬੰਧਿਤ ਪ੍ਰੋਵਾਈਡਰ ਜਾਂ ਅਨੁਕੂਲ ਨੋਡ ਵਜੋਂ ਮੌਜੂਦ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ। CSV ਜਾਂ JSON ਫ਼ਾਈਲ ਤੋਂ ਪ੍ਰੋਵਾਈਡਰ ਇੰਪੋਰਟ ਕਰੋ ਵੇਖੋ।

🔐 ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਪ੍ਰੋਵਾਈਡਰ

Claude Code (Pro/Max)

ਡੈਸ਼ਬੋਰਡ → ਪ੍ਰੋਵਾਈਡਰ → Claude Code ਨਾਲ ਕਨੈਕਟ ਕਰੋ
→ OAuth ਲੌਗਇਨ → ਆਟੋਮੈਟਿਕ ਟੋਕਨ ਰਿਫ੍ਰੈਸ਼
→ 5-ਘੰਟੇ + ਹਫ਼ਤਾਵਾਰੀ ਕੋਟਾ ਟ੍ਰੈਕਿੰਗ

ਮਾਡਲ:
  cc/claude-opus-4-7
  cc/claude-sonnet-4-6
  cc/claude-haiku-4-5-20251001

ਮਾਹਰ ਸੁਝਾਅ: ਗੁੰਝਲਦਾਰ ਕੰਮਾਂ ਲਈ Opus ਅਤੇ ਤੇਜ਼ੀ ਲਈ Sonnet ਵਰਤੋ। OmniRoute ਹਰ ਮਾਡਲ ਲਈ ਕੋਟੇ ਨੂੰ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਟ੍ਰੈਕ ਕਰਦਾ ਹੈ!

Claude ਅਤੇ Claude Code-ਅਨੁਕੂਲ ਰੂਟ, Opus ਅਤੇ Sonnet ਮਾਡਲਾਂ ਲਈ max ਸੋਚਣ ਦੇ ਯਤਨ ਨੂੰ ਬਰਕਰਾਰ ਰੱਖਦੇ ਹਨ। Haiku ਮਾਡਲ max ਯਤਨ ਪੱਧਰ ਨੂੰ ਸਵੀਕਾਰ ਨਹੀਂ ਕਰਦੇ, ਇਸ ਲਈ OmniRoute ਉਸ ਬੇਨਤੀ ਨੂੰ ਅੱਪਸਟ੍ਰੀਮ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਉੱਚ ਸੋਚ ਬਜਟ 'ਤੇ ਡਾਊਨਗ੍ਰੇਡ ਕਰ ਦਿੰਦਾ ਹੈ।

OpenAI Codex (Plus/Pro)

ਡੈਸ਼ਬੋਰਡ → ਪ੍ਰੋਵਾਈਡਰ → Codex ਨਾਲ ਕਨੈਕਟ ਕਰੋ
→ OAuth ਲੌਗਇਨ (ਪੋਰਟ 1455)
→ 5-ਘੰਟੇ + ਹਫ਼ਤਾਵਾਰੀ ਰੀਸੈੱਟ

ਮਾਡਲ:
  cx/gpt-5.5
  cx/gpt-5.4
  cx/gpt-5.3-codex
  cx/gpt-5.3-codex-spark

GitHub Copilot

ਡੈਸ਼ਬੋਰਡ → ਪ੍ਰੋਵਾਈਡਰ → GitHub ਨਾਲ ਕਨੈਕਟ ਕਰੋ
→ GitHub ਰਾਹੀਂ OAuth
→ ਮਹੀਨਾਵਾਰ ਰੀਸੈੱਟ (ਮਹੀਨੇ ਦੀ ਪਹਿਲੀ ਤਾਰੀਖ਼)

ਮਾਡਲ:
  gh/gpt-5.5
  gh/gpt-5.4
  gh/claude-sonnet-4.6
  gh/claude-opus-4.7
  gh/gemini-3.1-pro-preview

💰 ਸਸਤੇ ਪ੍ਰੋਵਾਈਡਰ

GLM-4.7 (ਰੋਜ਼ਾਨਾ ਰੀਸੈੱਟ, $0.6/1M)

  1. ਸਾਈਨ ਅੱਪ ਕਰੋ: Zhipu AI
  2. Coding Plan ਤੋਂ API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ
  3. ਡੈਸ਼ਬੋਰਡ → API ਕੁੰਜੀ ਜੋੜੋ: ਪ੍ਰੋਵਾਈਡਰ: glm, API ਕੁੰਜੀ: your-key

ਵਰਤੋਂ: glm/glm-4.7ਮਾਹਰ ਸੁਝਾਅ: Coding Plan ਲਾਗਤ ਦੇ 1/7 'ਤੇ 3× ਕੋਟਾ ਦਿੰਦਾ ਹੈ! ਹਰ ਰੋਜ਼ ਸਵੇਰੇ 10:00 ਵਜੇ ਰੀਸੈੱਟ ਹੁੰਦਾ ਹੈ।

MiniMax M2.1 (5-ਘੰਟੇ ਰੀਸੈੱਟ, $0.20/1M)

  1. ਸਾਈਨ ਅੱਪ ਕਰੋ: MiniMax
  2. API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ → ਡੈਸ਼ਬੋਰਡ → API ਕੁੰਜੀ ਜੋੜੋ

ਵਰਤੋਂ: minimax/MiniMax-M2.1ਮਾਹਰ ਸੁਝਾਅ: ਲੰਮੇ ਸੰਦਰਭ (1M ਟੋਕਨ) ਲਈ ਸਭ ਤੋਂ ਸਸਤਾ ਵਿਕਲਪ!

Kimi K2 ($9/ਮਹੀਨਾ ਨਿਰਧਾਰਤ)

  1. ਸਬਸਕ੍ਰਾਈਬ ਕਰੋ: Moonshot AI
  2. API ਕੁੰਜੀ ਪ੍ਰਾਪਤ ਕਰੋ → ਡੈਸ਼ਬੋਰਡ → API ਕੁੰਜੀ ਜੋੜੋ

ਵਰਤੋਂ: kimi/kimi-k2.5ਮਾਹਰ ਸੁਝਾਅ: 10M ਟੋਕਨਾਂ ਲਈ ਨਿਰਧਾਰਤ $9/ਮਹੀਨਾ = $0.90/1M ਦੀ ਪ੍ਰਭਾਵੀ ਲਾਗਤ!

Baidu Qianfan / ERNIE

  1. ਸਾਈਨ ਅੱਪ ਕਰੋ: Baidu AI Cloud Qianfan
  2. ਇੱਕ Qianfan API ਕੁੰਜੀ ਬਣਾਓ → ਡੈਸ਼ਬੋਰਡ → API ਕੁੰਜੀ ਜੋੜੋ: ਪ੍ਰੋਵਾਈਡਰ: qianfan

ਵਰਤੋਂ: qianfan/ernie-5.1, qianfan/ernie-x1.1, ਜਾਂ ਕੋਈ ਹੋਰ Qianfan OpenAI-ਅਨੁਕੂਲ ਮਾਡਲ ID।

🆓 ਮੁਫ਼ਤ ਪ੍ਰੋਵਾਈਡਰ

ਬਿਨਾਂ ਪ੍ਰਮਾਣੀਕਰਨ ਵਾਲੇ ਮੁਫ਼ਤ ਪ੍ਰੋਵਾਈਡਰਾਂ ਦੇ ਪ੍ਰੋਵਾਈਡਰ ਪੰਨੇ 'ਤੇ ਕਿਸੇ ਪ੍ਰਮਾਣੀਕਰਨ ਦੀ ਲੋੜ ਨਹੀਂ ਦੇ ਕੋਲ ਇੱਕ ਸਵਿੱਚ ਹੁੰਦਾ ਹੈ। ਇਸਨੂੰ ਬੰਦ ਕਰਨ ਨਾਲ ਉਹ ਪ੍ਰੋਵਾਈਡਰ ਅਯੋਗ ਹੋ ਜਾਂਦਾ ਹੈ, ਪ੍ਰੋਵਾਈਡਰਾਂ ਦੇ ਸੰਰਚਿਤ/ਸੰਖੇਪ ਦ੍ਰਿਸ਼ਾਂ ਤੋਂ ਹਟ ਜਾਂਦਾ ਹੈ, ਅਤੇ ਉਸਦੇ ਮਾਡਲ /v1/models ਤੋਂ ਹਟ ਜਾਂਦੇ ਹਨ।

Qoder (9 ਮੁਫ਼ਤ ਮਾਡਲ)

ਡੈਸ਼ਬੋਰਡ → Qoder ਨਾਲ ਕਨੈਕਟ ਕਰੋ → OAuth ਲੌਗਇਨ → ਪਹੁੰਚ ਮੌਜੂਦਾ ਪ੍ਰੋਵਾਈਡਰ ਸੀਮਾਵਾਂ ਦੇ ਅਧੀਨ ਹੈ

ਮਾਡਲ: if/qwen3.8-max-preview, if/qwen3.7-max, if/qwen3.7-plus, if/kimi-k3, if/kimi-k2.7-code, if/glm-5.2, if/deepseek-v4-pro, if/deepseek-v4-flash, if/minimax-m3

Kiro (Claude ਮੁਫ਼ਤ)

ਡੈਸ਼ਬੋਰਡ → Kiro ਨਾਲ ਕਨੈਕਟ ਕਰੋ → AWS Builder ID ਜਾਂ Google/GitHub → ~50 ਕ੍ਰੈਡਿਟ/ਮਹੀਨਾ

ਮਾਡਲ: kr/claude-sonnet-4.5, kr/claude-haiku-4.5

🎨 ਕਾਂਬੋ

ਤੁਸੀਂ ਹਰੇਕ ਕਾਰਡ ਉੱਤੇ ਦਿੱਤੇ ਹੈਂਡਲ ਨੂੰ ਡ੍ਰੈਗ ਕਰਕੇ ਸਿੱਧੇ Dashboard → Combos ਵਿੱਚ ਕਾਂਬੋ ਕਾਰਡਾਂ ਦਾ ਕ੍ਰਮ ਬਦਲ ਸਕਦੇ ਹੋ। ਕ੍ਰਮ SQLite ਵਿੱਚ ਸਟੋਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਮੁੜ ਲੋਡ ਕਰਨ ’ਤੇ ਬਹਾਲ ਹੋ ਜਾਂਦਾ ਹੈ।

ਉਦਾਹਰਨ 1: ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਨੂੰ ਵੱਧ ਤੋਂ ਵੱਧ ਵਰਤੋ → ਸਸਤਾ ਬੈਕਅੱਪ

Dashboard → Combos → ਨਵਾਂ ਬਣਾਓ

ਨਾਮ: premium-coding
ਮਾਡਲ:
  1. cc/claude-opus-4-7 (ਮੁੱਖ ਸਬਸਕ੍ਰਿਪਸ਼ਨ)
  2. glm/glm-4.7 (ਸਸਤਾ ਬੈਕਅੱਪ, $0.6/1M)
  3. minimax/MiniMax-M2.7 (ਸਭ ਤੋਂ ਸਸਤਾ ਫਾਲਬੈਕ, $0.3/1M)

CLI ਵਿੱਚ ਵਰਤੋਂ: premium-coding

ਉਦਾਹਰਨ 2: ਸਿਰਫ਼ ਮੁਫ਼ਤ (ਜ਼ੀਰੋ ਲਾਗਤ)

ਨਾਮ: free-combo
ਮਾਡਲ:
  1. if/kimi-k2.7-code (ਮੁਫ਼ਤ ਪਹੁੰਚ ਵਜੋਂ ਸੂਚੀਬੱਧ; ਪ੍ਰਦਾਤਾ ਦੀਆਂ ਸੀਮਾਵਾਂ ਲਾਗੂ ਹੋ ਸਕਦੀਆਂ ਹਨ)
  2. kr/qwen3-coder-next (Kiro ਮੁਫ਼ਤ ਫਾਲਬੈਕ)

ਲਾਗਤ: ਇਸ ਵੇਲੇ $0 ਵਜੋਂ ਸੂਚੀਬੱਧ; ਸ਼ਰਤਾਂ ਅਤੇ ਉਪਲਬਧਤਾ ਬਦਲ ਸਕਦੀਆਂ ਹਨ

🔧 CLI ਏਕੀਕਰਨ

Cursor IDE

Cursor ਨੂੰ OmniRoute ਕਲਾਇੰਟ ਵਜੋਂ ਵਰਤਣਾ (Cursor ਚੈਟ ਨੂੰ OmniRoute ਰਾਹੀਂ ਰੂਟ ਕਰੋ):

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [OmniRoute ਡੈਸ਼ਬੋਰਡ ਤੋਂ]
  Model: cc/claude-opus-4-7

OmniRoute ਨੂੰ Cursor ਪ੍ਰਦਾਤਾ ਵਜੋਂ ਵਰਤਣਾ (OmniRoute ਅੱਪਸਟ੍ਰੀਮ Cursor ਨੂੰ ਕਾਲ ਕਰਦਾ ਹੈ): ਤਰਜੀਹ ਦਿਓ Dashboard → Providers → Cursor → Login with Cursor। Docker ਵਿੱਚ, docs/providers/CURSOR-DOCKER.md ਵੇਖੋ।

Claude Code

~/.claude/settings.json ਨੂੰ ਸੰਪਾਦਿਤ ਕਰੋ:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "your-omniroute-api-key"
  }
}

ਇੱਥੇ Claude-ਅਨੁਕੂਲ ਰੂਟ ਐਂਡਪੁਆਇੰਟ ਵਰਤੋ। ANTHROPIC_BASE_URL ਦੇ ਅੰਤ ਵਿੱਚ /v1 ਨਾ ਜੋੜੋ।

Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"
codex "your prompt"

OpenClaw

~/.openclaw/openclaw.json ਨੂੰ ਸੰਪਾਦਿਤ ਕਰੋ:

{
  "agents": {
    "defaults": {
      "model": { "primary": "omniroute/if/kimi-k2.7-code" }
    }
  },
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://localhost:20128/v1",
        "apiKey": "your-omniroute-api-key",
        "api": "openai-completions",
        "models": [{ "id": "if/kimi-k2.7-code", "name": "Kimi K2.7 Code" }]
      }
    }
  }
}

ਜਾਂ Dashboard ਵਰਤੋ: CLI Tools → OpenClaw → Auto-config

Cline / Continue / RooCode

ਪ੍ਰਦਾਤਾ: OpenAI Compatible
ਬੇਸ URL: http://localhost:20128/v1
API ਕੁੰਜੀ: [ਡੈਸ਼ਬੋਰਡ ਤੋਂ]
ਮਾਡਲ: cc/claude-opus-4-7

🚀 ਡਿਪਲੌਇਮੈਂਟ

ਗਲੋਬਲ npm ਇੰਸਟਾਲੇਸ਼ਨ (ਸਿਫ਼ਾਰਸ਼ੀ)

npm install -g omniroute

# ਸੰਰਚਨਾ ਡਾਇਰੈਕਟਰੀ ਬਣਾਓ
mkdir -p ~/.omniroute

# .env ਫ਼ਾਈਲ ਬਣਾਓ (.env.example ਵੇਖੋ)
cp .env.example ~/.omniroute/.env

# ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
omniroute
# ਜਾਂ ਕਸਟਮ ਪੋਰਟ ਨਾਲ:
omniroute --port 3000

CLI ਆਪਣੇ-ਆਪ .env ਨੂੰ ~/.omniroute/.env ਜਾਂ ./.env ਤੋਂ ਲੋਡ ਕਰਦਾ ਹੈ।

ਟਰੇ ਮੋਡ

OmniRoute ਨੂੰ ਸਿਸਟਮ ਟਰੇ ਵਿੱਚ ਸ਼ੁਰੂ ਕਰੋ:

omniroute serve --tray

ਸਰਵਰ ਅਤੇ ਟਰੇ ਤਿਆਰ ਹੋਣ ਤੋਂ ਬਾਅਦ ਕਮਾਂਡ ਵਾਪਸ ਆ ਜਾਂਦੀ ਹੈ।

ਸਰਵਰ ਟਰਮੀਨਲ ਤੋਂ ਬਿਨਾਂ ਚੱਲਦਾ ਰਹਿੰਦਾ ਹੈ।

ਟਰੇ ਮੋਡ macOS, Windows ਅਤੇ ਗ੍ਰਾਫ਼ਿਕਲ Linux ਸੈਸ਼ਨਾਂ ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ। ਟਰੇ ਮੋਡ ਡੈਸ਼ਬੋਰਡ ਨੂੰ ਆਪਣੇ-ਆਪ ਨਹੀਂ ਖੋਲ੍ਹਦਾ।

ਇਨ੍ਹਾਂ ਕਾਰਵਾਈਆਂ ਲਈ ਟਰੇ ਮੀਨੂ ਵਰਤੋ:

  • ਡੈਸ਼ਬੋਰਡ ਖੋਲ੍ਹੋ।
  • /dashboard/logs ਖੋਲ੍ਹੋ।
  • ਆਟੋ-ਸਟਾਰਟ ਬਦਲੋ।
  • OmniRoute ਨੂੰ ਰੋਕੋ।

--tray ਨੂੰ ਇਨ੍ਹਾਂ ਵਿਕਲਪਾਂ ਨਾਲ ਇਕੱਠੇ ਨਾ ਵਰਤੋ:

  • --daemon
  • --log
  • --no-recovery

ਇਨ੍ਹਾਂ ਮੋਡਾਂ ਲਈ ਵੱਖਰੀ ਪ੍ਰਕਿਰਿਆ ਮਾਲਕੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।

ਮਸ਼ੀਨ ਵਿੱਚ ਅਗਲੇ ਲੌਗਇਨ ਸਮੇਂ ਸਟਾਰਟਅੱਪ ਸਮਰੱਥ ਕਰੋ:

omniroute autostart enable

ਆਟੋ-ਸਟਾਰਟ macOS, Windows ਅਤੇ ਗ੍ਰਾਫ਼ਿਕਲ Linux ਸੈਸ਼ਨਾਂ ਉੱਤੇ ਟਰੇ ਮੋਡ ਵਰਤਦਾ ਹੈ। ਹੈੱਡਲੈੱਸ Linux ਮੌਜੂਦਾ systemd ਯੂਜ਼ਰ ਸਰਵਿਸ ਵਰਤਦਾ ਹੈ।

ਲੌਗਇਨ ਸਮੇਂ ਸਟਾਰਟਅੱਪ ਨੂੰ ਅਸਮਰੱਥ ਕਰੋ:

omniroute autostart disable

ਅਣਇੰਸਟਾਲ ਕਰਨਾ

ਜਦੋਂ ਤੁਹਾਨੂੰ OmniRoute ਦੀ ਹੋਰ ਲੋੜ ਨਾ ਰਹੇ, ਤਾਂ ਅਸੀਂ ਸਾਫ਼ ਤਰੀਕੇ ਨਾਲ ਹਟਾਉਣ ਲਈ ਦੋ ਤੇਜ਼ ਸਕ੍ਰਿਪਟਾਂ ਦਿੰਦੇ ਹਾਂ:

ਕਮਾਂਡ ਕਾਰਵਾਈ
npm run uninstall ਸਿਸਟਮ ਐਪ ਨੂੰ ਹਟਾਉਂਦੀ ਹੈ, ਪਰ ~/.omniroute ਵਿੱਚ ਤੁਹਾਡਾ DB ਅਤੇ ਸੰਰਚਨਾਵਾਂ ਰੱਖਦੀ ਹੈ
npm run uninstall:full ਐਪ ਨੂੰ ਹਟਾਉਂਦੀ ਹੈ ਅਤੇ ਸਾਰੀਆਂ ਸੰਰਚਨਾਵਾਂ, ਕੁੰਜੀਆਂ ਅਤੇ ਡਾਟਾਬੇਸ ਸਥਾਈ ਤੌਰ ’ਤੇ ਮਿਟਾ ਦਿੰਦੀ ਹੈ

ਨੋਟ: ਇਹ ਕਮਾਂਡਾਂ ਚਲਾਉਣ ਲਈ OmniRoute ਪ੍ਰੋਜੈਕਟ ਫੋਲਡਰ ਵਿੱਚ ਜਾਓ (ਜੇ ਤੁਸੀਂ ਇਸਨੂੰ ਕਲੋਨ ਕੀਤਾ ਸੀ) ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਚਲਾਓ। ਵਿਕਲਪਕ ਤੌਰ ’ਤੇ, ਜੇ ਇਹ ਗਲੋਬਲ ਤੌਰ ’ਤੇ ਇੰਸਟਾਲ ਹੈ, ਤਾਂ ਤੁਸੀਂ ਸਿਰਫ਼ npm uninstall -g omniroute ਚਲਾ ਸਕਦੇ ਹੋ।

VPS ਡਿਪਲੌਇਮੈਂਟ

git clone https://github.com/diegosouzapw/OmniRoute.git
cd OmniRoute && npm install && npm run build

export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/omniroute"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"

npm run start
# ਜਾਂ: pm2 start npm --name omniroute -- start

PM2 ਡਿਪਲੌਇਮੈਂਟ (ਘੱਟ ਮੈਮੋਰੀ)

ਸੀਮਤ RAM ਵਾਲੇ ਸਰਵਰਾਂ ਲਈ ਮੈਮੋਰੀ ਸੀਮਾ ਵਾਲਾ ਵਿਕਲਪ ਵਰਤੋ:

# 512MB ਸੀਮਾ ਨਾਲ (ਡਿਫਾਲਟ)
pm2 start npm --name omniroute -- start

# ਜਾਂ ਕਸਟਮ ਮੈਮੋਰੀ ਸੀਮਾ ਨਾਲ
OMNIROUTE_MEMORY_MB=512 pm2 start npm --name omniroute -- start

# ਜਾਂ ecosystem.config.js ਦੀ ਵਰਤੋਂ ਕਰਕੇ
pm2 start ecosystem.config.js

ecosystem.config.js ਬਣਾਓ:

module.exports = {
  apps: [
    {
      name: "omniroute",
      script: "npm",
      args: "start",
      env: {
        NODE_ENV: "production",
        OMNIROUTE_MEMORY_MB: "512",
        JWT_SECRET: "your-secret",
        INITIAL_PASSWORD: "your-password",
      },
      node_args: "--max-old-space-size=512",
      max_memory_restart: "300M",
    },
  ],
};

Docker

# ਇਮੇਜ ਬਣਾਓ (ਡਿਫਾਲਟ = runner-cli ਜਿਸ ਵਿੱਚ codex/claude/droid ਪਹਿਲਾਂ ਤੋਂ ਇੰਸਟਾਲ ਹਨ)
docker build -t omniroute:cli .

# ਪੋਰਟੇਬਲ ਮੋਡ (ਸਿਫ਼ਾਰਸ਼ੀ)
docker run -d --name omniroute -p 20128:20128 --env-file ./.env -v omniroute-data:/app/data omniroute:cli

CLI ਬਾਈਨਰੀਆਂ ਵਾਲੇ ਹੋਸਟ-ਏਕੀਕ੍ਰਿਤ ਮੋਡ ਲਈ ਮੁੱਖ ਦਸਤਾਵੇਜ਼ਾਂ ਵਿੱਚ Docker ਭਾਗ ਵੇਖੋ।

Void Linux (xbps-src)

Void Linux ਵਰਤੋਂਕਾਰ xbps-src ਕ੍ਰਾਸ-ਕੰਪਾਇਲੇਸ਼ਨ ਫਰੇਮਵਰਕ ਦੀ ਵਰਤੋਂ ਕਰਕੇ OmniRoute ਨੂੰ ਮੂਲ ਰੂਪ ਵਿੱਚ ਪੈਕੇਜ ਅਤੇ ਇੰਸਟਾਲ ਕਰ ਸਕਦੇ ਹਨ। ਇਹ ਲੋੜੀਂਦੀਆਂ better-sqlite3 ਨੇਟਿਵ ਬਾਈਂਡਿੰਗਾਂ ਸਮੇਤ Node.js ਸਟੈਂਡਅਲੋਨ ਬਿਲਡ ਨੂੰ ਸਵੈਚਾਲਿਤ ਕਰਦਾ ਹੈ।

xbps-src ਟੈਂਪਲੇਟ ਵੇਖੋ
# 'omniroute' ਲਈ ਟੈਂਪਲੇਟ ਫ਼ਾਈਲ
pkgname=omniroute
version=3.8.0
revision=1
hostmakedepends="nodejs python3 make"
depends="openssl"
short_desc="Universal AI gateway with smart routing for multiple LLM providers"
maintainer="zenobit <zenobit@disroot.org>"
license="MIT"
homepage="https://github.com/diegosouzapw/OmniRoute"
distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz"
checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b
system_accounts="_omniroute"
omniroute_homedir="/var/lib/omniroute"
export NODE_ENV=production
export npm_config_engine_strict=false
export npm_config_loglevel=error
export npm_config_fund=false
export npm_config_audit=false

do_build() {
	# node-gyp ਲਈ ਟਾਰਗੇਟ CPU ਆਰਕੀਟੈਕਚਰ ਨਿਰਧਾਰਤ ਕਰੋ
	local _gyp_arch
	case "$XBPS_TARGET_MACHINE" in
		aarch64*) _gyp_arch=arm64 ;;
		armv7*|armv6*) _gyp_arch=arm ;;
		i686*) _gyp_arch=ia32 ;;
		*) _gyp_arch=x64 ;;
	esac

	# 1) ਸਾਰੀਆਂ ਡਿਪੈਂਡੈਂਸੀਆਂ ਇੰਸਟਾਲ ਕਰੋ  ਸਕ੍ਰਿਪਟਾਂ ਛੱਡੋ
	NODE_ENV=development npm ci --ignore-scripts

	# 2) Next.js ਸਟੈਂਡਅਲੋਨ ਬੰਡਲ ਬਿਲਡ ਕਰੋ
	npm run build

	# 3) ਸਟੈਟਿਕ ਐਸੈੱਟਾਂ ਨੂੰ ਸਟੈਂਡਅਲੋਨ ਵਿੱਚ ਕਾਪੀ ਕਰੋ
	cp -r .next/static .next/standalone/.next/static
	[ -d public ] && cp -r public .next/standalone/public || true

	# 4) better-sqlite3 ਨੇਟਿਵ ਬਾਈਂਡਿੰਗ ਕੰਪਾਇਲ ਕਰੋ
	local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
	(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

	# 5) ਕੰਪਾਇਲ ਕੀਤੀ ਬਾਈਂਡਿੰਗ ਨੂੰ ਸਟੈਂਡਅਲੋਨ ਬੰਡਲ ਵਿੱਚ ਰੱਖੋ
	local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
	mkdir -p "$_bs3_release"
	cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

	# 6) ਆਰਕੀਟੈਕਚਰ-ਵਿਸ਼ੇਸ਼ sharp ਬੰਡਲ ਹਟਾਓ
	rm -rf .next/standalone/node_modules/@img

	# 7) Next.js ਸਟੈਟਿਕ ਵਿਸ਼ਲੇਸ਼ਣ ਵੱਲੋਂ ਛੱਡੀਆਂ ਗਈਆਂ pino ਰਨਟਾਈਮ ਡਿਪੈਂਡੈਂਸੀਆਂ ਕਾਪੀ ਕਰੋ:
	for _mod in pino-abstract-transport split2 process-warning; do
		cp -r "node_modules/$_mod" .next/standalone/node_modules/
	done
}

do_check() {
	npm run test:unit
}

do_install() {
	vmkdir usr/lib/omniroute/.next
	vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

	# ਪੋਸਟ-ਇੰਸਟਾਲ ਹੁੱਕ ਦੁਆਰਾ ਖ਼ਾਲੀ Next.js ਐਪ ਰਾਊਟਰ ਡਾਇਰੈਕਟਰੀਆਂ ਨੂੰ ਹਟਾਏ ਜਾਣ ਤੋਂ ਰੋਕੋ
	for _d in \
		.next/standalone/.next/server/app/dashboard \
		.next/standalone/.next/server/app/dashboard/settings \
		.next/standalone/.next/server/app/dashboard/providers; do
		touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
	done

	cat > "${WRKDIR}/omniroute" <<'EOF'
#!/bin/sh
export PORT="${PORT:-20128}"
export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}"
export APP_LOG_TO_FILE="${APP_LOG_TO_FILE:-false}"
mkdir -p "${DATA_DIR}"
exec node /usr/lib/omniroute/.next/standalone/server.js "$@"
EOF
	vbin "${WRKDIR}/omniroute"
}

post_install() {
	vlicense LICENSE
}

ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ

ਵੇਰੀਏਬਲ ਡਿਫਾਲਟ ਵੇਰਵਾ
JWT_SECRET omniroute-default-secret-change-me JWT ਸਾਈਨਿੰਗ ਸੀਕ੍ਰੇਟ (ਪ੍ਰੋਡਕਸ਼ਨ ਵਿੱਚ ਬਦਲੋ)
INITIAL_PASSWORD CHANGEME ਪਹਿਲੀ ਵਾਰ ਲੌਗਇਨ ਕਰਨ ਲਈ ਪਾਸਵਰਡ
DATA_DIR ~/.omniroute ਡਾਟਾ ਡਾਇਰੈਕਟਰੀ (ਡੇਟਾਬੇਸ, ਵਰਤੋਂ, ਲੌਗ)
PORT ਫਰੇਮਵਰਕ ਡਿਫਾਲਟ ਸਰਵਿਸ ਪੋਰਟ (ਉਦਾਹਰਨਾਂ ਵਿੱਚ 20128)
HOSTNAME ਫਰੇਮਵਰਕ ਡਿਫਾਲਟ ਬਾਈਂਡ ਹੋਸਟ (Docker ਵਿੱਚ ਡਿਫਾਲਟ 0.0.0.0)
NODE_ENV ਰਨਟਾਈਮ ਡਿਫਾਲਟ ਡਿਪਲੌਇਮੈਂਟ ਲਈ production ਸੈੱਟ ਕਰੋ
NEXT_PUBLIC_BASE_URL http://localhost:20128 ਡੈਸ਼ਬੋਰਡ ਉੱਤੇ ਦਿਖਾਇਆ ਅਤੇ ਸਰਵਰ ਲਈ ਉਪਲਬਧ ਕਰਵਾਇਆ ਜਾਣ ਵਾਲਾ ਪਬਲਿਕ ਬੇਸ URL (ਪੁਰਾਣੇ BASE_URL ਦੀ ਥਾਂ ਲੈਂਦਾ ਹੈ)
NEXT_PUBLIC_CLOUD_URL https://omniroute.dev ਕਲਾਉਡ ਸਿੰਕ ਐਂਡਪੌਇੰਟ ਦਾ ਬੇਸ URL (ਪੁਰਾਣੇ CLOUD_URL ਦੀ ਥਾਂ ਲੈਂਦਾ ਹੈ)
API_KEY_SECRET endpoint-proxy-api-key-secret ਤਿਆਰ ਕੀਤੀਆਂ API ਕੁੰਜੀਆਂ ਲਈ HMAC ਸੀਕ੍ਰੇਟ
REQUIRE_API_KEY false /v1/* ਉੱਤੇ Bearer API ਕੁੰਜੀ ਲਾਜ਼ਮੀ ਕਰੋ
ALLOW_API_KEY_REVEAL false ਪ੍ਰਮਾਣਿਤ ਡੈਸ਼ਬੋਰਡ ਵਰਤੋਂਕਾਰਾਂ ਨੂੰ ਮੰਗ 'ਤੇ ਸਟੋਰ ਕੀਤੀਆਂ API ਕੁੰਜੀਆਂ ਦੇ ਪੂਰੇ ਮੁੱਲ ਦਿਖਾਉਣ ਦੀ ਇਜਾਜ਼ਤ ਦਿਓ
PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES 70 ਕੈਸ਼ ਕੀਤੇ Provider Limits ਡਾਟੇ ਲਈ ਸਰਵਰ-ਸਾਈਡ ਰਿਫ੍ਰੈਸ਼ ਅੰਤਰਾਲ; UI ਰਿਫ੍ਰੈਸ਼ ਬਟਨ ਫਿਰ ਵੀ ਮੈਨੂਅਲ ਸਿੰਕ ਸ਼ੁਰੂ ਕਰਦੇ ਹਨ
DISABLE_SQLITE_AUTO_BACKUP false ਲਿਖਣ/ਇੰਪੋਰਟ/ਰੀਸਟੋਰ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਆਟੋਮੈਟਿਕ SQLite ਸਨੈਪਸ਼ਾਟ ਅਯੋਗ ਕਰੋ; ਮੈਨੂਅਲ ਬੈਕਅੱਪ ਫਿਰ ਵੀ ਕੰਮ ਕਰਦੇ ਹਨ
APP_LOG_TO_FILE true ਐਪਲੀਕੇਸ਼ਨ ਅਤੇ ਆਡਿਟ ਲੌਗ ਆਉਟਪੁੱਟ ਨੂੰ ਡਿਸਕ ਉੱਤੇ ਲਿਖਣਾ ਸਮਰੱਥ ਕਰਦਾ ਹੈ
AUTH_COOKIE_SECURE false Secure ਪ੍ਰਮਾਣੀਕਰਨ ਕੁਕੀ ਲਾਜ਼ਮੀ ਕਰੋ (HTTPS ਰਿਵਰਸ ਪ੍ਰੌਕਸੀ ਦੇ ਪਿੱਛੇ)
CLOUDFLARED_BIN ਸੈੱਟ ਨਹੀਂ ਪ੍ਰਬੰਧਿਤ ਡਾਊਨਲੋਡ ਦੀ ਬਜਾਏ ਮੌਜੂਦਾ cloudflared ਬਾਈਨਰੀ ਵਰਤੋ
CLOUDFLARED_PROTOCOL http2 ਪ੍ਰਬੰਧਿਤ Quick Tunnels ਲਈ ਟ੍ਰਾਂਸਪੋਰਟ (http2, quic, ਜਾਂ auto)
OMNIROUTE_MEMORY_MB 512 MB ਵਿੱਚ Node.js ਹੀਪ ਸੀਮਾ
PROMPT_CACHE_MAX_SIZE 50 ਪ੍ਰੌਮਪਟ ਕੈਸ਼ ਐਂਟਰੀਆਂ ਦੀ ਅਧਿਕਤਮ ਗਿਣਤੀ
SEMANTIC_CACHE_MAX_SIZE 100 ਸਿਮੈਂਟਿਕ ਕੈਸ਼ ਐਂਟਰੀਆਂ ਦੀ ਅਧਿਕਤਮ ਗਿਣਤੀ

ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲਾਂ ਦੇ ਪੂਰੇ ਹਵਾਲੇ ਲਈ, README ਵੇਖੋ।


📊 ਉਪਲਬਧ ਮਾਡਲ

ਸਾਰੇ ਉਪਲਬਧ ਮਾਡਲ ਵੇਖੋ

ਹੇਠਾਂ ਦਿੱਤੀ ਸੂਚੀ v3.8.0 ਲਈ open-sse/config/providerRegistry.ts ਤੋਂ ਚੁਣੀ ਗਈ ਹੈ। ਕਲਾਉਡ ਕੈਟਾਲਾਗ (Gemini, OpenRouter ਆਦਿ) ਡਾਇਨਾਮਿਕ ਤੌਰ 'ਤੇ ਸਿੰਕ ਹੁੰਦੇ ਹਨ — ਪੂਰੇ ਲਾਈਵ ਕੈਟਾਲਾਗ ਲਈ Dashboard → Providers → [provider] → Available Models ਖੋਲ੍ਹੋ ਜਾਂ GET /api/models/catalog ਕਾਲ ਕਰੋ।

ਜੇ ਕਿਸੇ ਪ੍ਰਦਾਤਾ ਦੀ ਬਿਲਟ-ਇਨ ਸੂਚੀ ਪੁਰਾਣੀ ਹੋ ਗਈ ਹੈ, ਤਾਂ ਲਾਈਵ ਅੱਪਸਟ੍ਰੀਮ ਕੈਟਾਲਾਗ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਉਸ ਪੰਨੇ 'ਤੇ Import from /models ਵਰਤੋ (ਜਾਂ Auto-Sync ਸਮਰੱਥ ਕਰੋ)। ਇਸਦੀ ਪੁਸ਼ਟੀ v3.8.50 ਵਿੱਚ LLM7.io (gemini-3.1-flash-lite) ਅਤੇ UncloseAI (solidrust/Hermes-3-Llama-3.1-8B-AWQ) ਲਈ ਕੀਤੀ ਗਈ ਸੀ; ਉਸੇ ਟੈਸਟ ਦੌਰਾਨ Pollinations ਦੀ ਅਗਿਆਤ ਪਹੁੰਚ ਅੱਪਸਟ੍ਰੀਮ ਵੱਲੋਂ ਸੀਮਿਤ ਰਹੀ।

Claude Code (cc/) — Pro/Max OAuth: cc/claude-opus-4-8, cc/claude-opus-4-7, cc/claude-opus-4-6, cc/claude-opus-4-5-20251101, cc/claude-sonnet-4-6, cc/claude-sonnet-4-5-20250929, cc/claude-haiku-4-5-20251001

Codex (cx/) — Plus/Pro OAuth: cx/gpt-5.5 (+ ਯਤਨ ਪੱਧਰ: gpt-5.5-xhigh, gpt-5.5-high, gpt-5.5-medium, gpt-5.5-low), cx/gpt-5.4, cx/gpt-5.4-mini, cx/gpt-5.3-codex, cx/gpt-5.3-codex-spark

GitHub Copilot (gh/) — OAuth: gh/gpt-5.5, gh/gpt-5.4, gh/gpt-5.4-mini, gh/gpt-5-mini, gh/gpt-5.3-codex, gh/claude-opus-4.7, gh/claude-opus-4.6, gh/claude-opus-4-5-20251101, gh/claude-sonnet-4.6, gh/claude-sonnet-4.5, gh/claude-haiku-4.5, gh/gemini-3.1-pro-preview, gh/gemini-3-flash-preview, gh/oswe-vscode-prime

Kiro (kr/) — ਮੁਫ਼ਤ OAuth: Dashboard → Providers → Kiro → Available Models ਅਧੀਨ ਦਿਖਾਇਆ ਗਿਆ ਲਾਈਵ ਕੈਟਾਲਾਗ ਵਰਤੋ। ਉਪਲਬਧਤਾ ਖਾਤੇ ਅਤੇ ਪਲਾਨ 'ਤੇ ਨਿਰਭਰ ਕਰਦੀ ਹੈ।

Qoder (if/) — ਮੁਫ਼ਤ OAuth: if/qwen3.8-max-preview, if/qwen3.7-max, if/qwen3.7-plus, if/kimi-k3, if/kimi-k2.7-code, if/glm-5.2, if/deepseek-v4-pro, if/deepseek-v4-flash, if/minimax-m3

GLM (glm/, glm-cn/, zai/, glmt/) — $0.20.6/1M: glm/glm-5.1, glm/glm-5, glm/glm-5-turbo, glm/glm-4.7, glm/glm-4.7-flash, glm/glm-4.6, glm/glm-4.6v, glm/glm-4.5, glm/glm-4.5v, glm/glm-4.5-air

MiniMax (minimax/, minimax-cn/) — $0.2/1M: minimax/MiniMax-M2.7, minimax/MiniMax-M2.7-highspeed, minimax/MiniMax-M2.5, minimax/MiniMax-M2.5-highspeed

Kimi (kimi/, kimi-coding/, kimi-coding-apikey/) — $9/ਮਹੀਨਾ ਫਲੈਟ ਜਾਂ ਪ੍ਰਤੀ-ਵਰਤੋਂ: kimi/kimi-k2.6, kimi/kimi-k2.5

DeepSeek (ds/) — API ਕੁੰਜੀ: ds/deepseek-v4-pro, ds/deepseek-v4-flash

Groq (groq/) — ਅਤਿ-ਤੇਜ਼: groq/llama-3.3-70b-versatile, groq/meta-llama/llama-4-maverick-17b-128e-instruct, groq/qwen/qwen3-32b, groq/openai/gpt-oss-120b

xAI (xai/) — ਮੂਲ Grok: xai/grok-4.3, xai/grok-4.20-multi-agent-0309, xai/grok-4.20-0309-reasoning, xai/grok-4.20-0309-non-reasoning

Mistral (mistral/) — EU ਵਿੱਚ ਹੋਸਟ ਕੀਤਾ: mistral/mistral-large-latest, mistral/mistral-medium-3-5, mistral/mistral-small-latest, mistral/devstral-latest, mistral/codestral-latest

Perplexity (pplx/) — ਖੋਜ-ਵਿਸਤਾਰਿਤ: pplx/sonar-deep-research, pplx/sonar-reasoning-pro, pplx/sonar-pro, pplx/sonar

Together AI (together/) — ਓਪਨ-ਸੋਰਸ: together/meta-llama/Llama-3.3-70B-Instruct-Turbo-Free (ਮੁਫ਼ਤ), together/meta-llama/Llama-Vision-Free, together/deepseek-ai/DeepSeek-R1-Distill-Llama-70B-Free, together/deepseek-ai/DeepSeek-R1, together/Qwen/Qwen3-235B-A22B, together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8

Fireworks AI (fireworks/) — ਤੇਜ਼ ਇਨਫ਼ਰੈਂਸ: fireworks/accounts/fireworks/models/kimi-k2p6, fireworks/accounts/fireworks/models/minimax-m2p7, fireworks/accounts/fireworks/models/qwen3p6-plus, fireworks/accounts/fireworks/models/glm-5p1, fireworks/accounts/fireworks/models/deepseek-v4-pro

Cerebras (cerebras/) — ਵੇਫ਼ਰ-ਸਕੇਲ: cerebras/zai-glm-4.7, cerebras/gpt-oss-120b

Cohere (cohere/) — RAG-ਕੇਂਦਰਿਤ: cohere/command-a-reasoning-08-2025, cohere/command-a-vision-07-2025, cohere/command-a-03-2025, cohere/command-r-08-2024

NVIDIA NIM (nvidia/) — ਐਂਟਰਪ੍ਰਾਈਜ਼: nvidia/z-ai/glm-5.1, nvidia/minimaxai/minimax-m2.7, nvidia/google/gemma-4-31b-it, nvidia/mistralai/mistral-small-4-119b-2603, nvidia/mistralai/mistral-large-3-675b-instruct-2512, nvidia/qwen/qwen3.5-397b-a17b, nvidia/deepseek-ai/deepseek-v4-pro, nvidia/openai/gpt-oss-120b, nvidia/nvidia/nemotron-3-super-120b-a12b

Baidu Qianfan (qianfan/) — ERNIE: qianfan/ernie-5.1, qianfan/ernie-5.0-thinking-latest, qianfan/ernie-x1.1

Ollama Cloud (ollama-cloud/): ollama-cloud/deepseek-v4-pro, ollama-cloud/deepseek-v4-flash, ollama-cloud/kimi-k2.6, ollama-cloud/glm-5.1, ollama-cloud/minimax-m2.7, ollama-cloud/gemma4:31b, ollama-cloud/qwen3.5:397b

Gemini (Google Cloud gemini/): Google ਤੋਂ ਹਰ API ਕੁੰਜੀ ਮੁਤਾਬਕ ਲਾਈਵ ਸਿੰਕ ਕੀਤਾ ਜਾਂਦਾ ਹੈ — ਕੋਈ ਸਥਿਰ ਸੂਚੀ ਨਹੀਂ। Dashboard → Providers ਵਿੱਚ ਇੱਕ ਕੁੰਜੀ ਕਨੈਕਟ ਕਰੋ, ਫਿਰ ਮੌਜੂਦਾ ਕੈਟਾਲਾਗ ਇੰਪੋਰਟ ਕਰਨ ਲਈ Available Models ਵਰਤੋ (ਉਦਾਹਰਨ ਲਈ gemini/gemini-3-pro, gemini/gemini-3-flash)।

ਹੋਰ ਅਨੁਕੂਲ ਪ੍ਰਦਾਤਾ (ਚੁਣੇ ਹੋਏ): cohere, databricks, snowflake, together, vertex, alibaba, alibaba-cn, bedrock (aws-bedrock ਰਾਹੀਂ), azure-ai, openrouter (ਪਾਸਥਰੂ ਕੈਟਾਲਾਗ), siliconflow, hyperbolic, huggingface, featherless-ai, cloudflare-ai, scaleway, deepinfra, vercel-ai-gateway, bazaarlink, friendliai, nous-research, reka, volcengine, ai21, gigachat। ਹਰ ਇੱਕ providerRegistry.ts ਵਿੱਚ ਆਪਣੀ ਮਾਡਲ ਸੂਚੀ ਰੱਖਦਾ ਹੈ ਅਤੇ ਜਦੋਂ ਪ੍ਰਦਾਤਾ /models ਐਂਡਪੌਇੰਟ ਉਪਲਬਧ ਕਰਦਾ ਹੈ ਤਾਂ ਇਸਨੂੰ ਆਟੋਮੈਟਿਕ ਤੌਰ 'ਤੇ ਸਿੰਕ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।

ਮਾਡਲ IDs ਬਾਰੇ ਨੋਟ: OmniRoute ਪ੍ਰਦਾਤਾ-ਮੂਲ IDs (claude-opus-4-8, gpt-5.5, glm-5.1, MiniMax-M2.7, kimi-k2.5, grok-4.20-0309-reasoning) ਵਰਤਦਾ ਹੈ। ਕੁਝ IDs ਵਿੱਚ ਬਿੰਦੀਆਂ ਵਾਲੇ ਵਰਜਨ ਸ਼ਾਮਲ ਹਨ, ਕਿਉਂਕਿ ਅੱਪਸਟ੍ਰੀਮ API ਉਨ੍ਹਾਂ ਨੂੰ ਇਸੇ ਤਰ੍ਹਾਂ ਉਮੀਦ ਕਰਦੀ ਹੈ। ਜੇ ਕੋਈ ਮਾਡਲ ਉੱਪਰ ਸੂਚੀਬੱਧ ਨਹੀਂ ਹੈ, ਤਾਂ ਉਪਲਬਧਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ omniroute models --search <term> ਚਲਾਓ ਜਾਂ GET /api/models/catalog ਨੂੰ ਹਿੱਟ ਕਰੋ।


🧩 ਉੱਨਤ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਕਸਟਮ ਮਾਡਲ

ਐਪ ਅੱਪਡੇਟ ਦੀ ਉਡੀਕ ਕੀਤੇ ਬਿਨਾਂ ਕਿਸੇ ਵੀ ਪ੍ਰੋਵਾਈਡਰ ਵਿੱਚ ਕੋਈ ਵੀ ਮਾਡਲ ID ਸ਼ਾਮਲ ਕਰੋ:

# API ਰਾਹੀਂ
curl -X POST http://localhost:20128/api/provider-models \
  -H "Content-Type: application/json" \
  -d '{"provider": "openai", "modelId": "gpt-5.2", "modelName": "GPT-5.2"}'

# ਸੂਚੀ: curl http://localhost:20128/api/provider-models?provider=openai
# ਹਟਾਓ: curl -X DELETE "http://localhost:20128/api/provider-models?provider=openai&model=gpt-5.2"

ਜਾਂ ਡੈਸ਼ਬੋਰਡ ਵਰਤੋ: ਪ੍ਰੋਵਾਈਡਰ → [ਪ੍ਰੋਵਾਈਡਰ] → ਕਸਟਮ ਮਾਡਲ

ਨੋਟ:

  • OpenRouter ਅਤੇ OpenAI/Anthropic-ਅਨੁਕੂਲ ਪ੍ਰੋਵਾਈਡਰ ਸਿਰਫ਼ ਉਪਲਬਧ ਮਾਡਲ ਤੋਂ ਪ੍ਰਬੰਧਿਤ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਹੱਥੀਂ ਜੋੜਨਾ, ਇੰਪੋਰਟ ਅਤੇ ਆਟੋ-ਸਿੰਕ—ਸਾਰੇ ਇੱਕੋ ਉਪਲਬਧ-ਮਾਡਲ ਸੂਚੀ ਵਿੱਚ ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ, ਇਸ ਲਈ ਉਨ੍ਹਾਂ ਪ੍ਰੋਵਾਈਡਰਾਂ ਲਈ ਵੱਖਰਾ ਕਸਟਮ ਮਾਡਲ ਭਾਗ ਨਹੀਂ ਹੈ।
  • ਕਸਟਮ ਮਾਡਲ ਭਾਗ ਉਨ੍ਹਾਂ ਪ੍ਰੋਵਾਈਡਰਾਂ ਲਈ ਹੈ ਜੋ ਪ੍ਰਬੰਧਿਤ ਉਪਲਬਧ-ਮਾਡਲ ਇੰਪੋਰਟ ਉਪਲਬਧ ਨਹੀਂ ਕਰਵਾਉਂਦੇ।

OmniRoute ਪੀਅਰਾਂ ਦੀ ਚੇਨ ਬਣਾਉਣਾ

ਇੱਕ ਹੋਰ OmniRoute ਗੇਟਵੇ ਨੂੰ ਕਸਟਮ OpenAI-ਅਨੁਕੂਲ ਪ੍ਰੋਵਾਈਡਰ ਵਜੋਂ ਜੋੜਿਆ ਜਾ ਸਕਦਾ ਹੈ। ਪੀਅਰ ਦਾ /v1 ਬੇਸ URL ਅਤੇ ਉਸ ਪੀਅਰ ਵੱਲੋਂ ਜਾਰੀ ਕੀਤੀ ਇੱਕ ਸਮਰਪਿਤ, ਘੱਟੋ-ਘੱਟ ਅਧਿਕਾਰਾਂ ਵਾਲੀ API ਕੁੰਜੀ ਵਰਤੋ।

ਪਰਸਪਰ ਜਾਂ ਮਲਟੀ-ਹੌਪ ਚੇਨਾਂ ਲਈ, ਹਰ ਗੇਟਵੇ ਉੱਤੇ ਆਪਟ-ਇਨ ਲੂਪ ਗਾਰਡ ਸਮਰੱਥ ਕਰੋ:

# gateway-a
OMNIROUTE_INSTANCE_ID=gateway-a
OMNIROUTE_PEER_URLS=http://gateway-b:20128/v1
OMNIROUTE_PEER_MAX_HOPS=4
# gateway-b
OMNIROUTE_INSTANCE_ID=gateway-b
OMNIROUTE_PEER_URLS=http://gateway-a:20128/v1
OMNIROUTE_PEER_MAX_HOPS=4

ਸਿਰਫ਼ ਸਪਸ਼ਟ ਤੌਰ 'ਤੇ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਸੂਚੀ ਵਿੱਚ ਸ਼ਾਮਲ ਪੀਅਰ URL ਨੂੰ ਭੇਜੀਆਂ ਬੇਨਤੀਆਂ ਨੂੰ ਹੀ X-OmniRoute-Peer-Trace ਹੈਡਰ ਮਿਲਦਾ ਹੈ। ਗੇਟਵੇ ਦੁਹਰਾਈ ਗਈ ਇੰਸਟੈਂਸ ID ਜਾਂ ਸਮਾਪਤ ਹੋ ਚੁੱਕੇ ਹੌਪ ਬਜਟ ਨੂੰ HTTP 508 Loop Detected ਨਾਲ ਅਸਵੀਕਾਰ ਕਰਦਾ ਹੈ; ਆਮ ਅੱਪਸਟ੍ਰੀਮ ਪ੍ਰੋਵਾਈਡਰਾਂ ਨੂੰ ਕੋਈ ਪੀਅਰ ਮੈਟਾਡਾਟਾ ਨਹੀਂ ਮਿਲਦਾ।

ਪੀਅਰ ਚੇਨਿੰਗ ਡਾਟਾਬੇਸ ਰੈਪਲੀਕੇਸ਼ਨ ਜਾਂ ਹੋਸਟ ਫੇਲਓਵਰ ਨਹੀਂ ਹੈ। ਹਰ ਗੇਟਵੇ ਆਪਣੀ ਸੁਤੰਤਰ SQLite ਸਥਿਤੀ, ਕੈਸ਼, ਰੇਟ ਕਾਊਂਟਰ ਅਤੇ ਸੈਸ਼ਨ ਰੱਖਦਾ ਹੈ। ਐਕਟਿਵ/ਪੈਸਿਵ ਜਾਂ ਐਕਟਿਵ/ਐਕਟਿਵ ਉਪਲਬਧਤਾ ਲਈ ਹੈਲਥ-ਚੈੱਕ ਵਾਲਾ ਰਿਵਰਸ ਪ੍ਰਾਕਸੀ ਜਾਂ ਕਲਾਇੰਟ ਫੇਲਓਵਰ ਵਰਤੋ, ਅਤੇ ਇੱਕ SQLite ਡਾਟਾਬੇਸ ਨੂੰ ਕਦੇ ਵੀ ਕਈ ਚੱਲ ਰਹੀਆਂ OmniRoute ਇੰਸਟੈਂਸਾਂ ਵਿੱਚ ਮਾਊਂਟ ਨਾ ਕਰੋ।

ਸਮਰਪਿਤ ਪ੍ਰੋਵਾਈਡਰ ਰੂਟ

ਮਾਡਲ ਪ੍ਰਮਾਣਿਕਤਾ ਨਾਲ ਬੇਨਤੀਆਂ ਨੂੰ ਸਿੱਧੇ ਕਿਸੇ ਖਾਸ ਪ੍ਰੋਵਾਈਡਰ ਵੱਲ ਰੂਟ ਕਰੋ:

POST http://localhost:20128/v1/providers/openai/chat/completions
POST http://localhost:20128/v1/providers/openai/embeddings
POST http://localhost:20128/v1/providers/fireworks/images/generations

ਜੇ ਪ੍ਰੋਵਾਈਡਰ ਪ੍ਰੀਫਿਕਸ ਮੌਜੂਦ ਨਾ ਹੋਵੇ, ਤਾਂ ਇਹ ਆਪਣੇ ਆਪ ਜੋੜਿਆ ਜਾਂਦਾ ਹੈ। ਮੇਲ ਨਾ ਖਾਣ ਵਾਲੇ ਮਾਡਲ 400 ਵਾਪਸ ਕਰਦੇ ਹਨ।

ਨੈੱਟਵਰਕ ਪ੍ਰਾਕਸੀ ਸੰਰਚਨਾ

# ਗਲੋਬਲ ਪ੍ਰਾਕਸੀ ਸੈੱਟ ਕਰੋ
curl -X PUT http://localhost:20128/api/settings/proxy \
  -d '{"global": {"type":"http","host":"proxy.example.com","port":"8080"}}'

# ਪ੍ਰਤੀ-ਪ੍ਰੋਵਾਈਡਰ ਪ੍ਰਾਕਸੀ
curl -X PUT http://localhost:20128/api/settings/proxy \
  -d '{"providers": {"openai": {"type":"socks5","host":"proxy.example.com","port":"1080"}}}'

# ਪ੍ਰਾਕਸੀ ਦੀ ਜਾਂਚ ਕਰੋ
curl -X POST http://localhost:20128/api/settings/proxy/test \
  -d '{"proxy":{"type":"socks5","host":"proxy.example.com","port":"1080"}}'

ਤਰਜੀਹ: ਕੁੰਜੀ-ਵਿਸ਼ੇਸ਼ → ਕੌਂਬੋ-ਵਿਸ਼ੇਸ਼ → ਪ੍ਰੋਵਾਈਡਰ-ਵਿਸ਼ੇਸ਼ → ਗਲੋਬਲ → ਵਾਤਾਵਰਣ।

ਮਾਡਲ ਕੈਟਾਲੌਗ API

curl http://localhost:20128/api/models/catalog

ਕਿਸਮਾਂ (chat, embedding, image) ਸਮੇਤ ਪ੍ਰੋਵਾਈਡਰ ਅਨੁਸਾਰ ਸਮੂਹਬੱਧ ਮਾਡਲ ਵਾਪਸ ਕਰਦਾ ਹੈ।

ਕਲਾਉਡ ਸਿੰਕ

  • ਪ੍ਰੋਵਾਈਡਰਾਂ, ਕੌਂਬੋਜ਼ ਅਤੇ ਸੈਟਿੰਗਾਂ ਨੂੰ ਡਿਵਾਈਸਾਂ ਵਿੱਚ ਸਿੰਕ ਕਰੋ
  • ਟਾਈਮਆਉਟ + ਫੇਲ-ਫਾਸਟ ਨਾਲ ਆਟੋਮੈਟਿਕ ਬੈਕਗ੍ਰਾਊਂਡ ਸਿੰਕ
  • ਪ੍ਰੋਡਕਸ਼ਨ ਵਿੱਚ ਸਰਵਰ-ਸਾਈਡ NEXT_PUBLIC_BASE_URL/NEXT_PUBLIC_CLOUD_URL ਨੂੰ ਤਰਜੀਹ ਦਿਓ

Cloudflare ਕਵਿਕ ਟਨਲ

  • Docker ਅਤੇ ਹੋਰ ਸਵੈ-ਹੋਸਟਡ ਡਿਪਲੌਇਮੈਂਟਾਂ ਲਈ ਡੈਸ਼ਬੋਰਡ → ਐਂਡਪੌਇੰਟਸ ਵਿੱਚ ਉਪਲਬਧ
  • ਇੱਕ ਅਸਥਾਈ https://*.trycloudflare.com URL ਬਣਾਉਂਦਾ ਹੈ, ਜੋ ਤੁਹਾਡੇ ਮੌਜੂਦਾ OpenAI-ਅਨੁਕੂਲ /v1 ਐਂਡਪੌਇੰਟ ਵੱਲ ਫਾਰਵਰਡ ਕਰਦਾ ਹੈ
  • ਪਹਿਲੀ ਵਾਰ ਸਮਰੱਥ ਕਰਨ 'ਤੇ ਸਿਰਫ਼ ਲੋੜ ਪੈਣ ਵੇਲੇ cloudflared ਇੰਸਟਾਲ ਹੁੰਦਾ ਹੈ; ਬਾਅਦ ਦੇ ਰੀਸਟਾਰਟ ਉਸੇ ਪ੍ਰਬੰਧਿਤ ਬਾਈਨਰੀ ਨੂੰ ਮੁੜ ਵਰਤਦੇ ਹਨ
  • OmniRoute ਜਾਂ ਕੰਟੇਨਰ ਰੀਸਟਾਰਟ ਹੋਣ ਤੋਂ ਬਾਅਦ ਕਵਿਕ ਟਨਲ ਆਪਣੇ ਆਪ ਮੁੜ-ਸਥਾਪਿਤ ਨਹੀਂ ਹੁੰਦੇ; ਲੋੜ ਪੈਣ 'ਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਡੈਸ਼ਬੋਰਡ ਤੋਂ ਮੁੜ ਸਮਰੱਥ ਕਰੋ
  • ਟਨਲ URL ਅਸਥਾਈ ਹੁੰਦੇ ਹਨ ਅਤੇ ਹਰ ਵਾਰ ਟਨਲ ਨੂੰ ਰੋਕਣ/ਸ਼ੁਰੂ ਕਰਨ 'ਤੇ ਬਦਲ ਜਾਂਦੇ ਹਨ
  • ਸੀਮਤ ਕੰਟੇਨਰਾਂ ਵਿੱਚ ਸ਼ੋਰ ਵਾਲੀਆਂ QUIC UDP ਬਫ਼ਰ ਚੇਤਾਵਨੀਆਂ ਤੋਂ ਬਚਣ ਲਈ ਪ੍ਰਬੰਧਿਤ ਕਵਿਕ ਟਨਲ ਮੂਲ ਰੂਪ ਵਿੱਚ HTTP/2 ਟ੍ਰਾਂਸਪੋਰਟ ਵਰਤਦੇ ਹਨ
  • ਜੇ ਤੁਸੀਂ ਪ੍ਰਬੰਧਿਤ ਟ੍ਰਾਂਸਪੋਰਟ ਚੋਣ ਨੂੰ ਓਵਰਰਾਈਡ ਕਰਨਾ ਚਾਹੁੰਦੇ ਹੋ, ਤਾਂ CLOUDFLARED_PROTOCOL=quic ਜਾਂ auto ਸੈੱਟ ਕਰੋ
  • ਜੇ ਤੁਸੀਂ ਪ੍ਰਬੰਧਿਤ ਡਾਊਨਲੋਡ ਦੀ ਬਜਾਏ ਪਹਿਲਾਂ ਤੋਂ ਇੰਸਟਾਲ ਕੀਤੀ cloudflared ਬਾਈਨਰੀ ਵਰਤਣਾ ਪਸੰਦ ਕਰਦੇ ਹੋ, ਤਾਂ CLOUDFLARED_BIN ਸੈੱਟ ਕਰੋ
  • Cloudflare ਕਵਿਕ ਟਨਲ, Tailscale Funnel ਅਤੇ ngrok Tunnel ਪੈਨਲਾਂ ਨੂੰ ਸੈਟਿੰਗਾਂ → ਦਿੱਖ ਵਿੱਚ ਦਿਖਾਇਆ ਜਾਂ ਲੁਕਾਇਆ ਜਾ ਸਕਦਾ ਹੈ। ਕਿਸੇ ਪੈਨਲ ਨੂੰ ਲੁਕਾਉਣ ਨਾਲ ਚੱਲ ਰਹੀ ਟਨਲ ਬੰਦ ਨਹੀਂ ਹੁੰਦੀ।

LLM ਗੇਟਵੇ ਇੰਟੈਲੀਜੈਂਸ (ਪੜਾਅ 9)

  • ਸੈਮੈਂਟਿਕ ਕੈਸ਼ — ਗੈਰ-ਸਟ੍ਰੀਮਿੰਗ, temperature=0 ਜਵਾਬਾਂ ਨੂੰ ਆਪਣੇ ਆਪ ਕੈਸ਼ ਕਰਦਾ ਹੈ (X-OmniRoute-No-Cache: true ਨਾਲ ਬਾਈਪਾਸ ਕਰੋ)
  • ਬੇਨਤੀ ਆਈਡੈਂਪੋਟੈਂਸੀIdempotency-Key ਜਾਂ X-Request-Id ਹੈਡਰ ਰਾਹੀਂ 5s ਦੇ ਅੰਦਰ ਬੇਨਤੀਆਂ ਦੇ ਡੁਪਲੀਕੇਟ ਹਟਾਉਂਦੀ ਹੈ
  • ਪ੍ਰਗਤੀ ਟ੍ਰੈਕਿੰਗX-OmniRoute-Progress: true ਹੈਡਰ ਰਾਹੀਂ ਆਪਟ-ਇਨ SSE event: progress ਇਵੈਂਟ

ਅਨੁਵਾਦਕ ਪਲੇਗ੍ਰਾਊਂਡ

ਡੈਸ਼ਬੋਰਡ → ਅਨੁਵਾਦਕ ਰਾਹੀਂ ਪਹੁੰਚੋ। ਡੀਬੱਗ ਕਰੋ ਅਤੇ ਦ੍ਰਿਸ਼ਟੀਗਤ ਢੰਗ ਨਾਲ ਵੇਖੋ ਕਿ OmniRoute ਪ੍ਰੋਵਾਈਡਰਾਂ ਵਿਚਕਾਰ API ਬੇਨਤੀਆਂ ਦਾ ਅਨੁਵਾਦ ਕਿਵੇਂ ਕਰਦਾ ਹੈ।

ਮੋਡ ਉਦੇਸ਼
ਪਲੇਗ੍ਰਾਊਂਡ ਸਰੋਤ/ਟੀਚਾ ਫਾਰਮੈਟ ਚੁਣੋ, ਬੇਨਤੀ ਪੇਸਟ ਕਰੋ ਅਤੇ ਅਨੁਵਾਦਿਤ ਆਉਟਪੁੱਟ ਤੁਰੰਤ ਵੇਖੋ
ਚੈਟ ਟੈਸਟਰ ਪ੍ਰਾਕਸੀ ਰਾਹੀਂ ਲਾਈਵ ਚੈਟ ਸੁਨੇਹੇ ਭੇਜੋ ਅਤੇ ਪੂਰੇ ਬੇਨਤੀ/ਜਵਾਬ ਚੱਕਰ ਦੀ ਜਾਂਚ ਕਰੋ
ਟੈਸਟ ਬੈਂਚ ਅਨੁਵਾਦ ਦੀ ਸ਼ੁੱਧਤਾ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ ਕਈ ਫਾਰਮੈਟ ਸੰਯੋਜਨਾਂ ਵਿੱਚ ਬੈਚ ਟੈਸਟ ਚਲਾਓ
ਲਾਈਵ ਮਾਨੀਟਰ ਜਦੋਂ ਬੇਨਤੀਆਂ ਪ੍ਰਾਕਸੀ ਵਿੱਚੋਂ ਲੰਘਦੀਆਂ ਹਨ, ਤਾਂ ਰੀਅਲ-ਟਾਈਮ ਅਨੁਵਾਦ ਵੇਖੋ

ਵਰਤੋਂ ਦੇ ਮਾਮਲੇ:

  • ਡੀਬੱਗ ਕਰੋ ਕਿ ਕੋਈ ਖਾਸ ਕਲਾਇੰਟ/ਪ੍ਰੋਵਾਈਡਰ ਸੰਯੋਜਨ ਕਿਉਂ ਅਸਫਲ ਹੁੰਦਾ ਹੈ
  • ਪੁਸ਼ਟੀ ਕਰੋ ਕਿ ਥਿੰਕਿੰਗ ਟੈਗ, ਟੂਲ ਕਾਲਾਂ ਅਤੇ ਸਿਸਟਮ ਪ੍ਰੌਂਪਟ ਸਹੀ ਤਰ੍ਹਾਂ ਅਨੁਵਾਦ ਹੁੰਦੇ ਹਨ
  • OpenAI, Claude, Gemini ਅਤੇ Responses API ਫਾਰਮੈਟਾਂ ਵਿਚਕਾਰ ਫਾਰਮੈਟ ਅੰਤਰਾਂ ਦੀ ਤੁਲਨਾ ਕਰੋ

ਰੂਟਿੰਗ ਰਣਨੀਤੀਆਂ

Dashboard → Settings → Routing ਰਾਹੀਂ ਸੰਰਚਨਾ ਕਰੋ। ਡੈਸ਼ਬੋਰਡ ਸਭ ਤੋਂ ਵੱਧ ਵਰਤੀਆਂ ਜਾਣ ਵਾਲੀਆਂ ਛੇ ਰਣਨੀਤੀਆਂ ਦਿਖਾਉਂਦਾ ਹੈ; ਕੌਂਬੋ ਅਤੇ ਆਟੋ-ਰਾਊਟਰ ਅੰਦਰੂਨੀ ਤੌਰ 'ਤੇ ਹੋਰ ਵਿਆਪਕ ਸਮੂਹ ਦਾ ਸਮਰਥਨ ਕਰਦੇ ਹਨ।

ਡੈਸ਼ਬੋਰਡ 'ਤੇ ਦਿਖਾਈ ਦੇਣ ਵਾਲੀਆਂ ਰਣਨੀਤੀਆਂ (ਖਾਤਾ-ਪੱਧਰੀ ਰਾਊਟਿੰਗ):

ਰਣਨੀਤੀ ਵੇਰਵਾ
ਪਹਿਲਾਂ ਭਰੋ ਖਾਤਿਆਂ ਨੂੰ ਤਰਜੀਹੀ ਕ੍ਰਮ ਵਿੱਚ ਵਰਤਦਾ ਹੈ — ਮੁੱਖ ਖਾਤਾ ਉਪਲਬਧ ਨਾ ਰਹਿਣ ਤੱਕ ਸਾਰੀਆਂ ਬੇਨਤੀਆਂ ਸੰਭਾਲਦਾ ਹੈ
ਰਾਊਂਡ ਰੌਬਿਨ ਸੰਰਚਨਾਯੋਗ ਸਟਿੱਕੀ ਸੀਮਾ ਨਾਲ ਸਾਰੇ ਖਾਤਿਆਂ ਨੂੰ ਵਾਰੀ-ਵਾਰੀ ਵਰਤਦਾ ਹੈ (ਮੂਲ: ਪ੍ਰਤੀ ਖਾਤਾ 3 ਕਾਲਾਂ)
P2C (ਦੋ ਚੋਣਾਂ ਦੀ ਸ਼ਕਤੀ) 2 ਬੇਤਰਤੀਬ ਖਾਤੇ ਚੁਣਦਾ ਹੈ ਅਤੇ ਵਧੇਰੇ ਸਿਹਤਮੰਦ ਖਾਤੇ ਵੱਲ ਰਾਊਟ ਕਰਦਾ ਹੈ — ਸਿਹਤ ਨੂੰ ਧਿਆਨ ਵਿੱਚ ਰੱਖਦਿਆਂ ਲੋਡ ਸੰਤੁਲਿਤ ਕਰਦਾ ਹੈ
ਬੇਤਰਤੀਬ Fisher-Yates ਸ਼ਫ਼ਲ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਹਰੇਕ ਬੇਨਤੀ ਲਈ ਬੇਤਰਤੀਬ ਢੰਗ ਨਾਲ ਇੱਕ ਖਾਤਾ ਚੁਣਦਾ ਹੈ
ਸਭ ਤੋਂ ਘੱਟ ਵਰਤਿਆ ਸਭ ਤੋਂ ਪੁਰਾਣੇ lastUsedAt ਟਾਈਮਸਟੈਂਪ ਵਾਲੇ ਖਾਤੇ ਵੱਲ ਰਾਊਟ ਕਰਦਾ ਹੈ, ਜਿਸ ਨਾਲ ਟ੍ਰੈਫ਼ਿਕ ਸਮਾਨ ਰੂਪ ਵਿੱਚ ਵੰਡਿਆ ਜਾਂਦਾ ਹੈ
ਲਾਗਤ ਅਨੁਕੂਲਿਤ ਸਭ ਤੋਂ ਘੱਟ ਤਰਜੀਹ ਮੁੱਲ ਵਾਲੇ ਖਾਤੇ ਵੱਲ ਰਾਊਟ ਕਰਦਾ ਹੈ, ਜਿਸ ਨਾਲ ਸਭ ਤੋਂ ਘੱਟ ਲਾਗਤ ਵਾਲੇ ਪ੍ਰਦਾਤਾਵਾਂ ਲਈ ਅਨੁਕੂਲਨ ਹੁੰਦਾ ਹੈ

ਉੱਨਤ ਕੌਂਬੋ ਅਤੇ ਆਟੋ ਰਣਨੀਤੀਆਂ (ਹਰੇਕ ਕੌਂਬੋ ਲਈ ਜਾਂ auto/* ਪ੍ਰੀਫਿਕਸਾਂ ਰਾਹੀਂ ਸੰਰਚਨਾਯੋਗ — AUTO-COMBO.md ਵੇਖੋ):

  • priority — ਸਖ਼ਤ ਕ੍ਰਮ, ਕਦੇ ਵੀ ਰਾਊਂਡ-ਰੌਬਿਨ ਨਹੀਂ ਕਰਦਾ
  • weighted — ਪ੍ਰਤੀ-ਮਾਡਲ ਭਾਰਾਂ ਅਨੁਸਾਰ ਅਨੁਪਾਤਕ ਟ੍ਰੈਫ਼ਿਕ ਵੰਡ
  • fill-first — ਸੀਮਾਵਾਂ ਪੂਰੀਆਂ ਹੋਣ ਤੱਕ ਪਹਿਲੇ ਮਾਡਲ ਨੂੰ ਵਰਤਦਾ ਹੈ
  • round-robin / strict-random / random
  • p2c (ਦੋ ਚੋਣਾਂ ਦੀ ਸ਼ਕਤੀ)
  • least-used ਅਤੇ cost-optimized
  • auto — ਸਾਰੇ ਉਮੀਦਵਾਰਾਂ ਵਿੱਚ ਸਕੋਰ-ਅਧਾਰਿਤ ਚੋਣ
  • lkgp (ਆਖਰੀ ਜਾਣਿਆ ਚੰਗਾ ਪ੍ਰਦਾਤਾ) — ਆਖਰੀ ਸਫਲ ਪ੍ਰਦਾਤਾ ਨਾਲ ਜੁੜਿਆ ਰਹਿੰਦਾ ਹੈ, ਫਿਰ ਨਿਯਮਾਂ ਅਨੁਸਾਰ ਫਾਲਬੈਕ ਕਰਦਾ ਹੈ
  • context-optimized — ਸਭ ਤੋਂ ਵੱਡੀ ਖਾਲੀ ਕਾਂਟੈਕਸਟ ਵਿੰਡੋ ਵਾਲਾ ਮਾਡਲ ਚੁਣਦਾ ਹੈ
  • context-relay — ਫਾਲੋ-ਅੱਪ ਵਾਰੀਆਂ ਲਈ ਲੰਬੇ-ਕਾਂਟੈਕਸਟ ਵਾਲੇ ਮਾਡਲਾਂ ਨੂੰ ਲੜੀਬੱਧ ਕਰਦਾ ਹੈ

ਬਾਹਰੀ ਸਟਿੱਕੀ ਸੈਸ਼ਨ ਹੈਡਰ

ਬਾਹਰੀ ਸੈਸ਼ਨ ਅਫ਼ਿਨਿਟੀ ਲਈ (ਉਦਾਹਰਨ ਵਜੋਂ, ਰਿਵਰਸ ਪ੍ਰੌਕਸੀਆਂ ਦੇ ਪਿੱਛੇ Claude Code/Codex ਏਜੰਟ), ਇਹ ਭੇਜੋ:

X-Session-Id: your-session-key

OmniRoute x_session_id ਨੂੰ ਵੀ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ ਅਤੇ ਪ੍ਰਭਾਵੀ ਸੈਸ਼ਨ ਕੁੰਜੀ X-OmniRoute-Session-Id ਵਿੱਚ ਵਾਪਸ ਕਰਦਾ ਹੈ।

ਜੇ ਤੁਸੀਂ Nginx ਵਰਤਦੇ ਹੋ ਅਤੇ ਅੰਡਰਸਕੋਰ-ਰੂਪ ਵਾਲੇ ਹੈਡਰ ਭੇਜਦੇ ਹੋ, ਤਾਂ ਇਹ ਸਮਰੱਥ ਕਰੋ:

underscores_in_headers on;

ਵਾਇਲਡਕਾਰਡ ਮਾਡਲ ਉਪਨਾਮ

ਮਾਡਲ ਨਾਮਾਂ ਨੂੰ ਦੁਬਾਰਾ ਮੈਪ ਕਰਨ ਲਈ ਵਾਇਲਡਕਾਰਡ ਪੈਟਰਨ ਬਣਾਓ:

ਪੈਟਰਨ: claude-sonnet-*     →  ਟਾਰਗੇਟ: cc/claude-sonnet-4-6
ਪੈਟਰਨ: gpt-*               →  ਟਾਰਗੇਟ: gh/gpt-5.3-codex

ਵਾਇਲਡਕਾਰਡ * (ਕੋਈ ਵੀ ਅੱਖਰ) ਅਤੇ ? (ਇੱਕ ਅੱਖਰ) ਦਾ ਸਮਰਥਨ ਕਰਦੇ ਹਨ।

ਫਾਲਬੈਕ ਲੜੀਆਂ

ਉਹ ਗਲੋਬਲ ਫਾਲਬੈਕ ਲੜੀਆਂ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ ਜੋ ਸਾਰੀਆਂ ਬੇਨਤੀਆਂ 'ਤੇ ਲਾਗੂ ਹੁੰਦੀਆਂ ਹਨ:

ਲੜੀ: production-fallback
  1. cc/claude-opus-4-7
  2. gh/gpt-5.3-codex
  3. glm/glm-4.7

ਲਚੀਲਾਪਣ ਅਤੇ ਸਰਕਿਟ ਬ੍ਰੇਕਰ

Dashboard → Settings → Resilience ਰਾਹੀਂ ਸੰਰਚਨਾ ਕਰੋ।

OmniRoute ਪੰਜ ਭਾਗਾਂ ਨਾਲ ਪ੍ਰਦਾਤਾ-ਪੱਧਰੀ ਲਚੀਲਾਪਣ ਲਾਗੂ ਕਰਦਾ ਹੈ:

  1. ਬੇਨਤੀ ਕਤਾਰ ਅਤੇ ਗਤੀ ਨਿਯੰਤਰਣ — ਸਿਸਟਮ-ਪੱਧਰੀ ਬੇਨਤੀ ਆਕਾਰ-ਨਿਰਧਾਰਨ:

    • ਪ੍ਰਤੀ ਮਿੰਟ ਬੇਨਤੀਆਂ (RPM) — ਪ੍ਰਤੀ ਖਾਤਾ ਪ੍ਰਤੀ ਮਿੰਟ ਵੱਧ ਤੋਂ ਵੱਧ ਬੇਨਤੀਆਂ
    • ਬੇਨਤੀਆਂ ਵਿਚਕਾਰ ਘੱਟੋ-ਘੱਟ ਸਮਾਂ — ਬੇਨਤੀਆਂ ਵਿਚਕਾਰ ਮਿਲੀਸਕਿੰਟਾਂ ਵਿੱਚ ਘੱਟੋ-ਘੱਟ ਅੰਤਰ
    • ਵੱਧ ਤੋਂ ਵੱਧ ਸਮਕਾਲੀ ਬੇਨਤੀਆਂ — ਪ੍ਰਤੀ ਖਾਤਾ ਵੱਧ ਤੋਂ ਵੱਧ ਇੱਕੋ ਸਮੇਂ ਦੀਆਂ ਬੇਨਤੀਆਂ
  2. ਕਨੈਕਸ਼ਨ ਕੂਲਡਾਊਨ — ਮੁੜ-ਕੋਸ਼ਿਸ਼ਯੋਗ ਅਸਫਲਤਾਵਾਂ ਤੋਂ ਬਾਅਦ ਇੱਕ ਕਨੈਕਸ਼ਨ ਲਈ ਪ੍ਰਤੀ-ਪ੍ਰਮਾਣੀਕਰਨ-ਕਿਸਮ ਸੰਰਚਨਾ:

    • ਮੂਲ ਕੂਲਡਾਊਨ — ਮੁੜ-ਕੋਸ਼ਿਸ਼ਯੋਗ ਅੱਪਸਟ੍ਰੀਮ ਅਸਫਲਤਾਵਾਂ ਲਈ ਮੂਲ ਕੂਲਡਾਊਨ ਵਿੰਡੋ
    • ਅੱਪਸਟ੍ਰੀਮ ਮੁੜ-ਕੋਸ਼ਿਸ਼ ਸੰਕੇਤ ਵਰਤੋ — ਉਪਲਬਧ ਹੋਣ 'ਤੇ ਅਧਿਕਾਰਤ Retry-After ਜਾਂ ਰੀਸੈੱਟ ਸੰਕੇਤਾਂ ਦਾ ਪਾਲਣ ਕਰਦਾ ਹੈ
    • ਵੱਧ ਤੋਂ ਵੱਧ ਬੈਕਆਫ਼ ਪੜਾਅ — ਦੁਹਰਾਈਆਂ ਅਸਫਲਤਾਵਾਂ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ ਐਕਸਪੋਨੇੰਸ਼ੀਅਲ ਬੈਕਆਫ਼ ਪੱਧਰ
  3. ਪ੍ਰਦਾਤਾ ਸਰਕਿਟ ਬ੍ਰੇਕਰ — ਸ਼ੁਰੂ ਤੋਂ ਅੰਤ ਤੱਕ ਦੀਆਂ ਪ੍ਰਦਾਤਾ ਅਸਫਲਤਾਵਾਂ ਨੂੰ ਟ੍ਰੈਕ ਕਰਦਾ ਹੈ, ਸੰਰਚਿਤ ਚੇਤਾਵਨੀ ਸੀਮਾ 'ਤੇ ਪ੍ਰਦਾਤਾ ਨੂੰ ਕਮਜ਼ੋਰ ਵਜੋਂ ਚਿੰਨ੍ਹਿਤ ਕਰਦਾ ਹੈ ਅਤੇ ਸੰਰਚਿਤ ਅਸਫਲਤਾ ਸੀਮਾ ਪੂਰੀ ਹੋਣ 'ਤੇ ਬ੍ਰੇਕਰ ਖੋਲ੍ਹਦਾ ਹੈ:

    • ਕਮਜ਼ੋਰੀ ਸੀਮਾDEGRADED ਵਿੱਚ ਦਾਖ਼ਲ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਲਗਾਤਾਰ ਪ੍ਰਦਾਤਾ ਅਸਫਲਤਾਵਾਂ
    • ਅਸਫਲਤਾ ਸੀਮਾOPEN ਵਿੱਚ ਦਾਖ਼ਲ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਲਗਾਤਾਰ ਪ੍ਰਦਾਤਾ ਅਸਫਲਤਾਵਾਂ
    • ਰੀਸੈੱਟ ਟਾਈਮਆਉਟ — ਪ੍ਰਦਾਤਾ ਦੀ ਦੁਬਾਰਾ ਜਾਂਚ ਤੋਂ ਪਹਿਲਾਂ ਦੀ ਸਮਾਂ ਵਿੰਡੋ
    • CLOSED (ਸਿਹਤਮੰਦ) — ਬੇਨਤੀਆਂ ਆਮ ਤੌਰ 'ਤੇ ਪ੍ਰਵਾਹਿਤ ਹੁੰਦੀਆਂ ਹਨ
    • DEGRADED — ਵਧੀਆਂ ਅਸਫਲਤਾਵਾਂ ਨੂੰ ਟ੍ਰੈਕ ਕਰਦਿਆਂ ਬੇਨਤੀਆਂ ਹਾਲੇ ਵੀ ਪ੍ਰਵਾਹਿਤ ਹੁੰਦੀਆਂ ਹਨ
    • OPEN — ਦੁਹਰਾਈਆਂ ਅਸਫਲਤਾਵਾਂ ਤੋਂ ਬਾਅਦ ਪ੍ਰਦਾਤਾ ਅਸਥਾਈ ਤੌਰ 'ਤੇ ਬਲੌਕ ਹੁੰਦਾ ਹੈ
    • HALF_OPEN — ਜਾਂਚ ਕਰ ਰਿਹਾ ਹੈ ਕਿ ਪ੍ਰਦਾਤਾ ਮੁੜ ਠੀਕ ਹੋ ਗਿਆ ਹੈ ਜਾਂ ਨਹੀਂ

    ਕਨੈਕਸ਼ਨ-ਸੀਮਿਤ 429 ਦਰ ਸੀਮਾਵਾਂ ਕਨੈਕਸ਼ਨ ਕੂਲਡਾਊਨ ਵਿੱਚ ਰਹਿੰਦੀਆਂ ਹਨ ਅਤੇ ਪ੍ਰਦਾਤਾ ਬ੍ਰੇਕਰ ਵਿੱਚ ਨਹੀਂ ਗਿਣੀਆਂ ਜਾਂਦੀਆਂ।

    ਪ੍ਰਦਾਤਾ ਬ੍ਰੇਕਰ ਦੀ ਰਨਟਾਈਮ ਸਥਿਤੀ ਸਿਰਫ਼ Dashboard → Health 'ਤੇ ਦਿਖਾਈ ਜਾਂਦੀ ਹੈ।

  4. ਕੂਲਡਾਊਨ ਦੀ ਉਡੀਕ ਕਰੋ — ਜੇ ਹਰੇਕ ਉਮੀਦਵਾਰ ਕਨੈਕਸ਼ਨ ਪਹਿਲਾਂ ਹੀ ਕੂਲਡਾਊਨ ਵਿੱਚ ਹੈ, ਤਾਂ OmniRoute ਸਭ ਤੋਂ ਪਹਿਲਾਂ ਖ਼ਤਮ ਹੋਣ ਵਾਲੇ ਕੂਲਡਾਊਨ ਦੀ ਉਡੀਕ ਕਰ ਸਕਦਾ ਹੈ ਅਤੇ ਉਸੇ ਕਲਾਇੰਟ ਬੇਨਤੀ ਦੀ ਆਪਣੇ ਆਪ ਮੁੜ ਕੋਸ਼ਿਸ਼ ਕਰ ਸਕਦਾ ਹੈ।

  5. ਦਰ ਸੀਮਾ ਦੀ ਸਵੈਚਲਿਤ ਪਛਾਣ — ਜਦੋਂ ਅੱਪਸਟ੍ਰੀਮ ਪ੍ਰਦਾਤਾ ਸਪਸ਼ਟ ਉਡੀਕ ਵਿੰਡੋ ਵਾਪਸ ਕਰਦੇ ਹਨ, ਤਾਂ ਸੈਟਿੰਗ ਸਮਰੱਥ ਹੋਣ 'ਤੇ ਉਹ ਸੰਕੇਤ ਸਥਾਨਕ ਕਨੈਕਸ਼ਨ ਕੂਲਡਾਊਨ ਨੂੰ ਓਵਰਰਾਈਡ ਕਰਦੇ ਹਨ।

ਮਾਹਰ ਸੁਝਾਅ: ਆਊਟੇਜ ਤੋਂ ਬਾਅਦ ਲਾਈਵ ਪ੍ਰਦਾਤਾ ਬ੍ਰੇਕਰਾਂ ਦੀ ਜਾਂਚ ਅਤੇ ਰੀਸੈੱਟ ਕਰਨ ਲਈ Health ਪੰਨਾ ਵਰਤੋ। Resilience ਪੰਨਾ ਸਿਰਫ਼ ਸੰਰਚਨਾ ਬਦਲਦਾ ਹੈ।


ਡਾਟਾਬੇਸ ਐਕਸਪੋਰਟ / ਇੰਪੋਰਟ

Dashboard → Settings → System & Storage ਵਿੱਚ ਡਾਟਾਬੇਸ ਬੈਕਅੱਪਾਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ।

ਕਾਰਵਾਈ ਵੇਰਵਾ
ਡਾਟਾਬੇਸ ਐਕਸਪੋਰਟ ਕਰੋ ਮੌਜੂਦਾ SQLite ਡਾਟਾਬੇਸ ਨੂੰ .sqlite ਫ਼ਾਈਲ ਵਜੋਂ ਡਾਊਨਲੋਡ ਕਰਦਾ ਹੈ
ਸਭ ਕੁਝ ਐਕਸਪੋਰਟ ਕਰੋ (.tar.gz) ਇੱਕ ਪੂਰਾ ਬੈਕਅੱਪ ਆਰਕਾਈਵ ਡਾਊਨਲੋਡ ਕਰਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਸ਼ਾਮਲ ਹਨ: ਡਾਟਾਬੇਸ, ਸੈਟਿੰਗਾਂ, ਕੌਂਬੋ, ਪ੍ਰਦਾਤਾ ਕਨੈਕਸ਼ਨ (ਕ੍ਰੈਡੈਂਸ਼ੀਅਲਾਂ ਤੋਂ ਬਿਨਾਂ), API ਕੁੰਜੀ ਮੈਟਾਡੇਟਾ
ਡਾਟਾਬੇਸ ਇੰਪੋਰਟ ਕਰੋ ਮੌਜੂਦਾ ਡਾਟਾਬੇਸ ਨੂੰ ਬਦਲਣ ਲਈ ਇੱਕ .sqlite ਫ਼ਾਈਲ ਅੱਪਲੋਡ ਕਰਦਾ ਹੈ। ਜਦੋਂ ਤੱਕ DISABLE_SQLITE_AUTO_BACKUP=true ਨਾ ਹੋਵੇ, ਇੰਪੋਰਟ ਤੋਂ ਪਹਿਲਾਂ ਬੈਕਅੱਪ ਆਪਣੇ-ਆਪ ਬਣਾਇਆ ਜਾਂਦਾ ਹੈ
# API: ਡਾਟਾਬੇਸ ਐਕਸਪੋਰਟ ਕਰੋ
curl -o backup.sqlite http://localhost:20128/api/db-backups/export

# API: ਸਭ ਕੁਝ ਐਕਸਪੋਰਟ ਕਰੋ (ਪੂਰਾ ਆਰਕਾਈਵ)
curl -o backup.tar.gz http://localhost:20128/api/db-backups/exportAll

# API: ਡਾਟਾਬੇਸ ਇੰਪੋਰਟ ਕਰੋ
curl -X POST http://localhost:20128/api/db-backups/import \
  -F "file=@backup.sqlite"

ਇੰਪੋਰਟ ਪ੍ਰਮਾਣਿਕਤਾ: ਇੰਪੋਰਟ ਕੀਤੀ ਫ਼ਾਈਲ ਦੀ ਅਖੰਡਤਾ (SQLite pragma ਜਾਂਚ), ਲੋੜੀਂਦੀਆਂ ਟੇਬਲਾਂ (provider_connections, provider_nodes, combos, api_keys) ਅਤੇ ਆਕਾਰ (ਵੱਧ ਤੋਂ ਵੱਧ 100MB) ਦੀ ਜਾਂਚ ਕੀਤੀ ਜਾਂਦੀ ਹੈ।

ਵਰਤੋਂ ਦੇ ਮਾਮਲੇ:

  • OmniRoute ਨੂੰ ਮਸ਼ੀਨਾਂ ਵਿਚਕਾਰ ਮਾਈਗਰੇਟ ਕਰੋ
  • ਆਫ਼ਤ ਤੋਂ ਬਹਾਲੀ ਲਈ ਬਾਹਰੀ ਬੈਕਅੱਪ ਬਣਾਓ
  • ਟੀਮ ਮੈਂਬਰਾਂ ਵਿਚਕਾਰ ਸੰਰਚਨਾਵਾਂ ਸਾਂਝੀਆਂ ਕਰੋ (ਸਭ ਕੁਝ ਐਕਸਪੋਰਟ ਕਰੋ → ਆਰਕਾਈਵ ਸਾਂਝਾ ਕਰੋ)

ਸੈਟਿੰਗਾਂ ਡੈਸ਼ਬੋਰਡ

ਆਸਾਨ ਨੈਵੀਗੇਸ਼ਨ ਲਈ ਸੈਟਿੰਗਾਂ ਪੰਨੇ ਨੂੰ 7 ਟੈਬਾਂ ਵਿੱਚ ਵਿਵਸਥਿਤ ਕੀਤਾ ਗਿਆ ਹੈ:

ਟੈਬ ਸਮੱਗਰੀ
ਆਮ ਸਿਸਟਮ ਸਟੋਰੇਜ ਟੂਲ, ਮੂਲ ਵਿਹਾਰ, Endpoint ਟਨਲ ਦੀ ਦਿੱਖ
ਦਿੱਖ ਥੀਮ ਕੰਟਰੋਲ (ਹਲਕਾ/ਗੂੜ੍ਹਾ/ਸਿਸਟਮ), ਸਾਈਡਬਾਰ ਦੀ ਦਿੱਖ, Cloudflare/Tailscale/ngrok ਟਨਲ ਕਾਰਡਾਂ ਲਈ ਪੈਨਲ ਟੌਗਲ
AI ਸੋਚਣ ਦਾ ਬਜਟ (ਜਿਉਂ-ਦਾ-ਤਿਉਂ / ਆਪਣੇ-ਆਪ ਹਟਾਓ / ਕਸਟਮ / ਅਨੁਕੂਲ — THINKING_BUDGET.md ਵੇਖੋ), ਗਲੋਬਲ ਸਿਸਟਮ ਪ੍ਰੌਂਪਟ, ਪ੍ਰੌਂਪਟ ਕੈਸ਼ ਅੰਕੜੇ
ਸੁਰੱਖਿਆ ਲੌਗਇਨ/ਪਾਸਵਰਡ ਸੈਟਿੰਗਾਂ, IP ਪਹੁੰਚ ਕੰਟਰੋਲ, /models ਲਈ API ਪ੍ਰਮਾਣੀਕਰਨ, ਪ੍ਰਦਾਤਾ ਬਲੌਕਿੰਗ, ਪ੍ਰੌਂਪਟ-ਇੰਜੈਕਸ਼ਨ ਸੁਰੱਖਿਆ
ਰਾਊਟਿੰਗ ਗਲੋਬਲ ਰਾਊਟਿੰਗ ਰਣਨੀਤੀ (ਪਹਿਲਾਂ ਭਰੋ / ਰਾਊਂਡ ਰੌਬਿਨ / P2C / ਬੇਤਰਤੀਬ / ਸਭ ਤੋਂ ਘੱਟ ਵਰਤਿਆ / ਲਾਗਤ ਅਨੁਕੂਲਿਤ), ਵਾਇਲਡਕਾਰਡ ਮਾਡਲ ਉਪਨਾਮ, ਫ਼ਾਲਬੈਕ ਲੜੀਆਂ, ਕੌਂਬੋ ਡਿਫ਼ਾਲਟ
ਲਚੀਲਾਪਣ ਬੇਨਤੀ ਕਤਾਰ, ਕਨੈਕਸ਼ਨ ਕੂਲਡਾਊਨ, ਪ੍ਰਦਾਤਾ ਬ੍ਰੇਕਰ ਸੰਰਚਨਾ ਅਤੇ ਕੂਲਡਾਊਨ ਦੀ ਉਡੀਕ ਕਰਨ ਦਾ ਵਿਹਾਰ
ਉੱਨਤ ਗਲੋਬਲ ਪ੍ਰੌਕਸੀ ਸੰਰਚਨਾ (HTTP/SOCKS5), ਹਰ ਪ੍ਰਦਾਤਾ ਲਈ ਪ੍ਰੌਕਸੀ ਓਵਰਰਾਈਡ

ਆਮ ਟੈਬ ਵਿੱਚ ਹੁਣ ਸਿਰਫ਼-ਪੜ੍ਹਨਯੋਗ ਲੌਗਿੰਗ ਅਤੇ ਕੈਸ਼ ਨੋਟਾਂ ਦੀ ਨਕਲ ਨਹੀਂ ਹੁੰਦੀ। ਡਾਟਾਬੇਸ ਰਿਟੇਨਸ਼ਨ ਅਤੇ ਅਨੁਕੂਲਨ ਸੈਟਿੰਗਾਂ /api/settings/database ਰਾਹੀਂ ਸਥਾਈ ਤੌਰ 'ਤੇ ਸੰਭਾਲੀਆਂ ਜਾਂਦੀਆਂ ਹਨ; ਕੈਸ਼ ਨੂੰ ਹੱਥੀਂ ਸਾਫ਼ ਕਰਨ ਲਈ DELETE /api/cache ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ। ਬੇਨਤੀ ਅਤੇ ਪ੍ਰੌਕਸੀ ਲੌਗ ਕਤਾਰ ਸੀਮਾਵਾਂ ਨੂੰ CALL_LOGS_TABLE_MAX_ROWS ਅਤੇ PROXY_LOGS_TABLE_MAX_ROWS ਦੁਆਰਾ ਨਿਯੰਤਰਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।


ਲਾਗਤਾਂ ਅਤੇ ਬਜਟ ਪ੍ਰਬੰਧਨ

ਡੈਸ਼ਬੋਰਡ → ਲਾਗਤਾਂ ਰਾਹੀਂ ਪਹੁੰਚ ਕਰੋ।

ਟੈਬ ਉਦੇਸ਼
ਬਜਟ ਰੋਜ਼ਾਨਾ/ਹਫ਼ਤਾਵਾਰੀ/ਮਾਸਿਕ ਬਜਟਾਂ ਅਤੇ ਰੀਅਲ-ਟਾਈਮ ਟ੍ਰੈਕਿੰਗ ਨਾਲ ਹਰ API ਕੁੰਜੀ ਲਈ ਖ਼ਰਚ ਸੀਮਾਵਾਂ ਨਿਰਧਾਰਤ ਕਰੋ
ਕੀਮਤਾਂ ਮਾਡਲ ਕੀਮਤ ਐਂਟਰੀਆਂ ਵੇਖੋ ਅਤੇ ਸੋਧੋ — ਹਰ ਪ੍ਰਦਾਤਾ ਲਈ ਪ੍ਰਤੀ 1K ਇਨਪੁੱਟ/ਆਉਟਪੁੱਟ ਟੋਕਨਾਂ ਦੀ ਲਾਗਤ
# API: ਬਜਟ ਨਿਰਧਾਰਤ ਕਰੋ
curl -X POST http://localhost:20128/api/usage/budget \
  -H "Content-Type: application/json" \
  -d '{"keyId": "key-123", "limit": 50.00, "period": "monthly"}'

# API: ਮੌਜੂਦਾ ਬਜਟ ਸਥਿਤੀ ਪ੍ਰਾਪਤ ਕਰੋ
curl http://localhost:20128/api/usage/budget

ਲਾਗਤ ਟ੍ਰੈਕਿੰਗ: ਹਰ ਬੇਨਤੀ ਟੋਕਨ ਵਰਤੋਂ ਨੂੰ ਲੌਗ ਕਰਦੀ ਹੈ ਅਤੇ ਕੀਮਤ ਸਾਰਣੀ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਲਾਗਤ ਦੀ ਗਣਨਾ ਕਰਦੀ ਹੈ। ਪ੍ਰਦਾਤਾ, ਮਾਡਲ ਅਤੇ API ਕੁੰਜੀ ਅਨੁਸਾਰ ਵੇਰਵੇ ਡੈਸ਼ਬੋਰਡ → ਵਰਤੋਂ ਵਿੱਚ ਵੇਖੋ।


ਆਡੀਓ ਟ੍ਰਾਂਸਕ੍ਰਿਪਸ਼ਨ

OmniRoute, OpenAI-ਅਨੁਕੂਲ ਐਂਡਪੌਇੰਟ ਰਾਹੀਂ ਆਡੀਓ ਟ੍ਰਾਂਸਕ੍ਰਿਪਸ਼ਨ ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ:

POST /v1/audio/transcriptions
Authorization: Bearer your-api-key
Content-Type: multipart/form-data

# curl ਨਾਲ ਉਦਾਹਰਨ
curl -X POST http://localhost:20128/v1/audio/transcriptions \
  -H "Authorization: Bearer your-api-key" \
  -F "file=@audio.mp3" \
  -F "model=openai/whisper-1"

deepgram/nova-3 ਮੂਲ Deepgram ਰੂਟ ਹੈ ਅਤੇ ਇਸ ਲਈ Deepgram API ਕੁੰਜੀ ਦੀ ਲੋੜ ਹੈ। ਜੇ ਸਿਰਫ਼ OpenRouter ਸੰਰਚਿਤ ਹੈ, ਤਾਂ openrouter/deepgram/nova-3 ਵਰਤੋ।

ਬੋਲੀ-ਤੋਂ-ਲਿਖਤ (ਟ੍ਰਾਂਸਕ੍ਰਿਪਸ਼ਨ) ਪ੍ਰਦਾਤਾ:

  • openai/ (whisper-ਅਨੁਕੂਲ)
  • groq/ (Groq Whisper Turbo)
  • deepgram/ (Nova ਪਰਿਵਾਰ)
  • assemblyai/
  • nvidia/ (Parakeet, Canary)
  • huggingface/ (whisper ਰੂਪ)
  • qwen/

ਲਿਖਤ-ਤੋਂ-ਬੋਲੀ (POST /v1/audio/speech) ਪ੍ਰਦਾਤਾ:

  • openai/ (tts-1, tts-1-hd)
  • hyperbolic/
  • deepgram/ (Aura)
  • nvidia/ (Magpie TTS)
  • elevenlabs/
  • huggingface/
  • inworld/
  • cartesia/
  • playht/
  • kie/
  • aws-polly/
  • xiaomi-mimo/
  • coqui/, tortoise/
  • qwen/

ਟ੍ਰਾਂਸਕ੍ਰਿਪਸ਼ਨ ਲਈ ਸਮਰਥਿਤ ਆਡੀਓ ਫ਼ਾਰਮੈਟ: mp3, wav, m4a, flac, ogg, webm। TTS ਆਉਟਪੁੱਟ ਫ਼ਾਰਮੈਟ ਪ੍ਰਦਾਤਾ 'ਤੇ ਨਿਰਭਰ ਕਰਦੇ ਹਨ (mp3, wav, opus, pcm, mulaw)।


ਕੌਂਬੋ ਸੰਤੁਲਨ ਰਣਨੀਤੀਆਂ

ਹਰ ਕੌਂਬੋ ਲਈ ਸੰਤੁਲਨ ਨੂੰ ਡੈਸ਼ਬੋਰਡ → ਕੌਂਬੋ → ਬਣਾਓ/ਸੋਧੋ → ਰਣਨੀਤੀ ਵਿੱਚ ਸੰਰਚਿਤ ਕਰੋ।

ਰਣਨੀਤੀ ਵੇਰਵਾ
ਰਾਊਂਡ-ਰੌਬਿਨ ਮਾਡਲਾਂ ਨੂੰ ਕ੍ਰਮਵਾਰ ਬਦਲਦਾ ਰਹਿੰਦਾ ਹੈ
ਤਰਜੀਹ ਹਮੇਸ਼ਾ ਪਹਿਲੇ ਮਾਡਲ ਨੂੰ ਅਜ਼ਮਾਉਂਦਾ ਹੈ; ਸਿਰਫ਼ ਗਲਤੀ ਹੋਣ 'ਤੇ ਹੀ ਫਾਲਬੈਕ ਕਰਦਾ ਹੈ
ਬੇਤਰਤੀਬ ਹਰ ਬੇਨਤੀ ਲਈ ਕੌਂਬੋ ਵਿੱਚੋਂ ਇੱਕ ਬੇਤਰਤੀਬ ਮਾਡਲ ਚੁਣਦਾ ਹੈ
ਭਾਰਿਤ ਹਰੇਕ ਮਾਡਲ ਲਈ ਨਿਰਧਾਰਤ ਭਾਰਾਂ ਦੇ ਆਧਾਰ 'ਤੇ ਅਨੁਪਾਤਕ ਤੌਰ 'ਤੇ ਰੂਟ ਕਰਦਾ ਹੈ
ਸਭ ਤੋਂ ਘੱਟ ਵਰਤਿਆ ਸਭ ਤੋਂ ਘੱਟ ਹਾਲੀਆ ਬੇਨਤੀਆਂ ਵਾਲੇ ਮਾਡਲ ਵੱਲ ਰੂਟ ਕਰਦਾ ਹੈ (ਕੌਂਬੋ ਮੈਟ੍ਰਿਕਸ ਵਰਤਦਾ ਹੈ)
ਲਾਗਤ-ਅਨੁਕੂਲਿਤ ਸਭ ਤੋਂ ਸਸਤੇ ਉਪਲਬਧ ਮਾਡਲ ਵੱਲ ਰੂਟ ਕਰਦਾ ਹੈ (ਕੀਮਤ ਸਾਰਣੀ ਵਰਤਦਾ ਹੈ)

ਗਲੋਬਲ ਕੌਂਬੋ ਡਿਫਾਲਟ ਡੈਸ਼ਬੋਰਡ → ਸੈਟਿੰਗਾਂ → ਰੂਟਿੰਗ → ਕੌਂਬੋ ਡਿਫਾਲਟ ਵਿੱਚ ਸੈੱਟ ਕੀਤੇ ਜਾ ਸਕਦੇ ਹਨ। ਕੌਂਬੋ ਟਾਰਗੇਟ ਟਾਈਮਆਉਟ ਮੂਲ ਰੂਪ ਵਿੱਚ ਮੌਜੂਦਾ ਬੇਨਤੀ ਟਾਈਮਆਉਟ ਨੂੰ ਵਿਰਾਸਤ ਵਿੱਚ ਲੈਂਦੇ ਹਨ। ਕੌਂਬੋ ਡਿਫਾਲਟਾਂ ਜਾਂ ਕਿਸੇ ਵਿਅਕਤੀਗਤ ਕੌਂਬੋ 'ਤੇ ਟਾਰਗੇਟ ਟਾਈਮਆਉਟ (ਸਕਿੰਟ) ਦੀ ਵਰਤੋਂ ਸਿਰਫ਼ ਉਦੋਂ ਕਰੋ ਜਦੋਂ ਪ੍ਰਤੀ-ਟਾਰਗੇਟ ਛੋਟੀ ਸੀਮਾ ਨਾਲ ਤੇਜ਼ ਫਾਲਬੈਕ ਟ੍ਰਿਗਰ ਕਰਨਾ ਹੋਵੇ।

ਜ਼ੀਰੋ-ਲੇਟੈਂਸੀ ਕੌਂਬੋ ਅਨੁਕੂਲਨ ਚੋਣਵਾਂ ਹਨ। ਇਨ੍ਹਾਂ ਲੇਟੈਂਸੀ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਨੂੰ ਫਾਲਬੈਕ ਟਾਰਗੇਟਾਂ ਨਾਲ ਮੁਕਾਬਲਾ ਕਰਨ, TTFT ਇਤਿਹਾਸ ਦੇ ਆਧਾਰ 'ਤੇ ਟਾਰਗੇਟਾਂ ਨੂੰ ਛੱਡਣ, ਜਾਂ ਫਾਲਬੈਕ ਬੇਨਤੀਆਂ ਨੂੰ ਸੰਕੁਚਿਤ ਕਰਨ ਤੋਂ ਰੋਕਣ ਲਈ ਜ਼ੀਰੋ-ਲੇਟੈਂਸੀ ਅਨੁਕੂਲਨ ਨੂੰ ਅਸਮਰੱਥ ਛੱਡੋ; ਇਸਨੂੰ ਸਮਰੱਥ ਕਰਨ ਨਾਲ ਸੰਰਚਿਤ ਹੈਜਿੰਗ, ਪੂਰਵ-ਅਨੁਮਾਨਿਤ TTFT ਸਕਿੱਪ ਅਤੇ ਸਰਗਰਮ ਫਾਲਬੈਕ ਸੰਕੁਚਨ ਨੂੰ ਘੱਟ ਟੇਲ ਲੇਟੈਂਸੀ ਦੇ ਬਦਲੇ ਰੂਟਿੰਗ/ਬੇਨਤੀ ਦੀ ਯਥਾਰਥਤਾ ਨਾਲ ਸਮਝੌਤਾ ਕਰਨ ਦੀ ਆਗਿਆ ਮਿਲਦੀ ਹੈ।

ਜਦੋਂ ਅੱਪਸਟ੍ਰੀਮ ਪ੍ਰਦਾਤਿਆਂ ਨੂੰ ਸਖ਼ਤ max_tokens / maxOutputTokens ਸੀਮਾਵਾਂ ਦੀ ਲੋੜ ਹੋਵੇ ਤਾਂ ਰੀਜ਼ਨਿੰਗ ਟੋਕਨ ਬਫ਼ਰ ਨੂੰ ਅਸਮਰੱਥ ਕਰੋ। ਸਮਰੱਥ ਹੋਣ 'ਤੇ, ਕੌਂਬੋ ਰੂਟਿੰਗ ਸਿਰਫ਼ ਜਾਣੀ-ਪਛਾਣੀ ਆਉਟਪੁੱਟ ਸੀਮਾ ਵਾਲੇ ਮਾਡਲਾਂ ਲਈ ਰੀਜ਼ਨਿੰਗ-ਮਾਡਲ ਵਾਧੂ ਗੁੰਜਾਇਸ਼ ਜੋੜਦੀ ਹੈ ਅਤੇ ਜਦੋਂ ਸੁਰੱਖਿਅਤ ਬਫ਼ਰ ਕੀਤਾ ਮੁੱਲ ਉਸ ਸੀਮਾ ਤੋਂ ਵੱਧ ਜਾਂਦਾ ਹੋਵੇ ਤਾਂ ਕਲਾਇੰਟ ਟੋਕਨ ਸੀਮਾ ਨੂੰ ਬਦਲੇ ਬਿਨਾਂ ਛੱਡ ਦਿੰਦੀ ਹੈ। ਜੇ ਕਲਾਇੰਟ ਸੀਮਾ ਪਹਿਲਾਂ ਹੀ ਕਿਸੇ ਜਾਣੀ-ਪਛਾਣੀ ਸੀਮਾ ਤੋਂ ਵੱਧ ਹੈ, ਤਾਂ OmniRoute ਅੱਪਸਟ੍ਰੀਮ ਬੇਨਤੀ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਇਸਨੂੰ ਘਟਾ ਕੇ ਉਸ ਸੀਮਾ ਤੱਕ ਕਰ ਦਿੰਦਾ ਹੈ।


ਸਿਹਤ ਡੈਸ਼ਬੋਰਡ

ਡੈਸ਼ਬੋਰਡ → ਸਿਹਤ ਰਾਹੀਂ ਪਹੁੰਚ ਕਰੋ। 6 ਕਾਰਡਾਂ ਨਾਲ ਰੀਅਲ-ਟਾਈਮ ਸਿਸਟਮ ਸਿਹਤ ਦੀ ਸੰਖੇਪ ਜਾਣਕਾਰੀ:

ਕਾਰਡ ਇਹ ਕੀ ਦਿਖਾਉਂਦਾ ਹੈ
ਸਿਸਟਮ ਸਥਿਤੀ ਅਪਟਾਈਮ, ਵਰਜਨ, ਮੈਮੋਰੀ ਵਰਤੋਂ, ਡਾਟਾ ਡਾਇਰੈਕਟਰੀ
ਪ੍ਰਦਾਤਾ ਸਿਹਤ ਗਲੋਬਲ ਪ੍ਰਦਾਤਾ ਸਰਕਟ ਬ੍ਰੇਕਰ ਦੀ ਰਨਟਾਈਮ ਸਥਿਤੀ
ਦਰ ਸੀਮਾਵਾਂ ਬਾਕੀ ਸਮੇਂ ਸਮੇਤ ਪ੍ਰਤੀ ਖਾਤਾ ਸਰਗਰਮ ਕਨੈਕਸ਼ਨ ਕੂਲਡਾਊਨ
ਸਰਗਰਮ ਲਾਕਆਉਟ ਸਰਗਰਮ ਮਾਡਲ-ਸਕੋਪਡ ਲਾਕਆਉਟ ਅਤੇ ਅਸਥਾਈ ਬੇਦਖਲੀਆਂ
ਸਿਗਨੇਚਰ ਕੈਸ਼ ਡੀਡੁਪਲੀਕੇਸ਼ਨ ਕੈਸ਼ ਅੰਕੜੇ (ਸਰਗਰਮ ਕੁੰਜੀਆਂ, ਹਿੱਟ ਦਰ)
ਲੇਟੈਂਸੀ ਟੈਲੀਮੈਟਰੀ ਪ੍ਰਤੀ ਪ੍ਰਦਾਤਾ p50/p95/p99 ਲੇਟੈਂਸੀ ਏਗਰੀਗੇਸ਼ਨ

ਪੇਸ਼ੇਵਰ ਸੁਝਾਅ: ਸਿਹਤ ਪੰਨਾ ਹਰ 10 ਸਕਿੰਟਾਂ ਬਾਅਦ ਆਪਣੇ ਆਪ ਰਿਫ੍ਰੈਸ਼ ਹੁੰਦਾ ਹੈ। ਇਹ ਪਛਾਣ ਕਰਨ ਲਈ ਸਰਕਟ ਬ੍ਰੇਕਰ ਕਾਰਡ ਵਰਤੋ ਕਿ ਕਿਹੜੇ ਪ੍ਰਦਾਤਾ ਸਮੱਸਿਆਵਾਂ ਦਾ ਸਾਹਮਣਾ ਕਰ ਰਹੇ ਹਨ।


🤖 ਆਟੋ-ਰਾਊਟਿੰਗ (ਜ਼ੀਰੋ-ਕਨਫਿਗ)

OmniRoute ਇੱਕ ਸਕੋਰ-ਅਧਾਰਿਤ ਆਟੋ-ਰਾਊਟਰ ਨਾਲ ਆਉਂਦਾ ਹੈ, ਜੋ ਹਰੇਕ ਕਨੈਕਟ ਕੀਤੇ ਪ੍ਰਦਾਤਾ ਵਿੱਚੋਂ ਹਰ ਬੇਨਤੀ ਲਈ ਸਭ ਤੋਂ ਵਧੀਆ ਮਾਡਲ ਚੁਣਦਾ ਹੈ — ਸੰਭਾਲਣ ਲਈ ਕੋਈ ਕੌਂਬੋ ਨਹੀਂ। ਸਿਰਫ਼ auto/* ਪ੍ਰੀਫਿਕਸਾਂ ਵਿੱਚੋਂ ਕਿਸੇ ਇੱਕ ਨਾਲ ਬੇਨਤੀ ਭੇਜੋ ਅਤੇ OmniRoute ਤੁਰੰਤ ਇੱਕ ਵਰਚੁਅਲ ਕੌਂਬੋ ਤਿਆਰ ਕਰੇਗਾ, ਜੋ ਲੇਟੈਂਸੀ, ਲਾਗਤ, ਸਫਲਤਾ ਦਰ, ਕਾਂਟੈਕਸਟ ਅਨੁਕੂਲਤਾ, ਕੰਮ ਲਈ ਮਾਡਲ ਦੀ ਯੋਗਤਾ, ਹਾਲੀਆ ਅਸਫਲਤਾਵਾਂ, ਕੋਟਾ ਅਤੇ ਸਰਕਿਟ-ਬ੍ਰੇਕਰ ਸਥਿਤੀ ਦੇ ਆਧਾਰ 'ਤੇ ਉਮੀਦਵਾਰਾਂ ਨੂੰ ਸਕੋਰ ਕਰੇਗਾ।

ਪ੍ਰੀਫਿਕਸ ਕਿਸ ਲਈ ਅਨੁਕੂਲਿਤ ਕਰਦਾ ਹੈ
auto ਸੰਤੁਲਿਤ ਡਿਫਾਲਟ (ਲੇਟੈਂਸੀ × ਲਾਗਤ × ਸਫਲਤਾ ਦਰ)
auto/coding ਕੋਡਿੰਗ ਕੰਮ: Claude, GPT-5, GLM, Kimi, Qwen Coder, DeepSeek ਕੋਡਰਾਂ ਨੂੰ ਤਰਜੀਹ ਦਿੰਦਾ ਹੈ
auto/cheap ਸਭ ਤੋਂ ਘੱਟ $/token, ਵੱਧ ਲੇਟੈਂਸੀ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ
auto/fast ਸਭ ਤੋਂ ਘੱਟ ਲੇਟੈਂਸੀ, ਲਾਗਤ ਨੂੰ ਨਜ਼ਰਅੰਦਾਜ਼ ਕਰਦਾ ਹੈ
auto/offline ਸਿਰਫ਼ ਸਥਾਨਕ ਪ੍ਰਦਾਤਾ (Ollama, vLLM, llama.cpp) — ਏਅਰ-ਗੈਪਡ ਸੈੱਟਅੱਪਾਂ ਲਈ ਲਾਭਦਾਇਕ
auto/smart ਤਰਕ ਦੀ ਗੁਣਵੱਤਾ ਪਹਿਲਾਂ (Opus, GPT-5 xhigh, R1, GLM 5.1 reasoning)
auto/lkgp "ਆਖਰੀ ਜਾਣਿਆ ਚੰਗਾ ਪ੍ਰਦਾਤਾ" — ਆਖਰੀ ਸਫਲ ਪ੍ਰਦਾਤਾ ਨਾਲ ਪਿੰਨ ਕਰਦਾ ਹੈ, ਫਿਰ ਨਿਯਮਾਂ 'ਤੇ ਫਾਲਬੈਕ ਕਰਦਾ ਹੈ

ਉਦਾਹਰਨ:

curl -X POST http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto/coding",
    "messages": [{ "role": "user", "content": "Refactor this Python function" }],
    "stream": true
  }'

ਆਟੋ-ਰਾਊਟਰ ਦਾ ਪੂਰਾ ਵੇਰਵਾ AUTO-COMBO.md ਵਿੱਚ ਦਿੱਤਾ ਗਿਆ ਹੈ — ਇਸ ਵਿੱਚ ਸਕੋਰਿੰਗ ਵੇਟਾਂ ਨੂੰ ਕਿਵੇਂ ਟਿਊਨ ਕਰਨਾ ਹੈ, ਪ੍ਰਦਾਤਾਵਾਂ ਨੂੰ ਬਲੈਕਲਿਸਟ ਕਿਵੇਂ ਕਰਨਾ ਹੈ ਅਤੇ Dashboard → Auto Combo ਵਿੱਚ ਰਾਊਟਿੰਗ ਫੈਸਲਿਆਂ ਦੀ ਜਾਂਚ ਕਿਵੇਂ ਕਰਨੀ ਹੈ, ਸ਼ਾਮਲ ਹੈ।


🔌 MCP ਅਤੇ A2A ਇੰਟੀਗ੍ਰੇਸ਼ਨ

OmniRoute ਇੱਕ MCP ਸਰਵਰ (Model Context Protocol) ਅਤੇ ਇੱਕ A2A ਸਰਵਰ (Agent-to-Agent JSON-RPC 2.0) ਦੋਵੇਂ ਹੈ। ਕੋਈ ਵੀ MCP-ਅਨੁਕੂਲ IDE ਜਾਂ ਏਜੰਟ ਹੋਸਟ OmniRoute ਟੂਲਾਂ ਨੂੰ ਸਿੱਧਾ ਕਾਲ ਕਰ ਸਕਦਾ ਹੈ — ਕਿਸੇ ਵਾਧੂ ਰੈਪਰ ਦੀ ਲੋੜ ਨਹੀਂ।

MCP ਟ੍ਰਾਂਸਪੋਰਟ

  • SSE: http://localhost:20128/api/mcp/sse
  • ਸਟ੍ਰੀਮੇਬਲ HTTP: http://localhost:20128/api/mcp/stream
  • stdio: omniroute --mcp (ਉਨ੍ਹਾਂ IDE ਪਲੱਗਇਨਾਂ ਲਈ ਜੋ stdio ਨੂੰ ਤਰਜੀਹ ਦਿੰਦੇ ਹਨ)

Claude Desktop ਨੂੰ ਕਨੈਕਟ ਕਰੋ

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ਜਾਂ Windows/Linux ਉੱਤੇ ਇਸਦੇ ਬਰਾਬਰ ਦੀ ਫ਼ਾਈਲ ਨੂੰ ਸੰਪਾਦਿਤ ਕਰੋ:

{
  "mcpServers": {
    "omniroute": {
      "command": "omniroute",
      "args": ["--mcp"]
    }
  }
}

Cursor / Continue / VS Code MCP ਨੂੰ ਕਨੈਕਟ ਕਰੋ

SSE URL http://localhost:20128/api/mcp/sse ਅਤੇ Dashboard → API Keys ਵਿੱਚ ਬਣਾਈ ਗਈ ਇੱਕ Bearer API ਕੁੰਜੀ ਵਰਤੋ।

ਸਕੋਪ

MCP ਇਸ ਵੇਲੇ 32 ਨਾਮਿਤ ਸਕੋਪ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦਾ ਹੈ। ਹਰੇਕ Bearer ਕੁੰਜੀ ਨੂੰ ਖਾਸ ਸਕੋਪਾਂ ਤੱਕ ਸੀਮਿਤ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ — ਅਧਿਕਾਰਤ ਸਕੋਪ ਅਤੇ ਟੂਲ ਸੂਚੀ ਲਈ MCP-SERVER.md ਅਤੇ JSON-RPC ਸਕੀਮਾ ਲਈ A2A-SERVER.md ਵੇਖੋ।


🧠 ਹੁਨਰ ਪ੍ਰਣਾਲੀ

OmniRoute ਇੱਕ ਵਿਸਤਾਰਯੋਗ ਹੁਨਰ ਫਰੇਮਵਰਕ (src/lib/skills/) ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ, ਤਾਂ ਜੋ ਏਜੰਟ ਅਤੇ A2A ਐਂਡਪੌਇੰਟ ਡੋਮੇਨ-ਵਿਸ਼ੇਸ਼ ਰੂਟੀਨਾਂ (ਜਿਵੇਂ code-review, summarize, extract-facts, web-research) ਚਲਾ ਸਕਣ।

  • ਮਾਰਕੀਟਪਲੇਸ UIDashboard → Skills ਤੋਂ ਹੁਨਰ ਬ੍ਰਾਊਜ਼ ਅਤੇ ਇੰਸਟਾਲ ਕਰੋ
  • ਪ੍ਰਤੀ-ਕੁੰਜੀ ਸਕੋਪ — ਨਿਯੰਤਰਿਤ ਕਰੋ ਕਿ ਕਿਹੜੀਆਂ API ਕੁੰਜੀਆਂ ਕਿਹੜੇ ਹੁਨਰਾਂ ਨੂੰ ਚਲਾ ਸਕਦੀਆਂ ਹਨ
  • ਕਸਟਮ ਹੁਨਰsrc/lib/a2a/skills/ ਵਿੱਚ ਇੱਕ TypeScript ਫ਼ਾਈਲ ਰੱਖੋ, ਇਸਨੂੰ ਰਜਿਸਟਰ ਕਰੋ, ਅਤੇ ਇਹ ਤੁਰੰਤ A2A ਰਾਹੀਂ ਚਲਾਉਣਯੋਗ ਬਣ ਜਾਂਦੀ ਹੈ

ਪੂਰਾ ਹਵਾਲਾ: SKILLS.md


💾 ਮੈਮੋਰੀ ਪ੍ਰਣਾਲੀ

OmniRoute ਹਾਈਬ੍ਰਿਡ ਪ੍ਰਾਪਤੀ ਨਾਲ ਲੰਬੇ ਸਮੇਂ ਦੀ ਗੱਲਬਾਤੀ ਮੈਮੋਰੀ ਸੰਭਾਲਦਾ ਹੈ:

  • ਪਿਛਲੀਆਂ ਗੱਲਬਾਤਾਂ ਵਿੱਚ ਕੀਵਰਡ ਖੋਜ ਲਈ SQLite FTS5
  • ਅਰਥ-ਆਧਾਰਿਤ ਯਾਦ ਲਈ Qdrant vector store (ਵਿਕਲਪਿਕ)
  • ਆਟੋਮੈਟਿਕ ਤੱਥ ਕੱਢਣਾ — ਹਰ ਸੈਸ਼ਨ ਤੋਂ ਬਾਅਦ ਇਕਾਈਆਂ, ਤਰਜੀਹਾਂ ਅਤੇ ਫ਼ੈਸਲਿਆਂ ਦਾ ਸਾਰ ਬਣਾਇਆ ਜਾਂਦਾ ਹੈ ਅਤੇ memory_facts ਟੇਬਲ ਵਿੱਚ ਸਟੋਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ
  • ਮੈਮੋਰੀਆਂ ਨੂੰ ਪ੍ਰਤੀ API ਕੁੰਜੀ ਅਤੇ ਪ੍ਰਤੀ ਸੈਸ਼ਨ ਸਕੋਪ ਕੀਤਾ ਜਾਂਦਾ ਹੈ

Dashboard → Memory ਵਿੱਚ ਮੈਮੋਰੀਆਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ (ਖੋਜੋ, ਸੰਪਾਦਿਤ ਕਰੋ, ਨਿਰਯਾਤ ਕਰੋ, ਮਿਟਾਓ)। HTTP ਇੰਟਰਫੇਸ (/api/memory/*) ਏਜੰਟਾਂ ਨੂੰ ਪ੍ਰੋਗਰਾਮ ਰਾਹੀਂ ਤੱਥ ਭੇਜਣ ਅਤੇ ਪੁੱਛਗਿੱਛ ਕਰਨ ਦਿੰਦਾ ਹੈ — MEMORY.md ਵੇਖੋ।


🔔 ਵੈੱਬਹੁੱਕ

ਰੀਅਲ-ਟਾਈਮ ਨਿਗਰਾਨੀ ਅਤੇ ਆਟੋਮੇਸ਼ਨ ਲਈ OmniRoute ਇਵੈਂਟਾਂ ਦੀ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਲਓ।

  • ਟਾਰਗੇਟ URL ਅਤੇ HMAC ਸਾਈਨਿੰਗ ਸੀਕ੍ਰੇਟ ਨਾਲ Dashboard → Webhooks ਵਿੱਚ ਇੱਕ ਵੈੱਬਹੁੱਕ ਬਣਾਓ
  • ਉਪਲਬਧ ਇਵੈਂਟ: request.completed, request.failed, provider.unavailable, budget.exceeded, combo.switched, circuit_breaker.opened, circuit_breaker.closed
  • ਤਸਦੀਕ ਲਈ ਹਰੇਕ ਪੇਲੋਡ ਵਿੱਚ X-OmniRoute-Signature (HMAC-SHA256) ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ
  • ਮੁੜ ਕੋਸ਼ਿਸ਼ਾਂ: ਐਕਸਪੋਨੇਨਸ਼ੀਅਲ ਬੈਕਆਫ਼ ਨਾਲ 3 ਕੋਸ਼ਿਸ਼ਾਂ, ਫਿਰ ਡੈੱਡ-ਲੈਟਰ ਕਤਾਰ

ਪੂਰੀ ਸਕੀਮਾ WEBHOOKS.md ਵਿੱਚ ਹੈ।


☁️ ਕਲਾਉਡ ਏਜੰਟ

OmniRoute ਕਲਾਉਡ ਕੋਡਿੰਗ ਏਜੰਟਾਂ (OpenAI Codex Cloud, Devin, Jules, Antigravity) ਨਾਲ ਏਕੀਕ੍ਰਿਤ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਜੋ ਤੁਸੀਂ ਉਸੇ ਡੈਸ਼ਬੋਰਡ ਤੋਂ ਲੰਬੇ ਸਮੇਂ ਤੱਕ ਚੱਲਣ ਵਾਲੇ ਕੰਮ ਭੇਜ ਸਕੋ ਜੋ ਤੁਹਾਡੀ ਸਥਾਨਕ ਰੂਟਿੰਗ ਨੂੰ ਸੰਭਾਲਦਾ ਹੈ।

  • Dashboard → Cloud Agents ਵਿੱਚ ਜਾਂ POST /api/v1/agents/tasks ਰਾਹੀਂ ਕੰਮ ਬਣਾਓ
  • ਹਰੇਕ ਕੰਮ ਦੀ ਸਥਿਤੀ, ਲੌਗ ਅਤੇ ਆਰਟੀਫੈਕਟ ਟ੍ਰੈਕ ਕਰੋ
  • ਹਰੇਕ ਪ੍ਰਦਾਤਾ ਲਈ ਆਪਣੀ API ਕੁੰਜੀ ਵਰਤੋ — ਪ੍ਰਮਾਣ-ਪੱਤਰ ਕਦੇ ਵੀ OmniRoute ਇੰਸਟੈਂਸ ਤੋਂ ਬਾਹਰ ਨਹੀਂ ਜਾਂਦੇ

ਪੂਰਾ ਹਵਾਲਾ: CLOUD_AGENT.md


🛠️ ਪ੍ਰੋਗਰਾਮ ਰਾਹੀਂ ਪ੍ਰਬੰਧਨ

ਤੁਸੀਂ manage ਸਕੋਪ ਵਾਲੀ Bearer ਕੁੰਜੀ ਦੀ ਵਰਤੋਂ ਕਰਕੇ HTTP ਰਾਹੀਂ ਹਰੇਕ OmniRoute ਸਰੋਤ (ਪ੍ਰਦਾਤਾ, ਕੰਬੋ, ਕੁੰਜੀਆਂ, ਸੈਟਿੰਗਾਂ) ਦਾ ਪ੍ਰਬੰਧਨ ਕਰ ਸਕਦੇ ਹੋ।

Dashboard → API Keys → New Key → Scope: manage ਵਿੱਚ ਕੁੰਜੀ ਬਣਾਓ, ਫਿਰ:

# ਪ੍ਰਦਾਤਾਵਾਂ ਦੀ ਸੂਚੀ ਦਿਖਾਓ
curl http://localhost:20128/api/providers \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY"

# ਪ੍ਰਦਾਤਾ ਕਨੈਕਸ਼ਨ ਜੋੜੋ
curl -X POST http://localhost:20128/api/providers \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "openai", "apiKey": "sk-...", "name": "main" }'

# ਕੰਬੋ ਬਣਾਓ
curl -X POST http://localhost:20128/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "premium", "strategy": "priority", "models": [{ "model": "cc/claude-opus-4-7" }, { "model": "glm/glm-5.1" }] }'

# API ਕੁੰਜੀਆਂ ਦੀ ਸੂਚੀ ਦਿਖਾਓ/ਬਣਾਓ
curl http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY"
curl -X POST http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -d '{ "name": "ci-bot", "scopes": ["chat"] }'

ਪੂਰੇ ਐਂਡਪੌਇੰਟ ਕੈਟਾਲੌਗ ਅਤੇ ਬੇਨਤੀ/ਜਵਾਬ ਸਕੀਮਾਵਾਂ ਲਈ API_REFERENCE.md ਵੇਖੋ।


💻 ਅੰਦਰੂਨੀ CLI

OmniRoute ਸੈੱਟਅੱਪ, ਡਾਇਗਨੌਸਟਿਕਸ ਅਤੇ ਰਨਟਾਈਮ ਕੰਟਰੋਲ ਲਈ ਇੱਕ ਅੰਦਰੂਨੀ CLI (omniroute …) ਨਾਲ ਆਉਂਦਾ ਹੈ। ਇਹ ਡੈਸ਼ਬੋਰਡ ਵਿਚਲੇ "CLI ਟੂਲਜ਼" ਪੰਨੇ ਤੋਂ ਵੱਖਰਾ ਹੈ, ਜੋ ਤੀਜੀ-ਧਿਰ ਦੇ CLIs (Claude Code, Cursor, Codex, Cline, …) ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਦਾ ਹੈ ਤਾਂ ਜੋ ਉਹ OmniRoute ਨਾਲ ਸੰਚਾਰ ਕਰ ਸਕਣ।

omniroute setup                    # ਇੰਟਰਐਕਟਿਵ ਵਿਜ਼ਾਰਡ (ਪਾਸਵਰਡ, ਪ੍ਰਦਾਤਾ, ਕਾਂਬੋ)
omniroute setup --non-interactive  # CI-ਅਨੁਕੂਲ
omniroute doctor                   # ਸਿਹਤ ਡਾਇਗਨੌਸਟਿਕਸ (ਡਾਟਾ ਡਾਇਰੈਕਟਰੀ, DB, ਪ੍ਰਦਾਤਾ, ਪੋਰਟ)
omniroute providers available      # ਸਮਰਥਿਤ ਪ੍ਰਦਾਤਾਵਾਂ ਦੀ ਸੂਚੀ
omniroute providers list           # ਕੌਂਫਿਗਰ ਕੀਤੇ ਕਨੈਕਸ਼ਨਾਂ ਦੀ ਸੂਚੀ
omniroute providers test <id>      # ਕਿਸੇ ਪ੍ਰਦਾਤਾ ਕਨੈਕਸ਼ਨ ਦੀ ਲਾਈਵ ਜਾਂਚ
omniroute combos list              # ਕਾਂਬੋਆਂ ਦੀ ਸੂਚੀ
omniroute combos switch <name>     # ਡਿਫਾਲਟ ਕਾਂਬੋ ਸੈੱਟ ਕਰੋ
omniroute models                   # ਉਪਲਬਧ ਮਾਡਲਾਂ ਦੀ ਸੂਚੀ (--json, --search)
omniroute keys add | list | remove # ਟਰਮੀਨਲ ਤੋਂ API ਕੁੰਜੀਆਂ ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ
omniroute backup                   # ਕੌਂਫਿਗ + DB ਦਾ ਸਨੈਪਸ਼ਾਟ
omniroute restore [<timestamp>]    # ਸਨੈਪਸ਼ਾਟ ਤੋਂ ਰੀਸਟੋਰ ਕਰੋ
omniroute health                   # ਵਿਸਤ੍ਰਿਤ ਸਿਹਤ ਜਾਣਕਾਰੀ (ਬ੍ਰੇਕਰ, ਕੈਸ਼, ਮੈਮੋਰੀ)
omniroute quota                    # ਪ੍ਰਦਾਤਾ ਕੋਟੇ ਦੀ ਵਰਤੋਂ
omniroute mcp status               # MCP ਸਰਵਰ ਦੀ ਸਥਿਤੀ
omniroute a2a status               # A2A ਸਰਵਰ ਦੀ ਸਥਿਤੀ
omniroute tunnel list|create|stop  # Cloudflare/Tailscale/ngrok ਟਨਲਾਂ
omniroute reset-password           # ਐਡਮਿਨ ਪਾਸਵਰਡ ਰੀਸੈੱਟ ਕਰੋ
omniroute --mcp                    # stdio ਉੱਤੇ MCP ਸਰਵਰ ਸ਼ੁਰੂ ਕਰੋ
omniroute --port 3000              # ਸਰਵਰ ਨੂੰ ਕਸਟਮ ਪੋਰਟ ਉੱਤੇ ਸ਼ੁਰੂ ਕਰੋ

ਸੁਝਾਅ: ਅਸਿਹਤਮੰਦ ਪ੍ਰਦਾਤਾ ਕਨੈਕਸ਼ਨਾਂ ਬਾਰੇ ਚੇਤਾਵਨੀਆਂ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ omniroute doctor --json ਨੂੰ ਆਪਣੇ ਮਾਨੀਟਰਿੰਗ ਟੂਲ ਨਾਲ ਜੋੜੋ।


🖥️ ਡੈਸਕਟਾਪ ਐਪਲੀਕੇਸ਼ਨ (Electron)

OmniRoute Windows, macOS ਅਤੇ Linux ਲਈ ਮੂਲ ਡੈਸਕਟਾਪ ਐਪਲੀਕੇਸ਼ਨ ਵਜੋਂ ਉਪਲਬਧ ਹੈ।

ਇੰਸਟਾਲੇਸ਼ਨ

# electron ਡਾਇਰੈਕਟਰੀ ਤੋਂ:
cd electron
npm install

# ਡਿਵੈਲਪਮੈਂਟ ਮੋਡ (ਚੱਲ ਰਹੇ Next.js ਡਿਵੈਲਪਮੈਂਟ ਸਰਵਰ ਨਾਲ ਕਨੈਕਟ ਕਰੋ):
npm run dev

# ਪ੍ਰੋਡਕਸ਼ਨ ਮੋਡ (ਸਟੈਂਡਅਲੋਨ ਬਿਲਡ ਦੀ ਵਰਤੋਂ ਕਰਦਾ ਹੈ):
npm start

ਇੰਸਟਾਲਰ ਬਣਾਉਣਾ

cd electron
npm run build          # ਮੌਜੂਦਾ ਪਲੇਟਫਾਰਮ
npm run build:win      # Windows (.exe NSIS)
npm run build:mac      # macOS (.dmg ਯੂਨੀਵਰਸਲ)
npm run build:linux    # Linux (.AppImage)

ਆਉਟਪੁੱਟ → electron/dist-electron/

ਮੁੱਖ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ

ਵਿਸ਼ੇਸ਼ਤਾ ਵੇਰਵਾ
ਸਰਵਰ ਦੀ ਤਿਆਰੀ ਵਿੰਡੋ ਦਿਖਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਸਰਵਰ ਦੀ ਵਾਰ-ਵਾਰ ਜਾਂਚ ਕਰਦਾ ਹੈ (ਕੋਈ ਖਾਲੀ ਸਕ੍ਰੀਨ ਨਹੀਂ)
ਸਿਸਟਮ ਟ੍ਰੇ ਟ੍ਰੇ ਵਿੱਚ ਮਿਨੀਮਾਈਜ਼ ਕਰੋ, ਪੋਰਟ ਬਦਲੋ ਅਤੇ ਟ੍ਰੇ ਮੀਨੂ ਤੋਂ ਬੰਦ ਕਰੋ
ਪੋਰਟ ਪ੍ਰਬੰਧਨ ਟ੍ਰੇ ਤੋਂ ਸਰਵਰ ਪੋਰਟ ਬਦਲੋ (ਸਰਵਰ ਆਪਣੇ ਆਪ ਰੀਸਟਾਰਟ ਹੁੰਦਾ ਹੈ)
ਸਮੱਗਰੀ ਸੁਰੱਖਿਆ ਨੀਤੀ ਸੈਸ਼ਨ ਹੈਡਰਾਂ ਰਾਹੀਂ ਪਾਬੰਦੀਸ਼ੁਦਾ CSP
ਇੱਕੋ ਇੰਸਟੈਂਸ ਇੱਕ ਸਮੇਂ ਐਪ ਦਾ ਸਿਰਫ਼ ਇੱਕ ਇੰਸਟੈਂਸ ਚੱਲ ਸਕਦਾ ਹੈ
ਆਫਲਾਈਨ ਮੋਡ ਬੰਡਲ ਕੀਤਾ Next.js ਸਰਵਰ ਇੰਟਰਨੈੱਟ ਤੋਂ ਬਿਨਾਂ ਕੰਮ ਕਰਦਾ ਹੈ

ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ

ਵੇਰੀਏਬਲ ਡਿਫਾਲਟ ਵੇਰਵਾ
OMNIROUTE_PORT 20128 ਸਰਵਰ ਪੋਰਟ
OMNIROUTE_MEMORY_MB 512 Node.js ਹੀਪ ਸੀਮਾ (6416384 MB)

📖 ਪੂਰਾ ਦਸਤਾਵੇਜ਼: electron/README.md