# đ OmniRoute â ilmainen tekoĂ€lyyhdyskĂ€ytĂ€vĂ€
### ĂlĂ€ koskaan lopeta koodaamista. ĂlykĂ€s reititys **ILMAisiin ja edullisiin tekoĂ€lymalleihin** automaattisella varalla.
_Universaali API-vĂ€lityspalvelin â yksi pÀÀtepiste, yli 67 palveluntarjoajaa, nolla seisokkeja. Nyt **MCP- ja A2A**-agenttiorkesterioinnilla._
**Pikaviestien loppuun saattaminen ⹠upotukset ⹠kuvien luonti ⹠video ⹠musiikki ⹠ÀÀni ⹠uudelleensijoitus ⹠**verkkohaku** ⹠MCP-palvelin ⹠A2A-protokolla ⹠100 % TypeScript**
---
[](https://www.npmjs.com/package/omniroute)
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
[](https://omniroute.online)
[](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
[đ Website](https://omniroute.online) âą [đ Quick Start](#-quick-start) âą [đĄ Features](#-key-features) âą [đ Docs](#-documentation) âą [đ° Pricing](#-pricing-at-a-glance) âą [đŹ WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
đ **Saatavilla:** đșđž [English](README.md) | đ§đ· [PortuguĂȘs (Brasil)](docs/i18n/pt-BR/README.md) | đȘđž [Español](docs/i18n/es/README.md) | đ«đ· [Français](docs/i18n/fr/README.md) | đźđč [Italiano](docs/i18n/it/README.md) | đ·đș [Đ ŃŃŃĐșĐžĐč](docs/i18n/ru/README.md) | đšđł [äžæ (çźäœ)](docs/i18n/zh-CN/README.md) | đ©đȘ [Deutsch](docs/i18n/de/README.md) | đźđł [à€čà€żà€šà„à€Šà„](docs/i18n/in/README.md) | đčđ [àčàžàžą](docs/i18n/th/README.md) | đșđŠ [ĐŁĐșŃаŃĐœŃŃĐșа](docs/i18n/uk-UA/README.md) | đžđŠ [ۧÙŰč۱ۚÙŰ©](docs/i18n/ar/README.md) | đŻđ” [æ„æŹèȘ](docs/i18n/ja/README.md) | đ»đł [Tiáșżng Viá»t](docs/i18n/vi/README.md) | đ§đŹ [ĐŃлгаŃŃĐșĐž](docs/i18n/bg/README.md) | đ©đ° [Dansk](docs/i18n/da/README.md) | đ«đź [Suomi](docs/i18n/fi/README.md) | đźđ± [ŚąŚŚšŚŚȘ](docs/i18n/he/README.md) | đđș [Magyar](docs/i18n/hu/README.md) | đźđ© [Bahasa Indonesia](docs/i18n/id/README.md) | đ°đ· [íê”ìŽ](docs/i18n/ko/README.md) | đČđŸ [Bahasa Melayu](docs/i18n/ms/README.md) | đłđ± [Nederlands](docs/i18n/nl/README.md) | đłđŽ [Norsk](docs/i18n/no/README.md) | đ”đč [PortuguĂȘs (Portugal)](docs/i18n/pt/README.md) | đ·đŽ [RomĂąnÄ](docs/i18n/ro/README.md) | đ”đ± [Polski](docs/i18n/pl/README.md) | đžđ° [SlovenÄina](docs/i18n/sk/README.md) | đžđȘ [Svenska](docs/i18n/sv/README.md) | đ”đ [Filipino](docs/i18n/phi/README.md) | đšđż [ÄeĆĄtina](docs/i18n/cs/README.md)
---
## đ MitĂ€ uutta v3.0.0:ssa
> **PĂ€ivitetÀÀn versiosta 2.9.5?** â Katso kaikki muutokset kohdasta [full CHANGELOG](CHANGELOG.md#300--2026-03-22-release-candidate--not-yet-merged-to-main).
| Alue | Muuta |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| đ **CodeQL-suojaus** | KiinteĂ€t 10+ CodeQL-hĂ€lytystĂ€: polynomi-redot, epĂ€varma satunnaisuus, shell-injektion korjaus |
| â
**Reitin vahvistaminen** | Kaikki 176 API-reittiĂ€ nyt validoitu Zod-skeemoilla + `validateBody()` â CI `check:route-validation:t06` -passit |
| đ **omniModel Tag Leak** | SisĂ€iset `` -tunnisteet eivĂ€t enÀÀ vuoda asiakkaille SSE-suoratoistovastauksissa (#585) |
| đ **Registered Keys API** | MÀÀritĂ€ API-avaimet automaattisesti `POST /api/v1/registered-keys`:n kautta palveluntarjoaja-/tilikiintiön pakottamisen, idempotenssin, SHA-256-tallennustilan ja valinnaisen GitHub-ongelmaraportoinnin avulla |
| đš ** Palveluntarjoajan kuvakkeet** | Yli 130 palveluntarjoajan logoa `@lobehub/icons` (SVG) ja PNG:n kautta â yleinen varaketju |
| đ **Mallin automaattinen synkronointi** | 24 tunnin ajastin ja manuaalinen kĂ€yttöliittymĂ€ synkronoidaksesi malliluettelot sisÀÀnrakennetuille ja mukautetuille OpenAI-yhteensopiville palveluntarjoajille |
| đ **OpenCode Zen/Go** | Kaksi uutta palveluntarjoajaa @kang-heewonilta PR #530:n kautta: ilmainen taso + tilaustaso `OpencodeExecutor` -palvelun kautta |
| đ **Gemini CLI OAuth** | Actionable error when `GEMINI_OAUTH_CLIENT_SECRET` is missing in Docker (was cryptic Google error) |
| đ **OpenCode-mÀÀritys** | `saveOpenCodeConfig()` kirjoittaa nyt oikein TOML:n kohteeseen `XDG_CONFIG_HOME` |
| đ **Kiinnitetyn mallin ohitus** | `body.model` asetettu oikein arvoon `pinnedModel` kontekstivĂ€limuistisuojauksessa |
| đ **Codex/Claude-silmukka** | `tool_result` lohkot muunnetaan nyt tekstiksi loputtomien silmukoiden pysĂ€yttĂ€miseksi |
| đ **Kirjaudun uudelleenohjaus** | Kirjautuminen ei enÀÀ jumiudu salasanan asennuksen vĂ€liin |
| đ **Windows-polut** | MSYS2/Git-Bash-polut (`/c/...`) normalisoituvat automaattisesti arvoon `C:\...` |
---
## đŒïž PÀÀhallintapaneeli
---
## đž Kojelaudan esikatselu
Klikkaa nÀhdÀksesi hallintapaneelin kuvakaappaukset
| Sivu | Kuvakaappaus |
| ---------------- | ------------------------------------------------- |
| **Palvelut** |  |
| **YhdistelmÀt** |  |
| **Analytics** |  |
| **Terveys** |  |
| **KÀÀntÀjÀ** |  |
| **Asetukset** |  |
| **CLI-työkalut** |  |
| **KÀyttölokit** |  |
| **PÀÀtepisteet** |  |
---
### đ€ Ilmainen AI Provider suosikkikoodaajillesi
_YhdistĂ€ mikĂ€ tahansa tekoĂ€lyllĂ€ toimiva IDE- tai CLI-työkalu OmniRouten kautta â ilmainen API-yhdyskĂ€ytĂ€vĂ€ rajoittamattomaan koodaukseen._
đĄ Kaikki edustajat muodostavat yhteyden http://localhost:20128/v1 tai http://cloud.omniroute_EN_OM6/v_1_TO_OM_46/v_1_KONline. konfiguraatio, rajattomat mallit ja kiintiö
---
## đ€ Miksi OmniRoute?
**Lopeta rahan tuhlaaminen ja rajojen ylittÀminen:**
-
Tilauskiintiö vanhenee kÀyttÀmÀttÀ joka kuukausi
-
Nopeusrajoitukset estÀvÀt sinua kesken koodaamisen
-
kalliita sovellusliittymiÀ (20-50 $/kk per tarjoaja)
-
Manuaalinen vaihtaminen palveluntarjoajien vÀlillÀ
**OmniRoute ratkaisee tÀmÀn:**
- â
**Maksimoi tilaukset** - Seuraa kiintiötÀ, kÀytÀ jokainen bitti ennen nollausta
- â
**Automaattinen palautus** - Tilaus â API-avain â Halpa â Ilmainen, nolla seisonta-aikaa
- â
**Moni tili** - PyöreÀ haku tilien vÀlillÀ per palveluntarjoaja
- â
**Universaali** - Toimii Claude Coden, Codexin, Gemini CLI:n, Cursorin, Clinen, OpenClawin ja minkÀ tahansa CLI-työkalun kanssa
---
## đ§ Tuki
> đŹ **Liity yhteisöömme!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) â Hanki apua, jaa vinkkejĂ€ ja pysy ajan tasalla.
- **Verkkosivusto**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Ongelmia**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
- **Osallistuminen**: Katso [CONTRIBUTING.md](CONTRIBUTING.md), avaa PR tai valitse `good first issue`
- **AlkuperÀinen projekti**: [9router by decolua](https://github.com/decolua/9router)
### đ Ilmoita virheestĂ€?
Kun avaat ongelman, suorita system-info-komento ja liitÀ luotu tiedosto:
```bash
npm run system-info
```
TĂ€mĂ€ luo `system-info.txt`, jossa on Node.js-versiosi, OmniRoute-versiosi, kĂ€yttöjĂ€rjestelmĂ€tiedot, asennetut CLI-työkalut (iflow, gemini, claude, codex, antigravity, droidi jne.), Docker/PM2-tila ja jĂ€rjestelmĂ€paketit â kaikki, mitĂ€ tarvitsemme ongelmasi nopeaan toistamiseen. LiitĂ€ tiedosto suoraan GitHub-ongelmaasi.
---
## đ NĂ€in se toimii
```
âââââââââââââââ
â Your CLI â (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
â Tool â
ââââââââŹâââââââ
â http://localhost:20128/v1
â
âââââââââââââââââââââââââââââââââââââââââââ
â OmniRoute (Smart Router) â
â âą Format translation (OpenAI â Claude) â
â âą Quota tracking + Embeddings + Images â
â âą Auto token refresh â
ââââââââŹâââââââââââââââââââââââââââââââââââ
â
âââ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
â â quota exhausted
âââ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
â â budget limit
âââ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
â â budget limit
âââ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited)
Result: Never stop coding, minimal cost
```
---
## đŻ MitĂ€ OmniRoute ratkaisee â 30 todellista kipukohtaa ja kĂ€yttötapausta
> **Jokainen tekoĂ€lytyökaluja kĂ€yttĂ€vĂ€ kehittĂ€jĂ€ kohtaa nĂ€mĂ€ ongelmat pĂ€ivittĂ€in.** OmniRoute luotiin ratkaisemaan ne kaikki â kustannusten ylityksistĂ€ alueellisiin lohkoihin, rikkinĂ€isistĂ€ OAuth-virroista protokollatoimintoihin ja yrityksen havainnointikykyyn.
đž 1. "Maksan kalliista tilauksesta, mutta silti rajoitukset hĂ€iritsevĂ€t minua"
KehittĂ€jĂ€t maksavat 20â200 dollaria kuukaudessa Claude Prosta, Codex Prosta tai GitHub Copilotista. Maksamallakin kiintiöllĂ€ on katto â 5 tuntia kĂ€yttöÀ, viikkorajat tai minuuttirajoitukset. Koodausistunnon puolivĂ€lissĂ€ palveluntarjoaja lakkaa vastaamasta ja kehittĂ€jĂ€ menettÀÀ virtauksen ja tuottavuuden.
**Kuinka OmniRoute ratkaisee sen:**
- **Smart 4-Tier Fallback** â Jos tilauskiintiö loppuu, ohjataan automaattisesti kohtaan API-avain â Halpa â Ilmainen ilman manuaalista toimenpiteitĂ€
- **Reaaliaikainen kiintiöseuranta** - NÀyttÀÀ tunnuksen kulutuksen reaaliajassa ja nollaa lÀhtölaskenta (5 tuntia, pÀivittÀin, viikoittain)
- **Useiden tilien tuki** â Useita tilejĂ€ palveluntarjoajaa kohden automaattisella kierrĂ€tyksellĂ€ â kun yksi loppuu, vaihtuu seuraavaan
- **Muokatut yhdistelmĂ€t** â Muokattavat varaketjut, joissa on 6 tasapainotusstrategiaa (tĂ€ytĂ€ ensin, round-robin, P2C, satunnainen, vĂ€hiten kĂ€ytetty, kustannusoptimoitu)
- **Codex Business Quotat** â Yritysten/Tiimien työtilan kiintiöiden valvonta suoraan kojelaudassa
đ 2. "Minun tĂ€ytyy kĂ€yttÀÀ useita palveluntarjoajia, mutta jokaisella on eri sovellusliittymĂ€"
OpenAI kÀyttÀÀ yhtÀ muotoa, Claude (Anthropic) kÀyttÀÀ toista, Gemini vielÀ toista. Jos kehittÀjÀ haluaa testata eri palveluntarjoajien malleja tai vaihtoehtoja niiden vÀlillÀ, hÀnen on mÀÀritettÀvÀ SDK:t uudelleen, muutettava pÀÀtepisteitÀ ja kÀsiteltÀvÀ yhteensopimattomia muotoja. Mukautetuilla palveluntarjoajilla (FriendLI, NIM) on mallista poikkeavat pÀÀtepisteet.
**Kuinka OmniRoute ratkaisee sen:**
- **Yhdistetty pÀÀtepiste** â Yksi `http://localhost:20128/v1` toimii vĂ€lityspalvelimena kaikille yli 67 palveluntarjoajalle
- **Format Translation** - Automaattinen ja lĂ€pinĂ€kyvĂ€: OpenAI â Claude â Gemini â Responses API
- **Response Sanitization** â Poistaa standardista poikkeavat kentĂ€t (`x_groq`, `usage_breakdown`, `service_tier`), jotka rikkovat OpenAI SDK v1.83+:n
- **Roolin normalisointi** â Muuntaa `developer` â `system` muille kuin OpenAI-palveluntarjoajille; `system` â `user` GLM:lle/ERNIE:lle
- **Think Tag Extraction** - Purkaa `` lohkoa malleista, kuten DeepSeek R1, standardoituun `reasoning_content`
- **Strukturoitu tulos Geminille** â `json_schema` â `responseMimeType`/`responseSchema` automaattinen muunnos
- **`stream` oletusarvo on `false`** - linjaa OpenAI-spesifikaation, vÀlttÀen odottamattomat SSE:t Python/Rust/Go SDK:issa
đ 3. "TekoĂ€lypalveluntarjoajani estÀÀ alueeni/maani"
Palveluntarjoajat, kuten OpenAI/Codex, estÀvÀt pÀÀsyn tietyiltÀ maantieteellisiltÀ alueilta. KÀyttÀjÀt saavat virheitÀ, kuten `unsupported_country_region_territory` OAuth- ja API-yhteyksien aikana. TÀmÀ on erityisen turhauttavaa kehitysmaiden kehittÀjille.
**Kuinka OmniRoute ratkaisee sen:**
- **3-tason vĂ€lityspalvelimen mÀÀritys** â Muokattava vĂ€lityspalvelin kolmella tasolla: yleinen (kaikki liikenne), palveluntarjoajakohtainen (vain yksi palveluntarjoaja) ja yhteys/avain
- **VĂ€rikoodatut vĂ€lityspalvelinmerkit** â Visuaaliset ilmaisimet: đą maailmanlaajuinen vĂ€lityspalvelin, đĄ tarjoajan vĂ€lityspalvelin, đ” yhteysvĂ€lityspalvelin, joka nĂ€yttÀÀ aina IP-osoitteen
- **OAuth-tunnusten vaihto vĂ€lityspalvelimen kautta** â OAuth-kulku kulkee myös vĂ€lityspalvelimen kautta ja ratkaisee `unsupported_country_region_territory`
- **Yhteystestit vÀlityspalvelimen kautta** - Yhteystestit kÀyttÀvÀt mÀÀritettyÀ vÀlityspalvelinta (ei enÀÀ suoraa ohitusta)
- **SOCKS5-tuki** â TĂ€ysi SOCKS5-vĂ€lityspalvelintuki lĂ€htevÀÀn reititykseen
- **TLS-sormenjĂ€lkien huijaus** â Selaimen kaltainen TLS-sormenjĂ€lki `wreq-js`-toiminnon kautta robotin tunnistuksen ohittamiseksi
- **đ CLI Fingerprint Matching** â JĂ€rjestÀÀ otsikot ja tekstikentĂ€t uudelleen vastaamaan alkuperĂ€isiĂ€ CLI-binÀÀriallekirjoituksia, mikĂ€ vĂ€hentÀÀ merkittĂ€vĂ€sti tilin ilmoittamisriskiĂ€. VĂ€lityspalvelimen IP-osoite sĂ€ilyy â saat sekĂ€ salaperĂ€isen **- ettĂ€** IP-peitetyksen samanaikaisesti
đ 4. "Haluan kĂ€yttÀÀ tekoĂ€lyĂ€ koodaukseen, mutta minulla ei ole rahaa"
Kaikki eivĂ€t voi maksaa 20â200 dollaria kuukaudessa tekoĂ€lytilauksista. Opiskelijat, kehittĂ€jĂ€t nousevista maista, harrastajat ja freelancerit tarvitsevat pÀÀsyn laadukkaisiin malleihin ilman kustannuksia.
**Kuinka OmniRoute ratkaisee sen:**
- **Free Tier Providers Built-in** â Natiivituki 100 % ilmaisille palveluntarjoajille: iFlow (5 rajoittamaton mallia OAuthin kautta: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen-mallit: 4 unqlim-plus3 qwen3-coder-flash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID ilmaiseksi), Gemini CLI (180 000 tokenia / kuukausi ilmaiseksi)
- **Ollama Cloud** â pilvipalvelussa isĂ€nnöityjĂ€ Ollama-malleja osoitteessa `api.ollama.com` ilmaisella "kevytkĂ€yttö"-tasolla; kĂ€ytĂ€ `ollamacloud/`-etuliitettĂ€
- **Vain ilmaiset yhdistelmĂ€t** â ketju `gc/gemini-3-flash â if/kimi-k2-thinking â qw/qwen3-coder-plus` = 0 $/kk ilman seisokkeja
- **NVIDIA NIM Free Access** - ~40 RPM:n kehittÀjÀ - ikuisesti ilmainen pÀÀsy yli 70 malliin osoitteessa build.nvidia.com (siirrytÀÀn hyvityksistÀ puhtaisiin hintarajoihin)
- **Kustannusoptimoitu strategia** â Reititysstrategia, joka valitsee automaattisesti halvimman saatavilla olevan palveluntarjoajan
đ 5. "Minun on suojattava tekoĂ€lyyhdyskĂ€ytĂ€vĂ€ni luvattomalta kĂ€ytöltĂ€"
Kun paljastat tekoÀlyyhdyskÀytÀvÀn verkkoon (LAN, VPS, Docker), kuka tahansa osoitteen tietÀvÀ voi kuluttaa kehittÀjÀn tunnukset/kiintiöt. Ilman suojaa API:t ovat alttiita vÀÀrinkÀytölle, nopealle injektiolle ja vÀÀrinkÀytöksille.
**Kuinka OmniRoute ratkaisee sen:**
- **API-avainten hallinta** â Luominen, kierto ja laajuus palveluntarjoajakohtaisesti erillisellĂ€ `/dashboard/api-manager`-sivulla
- **Mallitason kÀyttöoikeudet** - Rajoita API-avaimet tiettyihin malleihin (`openai/*`, jokerimerkkimallit) Salli kaikki/Rajoita -kytkimellÀ
- **API Endpoint Protection** â Vaadi avainta kohteelle `/v1/models` ja estĂ€ tietyt palveluntarjoajat luettelosta
- **Auth Guard + CSRF-suojaus** â Kaikki kojelaudan reitit on suojattu `withAuth`-vĂ€liohjelmistolla + CSRF-tunnuksilla
- **Rate Limiter** â IP-nopeuden rajoitus konfiguroitavilla ikkunoilla
- **IP-suodatus** â PÀÀsynhallinnan sallittu-/estolista
- **Prompt Injection Guard** â Desinfiointi haitallisia kehotusmalleja vastaan
- **AES-256-GCM Encryption** â Tunnistetiedot on salattu lepotilassa
đ 6. "Palvelajani kaatui ja menetin koodauskulkuni"
TekoÀlypalveluntarjoajat voivat muuttua epÀvakaiksi, palauttaa 5xx-virheitÀ tai saavuttaa vÀliaikaiset nopeusrajoitukset. Jos kehittÀjÀ on riippuvainen yhdestÀ palveluntarjoajasta, se keskeytyy. Ilman katkaisijoita toistuvat uudelleenyritykset voivat kaataa sovelluksen.
**Kuinka OmniRoute ratkaisee sen:**
- **Malleittainen katkaisija** - Automaattinen avautuminen/sulkeminen konfiguroitavilla kynnyksillÀ ja jÀÀhdytys (suljettu/auki/puoliauki), mallikohtainen, jotta vÀltetÀÀn perÀkkÀiset lohkot
- **Eksponentiaalinen peruutus** â Progressiiviset uudelleenyritysviiveet
- **Anti-Thundering Herd** â Mutex + semaforisuoja samanaikaisia myrskyjĂ€ vastaan
- **YhdistelmĂ€varaketjut** â Jos ensisijainen toimittaja epĂ€onnistuu, putoaa automaattisesti ketjun lĂ€pi ilman vĂ€liintuloa
- **Combo Circuit Breaker** â Poistaa automaattisesti kĂ€ytöstĂ€ vialliset palveluntarjoajat yhdistelmĂ€ketjussa
- **Health Dashboard** â kĂ€ytettĂ€vyyden valvonta, katkaisijoiden tilat, lukitukset, vĂ€limuistitilastot, p50/p95/p99-viive
đ§ 7. "Jokaisen tekoĂ€lytyökalun mÀÀrittĂ€minen on työlĂ€stĂ€ ja toistuvaa"
KehittÀjÀt kÀyttÀvÀt kursoria, Claude Codea, Codex CLI:tÀ, OpenClaw:ta, Gemini CLI:tÀ, Kilo Codea... Jokainen työkalu tarvitsee eri konfiguraation (API-pÀÀtepiste, avain, malli). UudelleenmÀÀritys toimittajaa tai mallia vaihdettaessa on ajanhukkaa.
**Kuinka OmniRoute ratkaisee sen:**
- **CLI Tools Dashboard** - Erillinen sivu yhdellÀ napsautuksella Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
- **GitHub Copilot Config Generator** - Luo `chatLanguageModels.json` VS-koodille joukkomallin valinnalla
- **Ohjattu kĂ€yttöönottotoiminto** â Ohjattu 4-vaiheinen asennus ensikertalaisille
- **Yksi pÀÀtepiste, kaikki mallit** â MÀÀritĂ€ `http://localhost:20128/v1` kerran, kĂ€ytĂ€ 67+ palveluntarjoajaa
đ 8. "OAuth-tunnusten hallinta useilta palveluntarjoajilta on helvettiĂ€"
Claude Code, Codex, Gemini CLI, Copilot â kaikki kĂ€yttĂ€vĂ€t OAuth 2.0:aa vanhentuvilla tunnuksilla. KehittĂ€jien on todennettava uudelleen jatkuvasti, kĂ€siteltĂ€vĂ€ `client_secret is missing`-, `redirect_uri_mismatch`- ja etĂ€palvelimien vikoja. OAuth LAN/VPS:ssĂ€ on erityisen ongelmallinen.
**Kuinka OmniRoute ratkaisee sen:**
- **Automaattinen tunnuksen pÀivitys** - OAuth-tunnukset pÀivittyvÀt taustalla ennen vanhenemista
- **SisÀÀnrakennettu OAuth 2.0 (PKCE)** - Automaattinen kulku Claude Codelle, Codexille, Gemini CLI:lle, Copilotille, Kirolle, Qwenille, iFlowille
- **Multi-Account OAuth** - Useita tilejÀ palveluntarjoajaa kohden JWT/ID-tunnuksen purkamisen kautta
- **OAuth LAN/Remote Fix** - Yksityinen IP-tunnistus kohteelle `redirect_uri` + manuaalinen URL-tila etÀpalvelimille
- **OAuth Nginxin takana** - KÀyttÀÀ `window.location.origin` kÀÀnteisen vÀlityspalvelimen yhteensopivuutta varten
- **OAuth-etĂ€opas** â Vaiheittainen opas Google Cloud -kirjautumistiedoille VPS/Dockerissa
đ 9. "En tiedĂ€ kuinka paljon kulutan tai minne"
KehittÀjÀt kÀyttÀvÀt useita maksullisia palveluntarjoajia, mutta heillÀ ei ole yhtenÀistÀ nÀkemystÀ kuluttamisesta. Jokaisella palveluntarjoajalla on oma laskutuksen hallintapaneeli, mutta yhdistettyÀ nÀkymÀÀ ei ole. Odottamattomat kustannukset voivat kasaantua.
**Kuinka OmniRoute ratkaisee sen:**
- **Cost Analytics Dashboard** â Token-kohtainen kustannusseuranta ja budjetin hallinta palveluntarjoajakohtaisesti
- **Tasokohtaiset budjettirajat** â Tasokohtainen kulutuskatto, joka laukaisee automaattisen varauksen
- **Malleittainen hinnoittelu** â Muokattavat hinnat mallikohtaisesti
- **KĂ€yttötilastot API-avainta kohti** â PyyntömÀÀrĂ€ ja viimeksi kĂ€ytetty aikaleima avainta kohti
- **Analytics Dashboard** - Tilastokortit, mallin kÀyttökaavio, toimittajataulukko onnistumisprosenteilla ja viiveellÀ
đ 10. "En voi diagnosoida virheitĂ€ ja ongelmia tekoĂ€lykutsuissa"
Kun puhelu epÀonnistuu, kehittÀjÀ ei tiedÀ, oliko kyseessÀ nopeusrajoitus, vanhentunut tunnus, vÀÀrÀ muoto vai palveluntarjoajan virhe. Sirpaloituneet lokit eri terminaaleissa. Ilman havaittavuutta virheenkorjaus on yrityksen ja erehdysten menetelmÀÀ.
**Kuinka OmniRoute ratkaisee sen:**
- **Yhdistettyjen lokien hallintapaneeli** - 4 vÀlilehteÀ: pyyntölokit, vÀlityspalvelimen lokit, tarkastuslokit, konsoli
- **Console Log Viewer** - Reaaliaikainen pÀÀtetyylinen katseluohjelma vÀrikoodatuilla tasoilla, automaattinen vieritys, haku, suodatin
- **SQLite-vĂ€lityspalvelimen lokit** â PysyvĂ€t lokit, jotka kestĂ€vĂ€t palvelimen uudelleenkĂ€ynnistyksen
- **KÀÀntĂ€jĂ€n leikkikenttĂ€** â 4 virheenkorjaustilaa: Playground (muodon kÀÀnnös), Chat Tester (meno-paluu), testipenkki (erĂ€), Live Monitor (reaaliaikainen)
- **Pyyntötelemetria** â p50/p95/p99-latenssi + X-Request-Id-seuranta
- **Tiedostopohjainen kirjaaminen rotaatiolla** â Konsolin sieppaaja tallentaa kaiken JSON-lokiin kokoperusteisella kierrolla
- **JĂ€rjestelmĂ€tietoraportti** â `npm run system-info` luo `system-info.txt` koko ympĂ€ristössĂ€si (Node-versio, OmniRoute-versio, kĂ€yttöjĂ€rjestelmĂ€, CLI-työkalut, Docker/PM2-tila). LiitĂ€ se, kun ilmoitat ongelmista vĂ€littömĂ€ssĂ€ triagessa.
đïž 11. "YhdyskĂ€ytĂ€vĂ€n kĂ€yttöönotto ja yllĂ€pito on monimutkaista"
AI-vÀlityspalvelimen asentaminen, mÀÀrittÀminen ja yllÀpito eri ympÀristöissÀ (paikallinen, VPS, Docker, pilvi) on työvoimavaltaista. Ongelmat, kuten kovakoodatut polut, `EACCES` hakemistoissa, porttiristiriidat ja eri alustojen koontiversiot lisÀÀvÀt kitkaa.
**Kuinka OmniRoute ratkaisee sen:**
- **npm yleinen asennus** â `npm install -g omniroute && omniroute` â valmis
- **Docker Multi-Platform** - AMD64 + ARM64 natiivi (Apple Silicon, AWS Graviton, Raspberry Pi)
- **Docker Compose -profiilit** â `base` (ei CLI-työkaluja) ja `cli` (Claude Coden, Codexin, OpenClawn kanssa)
- **Electron Desktop App** - Natiivisovellus Windowsille/macOS:lle/Linuxille, jossa ilmaisinalue, automaattinen kÀynnistys, offline-tila
- **Split-Port Mode** â API ja Dashboard erillisissĂ€ porteissa edistyneille skenaarioille (kÀÀnteinen vĂ€lityspalvelin, konttiverkko)
- **Cloud Sync** - MÀÀritÀ synkronointi laitteiden vÀlillÀ Cloudflare Workersin kautta
- **DB-varmuuskopiot** â Kaikkien asetusten automaattinen varmuuskopiointi, palautus, vienti ja tuonti
đ 12. "KĂ€yttöliittymĂ€ on vain englanninkielinen ja tiimini ei puhu englantia"
RyhmÀt muissa kuin englanninkielisissÀ maissa, erityisesti Latinalaisessa Amerikassa, Aasiassa ja Euroopassa, kamppailevat vain englanninkielisten kÀyttöliittymien kanssa. Kielimuurit vÀhentÀvÀt kÀyttöönottoa ja lisÀÀvÀt konfigurointivirheitÀ.
**Kuinka OmniRoute ratkaisee sen:**
- **Dashboard i18n â 30 kieltĂ€** â Kaikki yli 500 nĂ€ppĂ€intĂ€ kÀÀnnetty mukaan lukien arabia, bulgaria, tanska, saksa, espanja, suomi, ranska, heprea, hindi, unkari, indonesia, italia, japani, korea, malaiji, hollanti, norja, puola, portugali (PT/BR), romania, thai, venĂ€jĂ€, slovakki, ruotsi, vietnam, filippiini
- **RTL-tuki** â Tuki oikealta vasemmalle arabian ja heprean kielelle
- **Multi-Language READMEs** - 30 tÀydellistÀ dokumentaation kÀÀnnöstÀ
- **Kielen valitsin** â Maapallokuvake otsikossa reaaliaikaista vaihtoa varten
đ 13. "Tarvitsen muutakin kuin chatin â tarvitsen upotuksia, kuvia, ÀÀntĂ€"
TekoÀly ei ole vain chatin loppuun saattamista. KehittÀjien on luotava kuvia, litteroitava ÀÀni, luotava upotuksia RAG:lle, jÀrjestettÀvÀ asiakirjat uudelleen ja valvottava sisÀltöÀ. Jokaisella API:lla on eri pÀÀtepiste ja muoto.
**Kuinka OmniRoute ratkaisee sen:**
- **Upotukset** â `/v1/embeddings` 6 toimittajalla ja 9+ mallilla
- **Kuvan luominen** â `/v1/images/generations` 10 palveluntarjoajan ja 20+ mallin kanssa (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
- **TekstistĂ€ videoon** â `/v1/videos/generations` â ComfyUI (AnimateDiff, SVD) ja SD WebUI
- **TekstistĂ€ musiikiksi** â `/v1/music/generations` â ComfyUI (Stable Audio Open, MusicGen)
- **ĂĂ€nitranskriptio** â `/v1/audio/transcriptions` â Whisper + Nvidia NIM, HuggingFace, Qwen3
- **TekstistĂ€ puheeksi** â `/v1/audio/speech` â ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3, **Inworld**, **Cartesia**, **PlayHT** ja olemassa olevat palveluntarjoajat
- **Moderointi** - `/v1/moderations` - SisÀllön turvallisuustarkastukset
- **Uudelleensijoitus** - `/v1/rerank` - Asiakirjan osuvuuden uudelleensijoitus
- **Responses API** - TĂ€ysi `/v1/responses` tuki Codexille
đ§Ș 14. "Minulla ei ole tapaa testata ja vertailla eri mallien laatua"
KehittĂ€jĂ€t haluavat tietÀÀ, mikĂ€ malli sopii parhaiten heidĂ€n kĂ€yttötapaukseensa â koodi, kÀÀnnös, pÀÀttely â mutta manuaalinen vertailu on hidasta. Integroituja arviointityökaluja ei ole olemassa.
**Kuinka OmniRoute ratkaisee sen:**
- **LLM-arvioinnit** â Golden set -testaus, jossa on 10 esiladattua tapausta, jotka kattavat tervehdyksen, matematiikan, maantieteen, koodin luomisen, JSON-yhteensopivuuden, kÀÀnnöksen, merkinnĂ€n, turvallisuuden kieltĂ€misen
- **4 ottelustrategiaa** â `exact`, `contains`, `regex`, `custom` (JS-toiminto)
- **Translator Playground Test Bench** - ErÀtestaus useilla tuloilla ja odotetulla lÀhdöllÀ, tarjoajien vÀlinen vertailu
- **Chat Tester** - TÀysi edestakainen matka visuaalisen vasteen renderöinnillÀ
- **Live Monitor** â Reaaliaikainen tietovirta kaikista vĂ€lityspalvelimen kautta kulkevista pyynnöistĂ€
đ 15. "Minun tĂ€ytyy skaalata suorituskykyĂ€ menettĂ€mĂ€ttĂ€"
Pyynnön mÀÀrĂ€n kasvaessa samat kysymykset aiheuttavat pÀÀllekkĂ€isiĂ€ kustannuksia vĂ€limuistiin tallentamatta. Without idempotency, duplicate requests waste processing. Palveluntarjoajakohtaisia ââhintarajoja on noudatettava.
**Kuinka OmniRoute ratkaisee sen:**
- **Semanttinen vĂ€limuisti** â Kaksitasoinen vĂ€limuisti (allekirjoitus + semanttinen) vĂ€hentÀÀ kustannuksia ja viivettĂ€
- **Request Idempotency** â 5 sekunnin deduplikaatioikkuna identtisille pyynnöille
- **nopeusrajoituksen tunnistus** â palveluntarjoajakohtainen RPM, pienin vĂ€li ja suurin samanaikainen seuranta
- **Muokattavat nopeusrajoitukset** - MÀÀritettĂ€vissĂ€ olevat oletusasetukset kohdassa Asetukset â Resilience with persistence
- **API Key Validation Cache** â 3-tasoinen vĂ€limuisti tuotannon suorituskykyĂ€ varten
- **Health Dashboard telemetrialla** - p50/p95/p99 latenssi, vÀlimuistitilastot, kÀyttöaika
đ€ 16. "Haluan hallita mallin kĂ€yttĂ€ytymistĂ€ maailmanlaajuisesti"
KehittÀjÀt, jotka haluavat kaikki vastaukset tietyllÀ kielellÀ, tietyllÀ sÀvyllÀ tai haluavat rajoittaa perusteluita. TÀmÀn mÀÀrittÀminen jokaiseen työkaluun/pyyntöön on epÀkÀytÀnnöllistÀ.
**Kuinka OmniRoute ratkaisee sen:**
- **JĂ€rjestelmĂ€kehotteen lisĂ€ys** â Yleinen kehote koskee kaikkia pyyntöjĂ€
- **Thinking Budget Validation** â perustelutunnisteen allokoinnin ohjaus pyyntöÀ kohti (lĂ€pivienti, automaattinen, mukautettu, mukautuva)
- **6 reititysstrategiaa** â Globaalit strategiat, jotka mÀÀrittĂ€vĂ€t pyyntöjen jakautumisen
- **Wildcard Router** - `provider/*` kuviot reitittÀvÀt dynaamisesti mille tahansa palveluntarjoajalle
- **YhdistelmÀ kÀyttöön/pois kÀytöstÀ** - Vaihda yhdistelmÀt suoraan kojelaudalta
- **Provider Toggle** â Ota kĂ€yttöön tai poista kĂ€ytöstĂ€ kaikki palveluntarjoajan yhteydet yhdellĂ€ napsautuksella
- **Estetyt palveluntarjoajat** - Sulje tietyt palveluntarjoajat pois `/v1/models`-listalta
𧰠17. "Tarvitsen MCP-työkaluja ensiluokkaisina tuoteominaisuuksina"
Monet tekoÀlyyhdyskÀytÀvÀt paljastavat MCP:n vain piilotettuna toteutustietona. Tiimit tarvitsevat nÀkyvÀn, hallittavan toimintakerroksen.
**Kuinka OmniRoute ratkaisee sen:**
- MCP nÀkyy kojelaudan navigointi- ja pÀÀtepisteprotokolla-vÀlilehdessÀ
- Erillinen MCP-hallintasivu, jossa on prosessit, työkalut, laajuudet ja tarkastus
- SisÀÀnrakennettu pika-aloitus `omniroute --mcp` ja asiakkaan kÀyttöönottoon
đ§ 18. "Tarvitsen A2A-orkesterin synkronointi- ja suoratoistopolkuilla"
Agenttityönkulut tarvitsevat sekÀ suoria vastauksia ettÀ pitkÀkestoista suoratoistoa elinkaariohjauksella.
**Kuinka OmniRoute ratkaisee sen:**
- A2A JSON-RPC -pÀÀtepiste (`POST /a2a`) ja `message/send` ja `message/stream`
- SSE-suoratoisto pÀÀtetilan etenemisellÀ
- TehtÀvÀn elinkaaren sovellusliittymÀt kohteille `tasks/get` ja `tasks/cancel`
đ°ïž 19. "Tarvitsen todellisen MCP-prosessin kunnon, en arvattua tilaa"
Operatiivisten tiimien on tiedettÀvÀ, onko MCP todella elossa, ei vain sitÀ, onko API tavoitettavissa.
**Kuinka OmniRoute ratkaisee sen:**
- Ajonaikainen syketiedosto, jossa on PID, aikaleimat, kuljetus, työkalujen mÀÀrÀ ja laajuustila
- MCP-tilan API, joka yhdistÀÀ sykkeen + viimeaikaisen toiminnan
- KÀyttöliittymÀn tilakortit prosessin / kÀytettÀvyyden / sydÀmenlyöntien tuoreudelle
đ 20. "Tarvitsen tarkastettavan MCP-työkalun suorituksen"
Kun työkalut muuttavat mÀÀrityksiÀ tai kÀynnistÀvÀt operaatioita, tiimit tarvitsevat rikosteknistÀ jÀljitettÀvyyttÀ.
**Kuinka OmniRoute ratkaisee sen:**
- SQLite-tuettu tarkastusloki MCP-työkalukutsuille
- Suodattimet työkalun, onnistumisen/epÀonnistumisen, API-avaimen ja sivutuksen mukaan
- Kojelaudan tarkastustaulukko + tilastopÀÀtepisteet automatisointia varten
đ 21. "Tarvitsen laajennetut MCP-oikeudet integraatiota kohti"
Eri asiakkailla tulisi olla vÀhiten kÀyttöoikeus työkaluluokkiin.
**Kuinka OmniRoute ratkaisee sen:**
- 9 rakeista MCP-skooppia ohjattua työkalujen kÀyttöÀ varten
- Laajuuden valvonta ja nÀkyvyys MCP-hallintaliittymÀssÀ
- Turvallinen oletusasento kÀyttötyökaluille
âïž 22. "Tarvitsen toiminnan ohjaimia ilman uudelleensijoittamista"
Tiimit tarvitsevat nopeita ajonaikaisia muutoksia tapausten tai kustannustapahtumien aikana.
**Kuinka OmniRoute ratkaisee sen:**
- Vaihda yhdistelmÀaktivointia suoraan MCP-kojelaudalta
- KÀytÀ joustavuusprofiileja ennalta mÀÀritetyistÀ kÀytÀntöpaketeista
- Nollaa katkaisijan tila samasta kÀyttöpaneelista
đ 23. "Tarvitsen live-A2A-tehtĂ€vĂ€n elinkaaren nĂ€kyvyyden ja peruutuksen"
Ilman elinkaaren nÀkyvyyttÀ tehtÀvÀkohtauksista tulee vaikeasti luokiteltuja.
**Kuinka OmniRoute ratkaisee sen:**
- TehtÀvÀluettelo / suodatus tilan / taitojen mukaan ja sivutus
- TehtÀvÀn metatietojen, tapahtumien ja artefaktien yksityiskohdat
- TehtÀvÀn peruutuksen pÀÀtepiste ja kÀyttöliittymÀtoiminto vahvistuksen kanssa
đ 24. "Tarvitsen aktiivisia suoratoistotietoja A2A-kuormitukseen"
Streaming-työnkulut edellyttÀvÀt toiminnallista tietoa samanaikaisuudesta ja reaaliaikaisista yhteyksistÀ.
**Kuinka OmniRoute ratkaisee sen:**
- Aktiiviset virtalaskurit integroitu A2A-tilaan
- Viimeisen tehtÀvÀn aikaleima ja tilakohtaiset mÀÀrÀt
- A2A kojelautakortit reaaliaikaiseen toimintojen seurantaan
đȘȘ 25. "Tarvitsen asiakkaille vakioagentin haun"
Ulkoiset asiakkaat ja orkesterit tarvitsevat koneellisesti luettavaa metadataa kÀyttöönottoa varten.
**Kuinka OmniRoute ratkaisee sen:**
- Agenttikortti esillÀ osoitteessa `/.well-known/agent.json`
- Johdon kÀyttöliittymÀssÀ nÀkyvÀt valmiudet ja taidot
- A2A status API sisÀltÀÀ etsintÀmetatiedot automatisointia varten
đ§ 26. "Tarvitsen protokollan löydettĂ€vyyden tuotteessa UX"
Jos kÀyttÀjÀt eivÀt löydÀ protokollapintoja, kÀyttöönoton ja tuen laatu heikkenee.
**Kuinka OmniRoute ratkaisee sen:**
- Yhdistetty **PÀÀtepisteet**-sivu, jossa on vÀlilehdet vÀlityspalvelin-, MCP-, A2A- ja API-pÀÀtepisteille
- Inline-palvelun tila vaihtuu (Online/Offline) MCP:lle ja A2A:lle
- Linkit yleiskatsauksesta erityisiin hallintavÀlilehtiin
đ§Ș 27. "Tarvitsen pÀÀstĂ€ pÀÀhĂ€n -protokollan validoinnin oikeiden asiakkaiden kanssa"
Valetestit eivÀt riitÀ vahvistamaan protokollan yhteensopivuutta ennen julkaisua.
**Kuinka OmniRoute ratkaisee sen:**
- E2E-paketti, joka kÀynnistÀÀ sovelluksen ja kÀyttÀÀ todellista MCP SDK -asiakassiirtoa
- A2A-asiakas testaa virtojen löytÀmistÀ, lÀhettÀmistÀ, suoratoistoa, vastaanottamista ja peruuttamista
- Tarkista vÀitteet MCP-tarkastuksen ja A2A-tehtÀvien sovellusliittymien kanssa
đĄ 28. "Tarvitsen yhtenĂ€isen havainnoinnin kaikissa liitĂ€nnöissĂ€"
Havainnon jakaminen protokollan mukaan luo kuolleita kulmia ja pidemmÀn MTTR:n.
**Kuinka OmniRoute ratkaisee sen:**
- Yhdistetyt kojelaudat/lokit/analytiikka yhdessÀ tuotteessa
- Terveys + auditointi + pyyntö telemetria OpenAI-, MCP- ja A2A-tasoilla
- Toiminnalliset sovellusliittymÀt tilaa ja automaatiota varten
đŒ 29. "Tarvitsen yhden suoritusajan vĂ€lityspalvelimelle + työkaluille + agentin orkestroinnille"
Useiden erillisten palvelujen suorittaminen lisÀÀ kÀyttökustannuksia ja vikatiloja.
**Kuinka OmniRoute ratkaisee sen:**
- OpenAI-yhteensopiva vÀlityspalvelin, MCP-palvelin ja A2A-palvelin yhdessÀ pinossa
- Jaettu todennus, joustavuus, tietovarasto ja havaittavuus
- Yhdenmukainen toimintamalli kaikilla vuorovaikutuspinnoilla
đ 30. "Minun on lĂ€hetettĂ€vĂ€ agenttityönkulkuja ilman liimakoodin leviĂ€mistĂ€"
Tiimit menettÀvÀt nopeutta yhdistÀessÀÀn useita ad-hoc-palveluita ja skriptejÀ.
**Kuinka OmniRoute ratkaisee sen:**
- YhtenÀinen pÀÀtepistestrategia asiakkaille ja edustajille
- SisÀÀnrakennetut protokollien hallinnan kÀyttöliittymÀt ja savun vahvistuspolut
- Tuotantovalmis perusta (turvallisuus, puunkorjuu, joustavuus, varmuuskopiointi)
### Esimerkkiohjekirjat (integroidut kÀyttötapaukset)
**Ohjekirja A: maksimoi maksullinen tilaus + halpa varmuuskopio**
```txt
Combo: "maximize-claude"
1. cc/claude-opus-4-6
2. glm/glm-4.7
3. if/kimi-k2-thinking
Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption
```
**Ohjekirja B: Nollahintainen koodauspino**
```txt
Combo: "free-forever"
1. gc/gemini-3-flash
2. if/kimi-k2-thinking
3. qw/qwen3-coder-plus
Monthly cost: $0
Outcome: stable free coding workflow
```
**Playbook C: 24/7 aina pÀÀllÀ oleva varaketju**
```txt
Combo: "always-on"
1. cc/claude-opus-4-6
2. cx/gpt-5.2-codex
3. glm/glm-4.7
4. minimax/MiniMax-M2.1
5. if/kimi-k2-thinking
Outcome: deep fallback depth for deadline-critical workloads
```
**Pelikirja D: Agentti toimii MCP:llÀ + A2A**
```txt
1) Start MCP transport (`omniroute --mcp`) for tool-driven operations
2) Run A2A tasks via `message/send` and `message/stream`
3) Observe via /dashboard/endpoint (MCP and A2A tabs)
4) Toggle services via inline status controls
```
---
## đ Aloita ilmaiseksi â nolla konfigurointikustannuksia
> MÀÀritÀ AI-koodaus minuuteissa hintaan **0 $/kk**. YhdistÀ nÀmÀ ilmaiset tilit ja kÀytÀ sisÀÀnrakennettua **Free Stack** -yhdistelmÀÀ.
| Vaihe | Toiminta | Palveluntarjoajat avattu |
| ----- | -------------------------------------------------- | ---------------------------------------------------------------------- |
| 1 | YhdistĂ€ **Kiro** (AWS Builder ID OAuth) | Claude Sonnet 4.5, Haiku 4.5 â **rajaton** |
| 2 | YhdistĂ€ **iFlow** (Google OAuth) | kimi-k2-ajattelu, qwen3-coder-plus, deepseek-r1... â **rajoittamaton** |
| 3 | YhdistĂ€ **Qwen** (laitekoodi) | qwen3-coder-plus, qwen3-coder-flash... â **rajoittamaton** |
| 4 | YhdistĂ€ **Gemini CLI** (Google OAuth) | gemini-3-flash, gemini-2.5-pro â **180K/kk ilmaiseksi** |
| 5 | `/dashboard/combos` â **Ilmainen pino ($0)** malli | Round-robin kaikki ilmaiset palveluntarjoajat automaattisesti |
**Osoita mikÀ tahansa IDE/CLI:** `http://localhost:20128/v1` · API-avain: `any-string` · Valmis.
> **Valinnainen lisÀkattavuus (myös ilmainen):** Groq API-avain (30 RPM ilmaiseksi), NVIDIA NIM (40 RPM ilmaiseksi, 70+ mallit), Cerebras (1 milj. tk/vrk), LongCat API-avain (50 milj. tokenia/pÀivÀ!), Cloudflare Workers AI (10 000 neuronia/vrk, 50+ mallia).
## ⥠Pika-aloitus
### 1) Asenna ja suorita
```bash
npm install -g omniroute
omniroute
```
> **pnpm-kÀyttÀjÀt:** Suorita `pnpm approve-builds -g` asennuksen jÀlkeen ottaaksesi kÀyttöön `better-sqlite3` ja `@swc/core` vaatimat alkuperÀiset koontiskriptit:
>
> ```bash
> pnpm install -g omniroute
> pnpm approve-builds -g # Select all packages â approve
> omniroute
> ```
Hallintapaneeli avautuu osoitteessa `http://localhost:20128` ja API-perus-URL on `http://localhost:20128/v1`.
| Komento | Kuvaus |
| ----------------------- | -------------------------------------------------------------------- |
| `omniroute` | KÀynnistÀ palvelin (`PORT=20128`, API ja kojelauta samassa portissa) |
| `omniroute --port 3000` | Aseta kanoninen/API-portiksi 3000 |
| `omniroute --mcp` | KÀynnistÀ MCP-palvelin (stdio-kuljetus) |
| `omniroute --no-open` | ĂlĂ€ avaa selainta automaattisesti |
| `omniroute --help` | NÀytÀ ohje |
Valinnainen jaettu porttitila:
```bash
PORT=20128 DASHBOARD_PORT=20129 omniroute
# API: http://localhost:20128/v1
# Dashboard: http://localhost:20129
```
### 2) YhdistÀ palveluntarjoajat ja luo API-avain
1. Avaa Dashboard â `Providers` ja yhdistĂ€ vĂ€hintÀÀn yksi palveluntarjoaja (OAuth- tai API-avain).
2. Avaa Dashboard â `Endpoints` ja luo API-avain.
3. (Valinnainen) Avaa Dashboard â `Combos` ja aseta varaketju.
### 3) Osoita koodaustyökalusi kohtaan OmniRoute
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Endpoint page]
Model: if/kimi-k2-thinking (or any provider/model prefix)
```
Toimii Claude Coden, Codex CLI:n, Gemini CLI:n, Cursorin, Clinen, OpenClawn, OpenCoden ja OpenAI-yhteensopivien SDK:iden kanssa.
### 4) Ota protokollat kÀyttöön ja vahvista ne (v2.0)
**MCP (työkaluohjattuihin toimintoihin):**
```bash
omniroute --mcp
```
YhdistÀ sitten MCP-asiakas `stdio`:n kautta ja testaa työkaluja, kuten:
- `omniroute_get_health`
- `omniroute_list_combos`
**A2A (agenttien vÀlisille työnkuluille):**
```bash
curl http://localhost:20128/.well-known/agent.json
```
```bash
curl -X POST http://localhost:20128/a2a \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'
```
### 5) Vahvista kaikki pÀÀstÀ pÀÀhÀn (suositus)
```bash
npm run test:protocols:e2e
```
TÀmÀ sarja vahvistaa todelliset MCP- ja A2A-asiakasvirrat kÀynnissÀ olevaa sovellusta vastaan.
### Vaihtoehto: suorita lÀhteestÀ
```bash
cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev
```
---
## đł Docker
OmniRoute on saatavilla julkisena Docker-kuvana osoitteessa [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
**Pikaajo:**
```bash
docker run -d \
--name omniroute \
--restart unless-stopped \
-p 20128:20128 \
-v omniroute-data:/app/data \
diegosouzapw/omniroute:latest
```
**YmpÀristötiedostolla:**
```bash
# Copy and edit .env first
cp .env.example .env
docker run -d \
--name omniroute \
--restart unless-stopped \
--env-file .env \
-p 20128:20128 \
-v omniroute-data:/app/data \
diegosouzapw/omniroute:latest
```
**Docker Composen kÀyttÀminen:**
```bash
# Base profile (no CLI tools)
docker compose --profile base up -d
# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d
```
| Kuva | Tag | Koko | Kuvaus |
| ------------------------ | -------- | ------- | -------------------- |
| `diegosouzapw/omniroute` | `latest` | ~250 Mt | Uusin vakaa julkaisu |
| `diegosouzapw/omniroute` | `1.0.3` | ~250 Mt | Nykyinen versio |
---
## đ„ïž TyöpöytĂ€sovellus â offline-tilassa ja aina pÀÀllĂ€
> đ **UUSI!** OmniRoute on nyt saatavilla **alkuperĂ€isenĂ€ työpöytĂ€sovelluksena** Windowsille, macOS:lle ja Linuxille.
Suorita OmniRoute itsenĂ€isenĂ€ työpöytĂ€sovelluksena â ei pÀÀtelaitetta, ei selainta, ei vaadi InternetiĂ€ paikallisiin malleihin. Elektronipohjainen sovellus sisĂ€ltÀÀ:
- đ„ïž **AlkuperĂ€inen ikkuna** - Erillinen sovellusikkuna, jossa on integrointi jĂ€rjestelmĂ€lokeroon
- đ **Automaattinen kĂ€ynnistys** â KĂ€ynnistĂ€ OmniRoute jĂ€rjestelmÀÀn kirjautuessasi
- đ **AlkuperĂ€iset ilmoitukset** - Saat ilmoituksia kiintiön loppumisesta tai palveluntarjoajan ongelmista
- ⥠**Asennus yhdellĂ€ napsautuksella** â NSIS (Windows), DMG (macOS), AppImage (Linux)
- đ **Offline-tila** â Toimii tĂ€ysin offline-tilassa mukana toimitetun palvelimen kanssa
### Pikaopas
```bash
# Development mode
npm run electron:dev
# Build for your platform
npm run electron:build # Current platform
npm run electron:build:win # Windows (.exe)
npm run electron:build:mac # macOS (.dmg) â x64 & arm64
npm run electron:build:linux # Linux (.AppImage)
```
### JÀrjestelmÀalusta
Kun OmniRoute on minimoitu, se elÀÀ ilmaisinalueellasi nopeilla toimilla:
- Avaa kojelauta
- Vaihda palvelimen portti
- Lopeta sovellus
đ Koko dokumentaatio: [**OMNI_TOKEN_153**](electron/README.md)
---
## đ° Hinnoittelu yhdellĂ€ silmĂ€yksellĂ€
| Taso | Palveluntarjoaja | Kustannukset | Kiintiön nollaus | Paras |
| ---------------- | --------------------------- | ----------------------------------- | ---------------------- | ---------------------------------- |
| **đł TILAUS** | Claude Code (Pro) | 20 dollaria/kk | 5h + viikoittain | jo tilattu |
| | Codex (Plus/Pro) | 20-200 $/kk | 5h + viikoittain | OpenAI-kÀyttÀjÀt |
| | Gemini CLI | **ILMAINEN** | 180 tk/kk + 1 tk/pÀivÀ | Kaikki! |
| | GitHub Copilot | 10-19 $/kk | Kuukausittain | GitHub-kÀyttÀjÀt |
| **đ API-AVAIN** | NVIDIA NIM | **ILMAINEN** (kehittĂ€jĂ€ ikuisesti) | ~40 rpm | 70+ avointa mallia |
| | Aivot | **ILMAINEN** (1M tok/pÀivÀ) | 60K TPM / 30 RPM | Maailman nopein |
| | Groq | **ILMAINEN** (30 RPM) | 14.4K RPD | ErittÀin nopea Llama/Gemma |
| | DeepSeek V3.2 | 0,27 $/1,10 $ per 1 milj | Ei yhtÀÀn | Paras hinta/laatu perustelu |
| | xAI Grok-4 Fast | **0,20 $/0,50 $ per 1 milj** đ | Ei yhtÀÀn | Nopein + työkalukutsu, ultralow |
| | xAI Grok-4 (vakio) | 0,20 $/1,50 $ per 1 milj đ | Ei yhtÀÀn | PÀÀttelyn lippulaiva xAI:lta |
| | Mistral | Ilmainen kokeilu + maksullinen | Hinta rajoitettu | Eurooppalainen tekoÀly |
| | OpenRouter | Maksu per kÀyttö | Ei yhtÀÀn | 100+ mallia agr. |
| **đ° EDULLISET** | GLM-5 (Z.AI:n kautta) đ | 0,5 $/1 milj. | PĂ€ivittĂ€in klo 10 | 128K lĂ€htö, uusin lippulaiva |
| | GLM-4.7 | 0,6 $/1 milj. | PÀivittÀin klo 10 | Budjetin varmuuskopio |
| | MiniMax M2.5 đ | 0,3 $/1 milj. tulo | 5 tunnin rullaus | PÀÀttely + agenttitehtĂ€vĂ€t |
| | MiniMax M2.1 | 0,2 $/1 milj. | 5 tunnin rullaus | Halvin vaihtoehto |
| | Kimi K2.5 (Moonshot API) đ | Maksu per kĂ€yttö | Ei yhtÀÀn | Suora Moonshot API -kĂ€yttö |
| | Kimi K2 | 9 dollaria/kk asunto | 10 milj. rahakkeita/kk | Ennustettavat kustannukset |
| **đ ILMAINEN** | iFlow | **0 $** | Rajoittamaton | 5 mallia rajoittamaton |
| | Qwen | **0 $** | Rajoittamaton | 4 mallia rajoittamaton |
| | Kiro | **0 $** | Rajoittamaton | Claude Sonnet/Haiku (AWS Builder) |
| | LongCat Flash-Lite đ | **0 $** (50 milj. tok/pĂ€ivĂ€ đ„) | 1 RPS | Suurin ilmainen kiintiö maailmassa |
| | Pölytys AI đ | **0 $** (avainta ei tarvita) | 1 kpl/15 s | GPT-5, Claude, DeepSeek, Llama 4 |
| | Cloudflare Workers AI đ | **0 $** (10 000 neuronia/pĂ€ivĂ€) | ~150 tk/pĂ€ivĂ€ | Yli 50 mallia, globaali reuna |
| | Scaleway AI đ | **0 $** (yhteensĂ€ 1 milj. tokeneja) | Hinta rajoitettu | EU/GDPR, Qwen3 235B, Llama 70B |
> đ **Uusia malleja lisĂ€tty (maaliskuu 2026):** Grok-4 Fast -perhe hintaan 0,20 $/0,50 $/M (vertailu 1143 ms â 30 % nopeampi kuin Gemini 2.5 Flash), GLM-5 Z.AI:n kautta 128K:n lĂ€hdöllĂ€, MiniMax M2.5 Vc3:n kautta. Moonshot Direct API.
**đĄ 0 dollarin yhdistelmĂ€pino â tĂ€ydellinen ilmainen asennus:**
```
# đ Ultimate Free Stack 2026 â 11 Providers, $0 Forever
Kiro (kr/) â Claude Sonnet/Haiku UNLIMITED
iFlow (if/) â kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
LongCat Lite (lc/) â LongCat-Flash-Lite â 50M tokens/day đ„
Pollinations (pol/) â GPT-5, Claude, DeepSeek, Llama 4 â no key needed
Qwen (qw/) â qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED
Gemini (gemini/) â Gemini 2.5 Flash â 1,500 req/day free API key
Cloudflare AI (cf/) â Llama 70B, Gemma 3, Mistral â 10K Neurons/day
Scaleway (scw/) â Qwen3 235B, Llama 70B â 1M free tokens (EU)
Groq (groq/) â Llama/Gemma ultra-fast â 14.4K req/day
NVIDIA NIM (nvidia/) â 70+ open models â 40 RPM forever
Cerebras (cerebras/) â Llama/Qwen world-fastest â 1M tok/day
```
** Nolla kustannuksia. Ei koskaan lopeta koodausta.** MÀÀritĂ€ tĂ€mĂ€ yhdeksi OmniRoute-yhdistelmĂ€ksi, ja kaikki palautukset tapahtuvat automaattisesti â ei manuaalista vaihtoa koskaan.
---
---
## đ Ilmaiset mallit â mitĂ€ todella saat
> Kaikki alla olevat mallit ovat **100 % ilmaisia ilman luottokorttia**. OmniRoute reitittÀÀ automaattisesti niiden vĂ€lillĂ€, kun yksi kiintiö loppuu â yhdistĂ€ ne kaikki rikkomattomaksi 0 dollarin yhdistelmĂ€ksi.
### đ” CLAUDE MALLIT (Kiron kautta â AWS Builder ID)
| Malli | Etuliite | Raja | Hintarajoitus |
| ------------------- | -------- | ----------------- | ----------------------------------- |
| `claude-sonnet-4.5` | `kr/` | **Rajoittamaton** | Ei raportoitu pÀivittÀistÀ ylÀrajaa |
| `claude-haiku-4.5` | `kr/` | **Rajoittamaton** | Ei raportoitu pÀivittÀistÀ ylÀrajaa |
| `claude-opus-4.6` | `kr/` | **Rajoittamaton** | Uusin Opus kautta Kiro |
### đą IFLOW-MALLIT (ilmainen OAuth â ei luottokorttia)
| Malli | Etuliite | Raja | Hintarajoitus |
| ------------------ | -------- | ----------------- | --------------------- |
| `kimi-k2-thinking` | `if/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `qwen3-coder-plus` | `if/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `deepseek-r1` | `if/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `minimax-m2.1` | `if/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `kimi-k2` | `if/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
### đĄ QWEN-MALLIT (laitekoodin todennus)
| Malli | Etuliite | Raja | Hintarajoitus |
| ------------------- | -------- | ----------------- | ----------------------- |
| `qwen3-coder-plus` | `qw/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `qwen3-coder-flash` | `qw/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `qwen3-coder-next` | `qw/` | **Rajoittamaton** | Ei ilmoitettu ylÀraja |
| `vision-model` | `qw/` | **Rajoittamaton** | Multimodaalinen (kuvat) |
### đŁ GEMINI CLI (Google OAuth)
| Malli | Etuliite | Raja | Hintarajoitus |
| ------------------------ | -------- | -------------------------- | ----------------------- |
| `gemini-3-flash-preview` | `gc/` | **180 tk/kk** + 1 tk/pÀivÀ | Kuukausittainen nollaus |
| `gemini-2.5-pro` | `gc/` | 180 000/kk (jaettu pool) | Korkea laatu |
### â« NVIDIA NIM (ilmainen API-avain â build.nvidia.com)
| Taso | PÀivÀraja | Hintarajoitus | Huomautuksia |
| -------------------- | ---------------- | ------------- | ------------------------------------------------------------------------- |
| Ilmainen (kehittÀjÀ) | Ei tunnuskorkkia | **~40 RPM** | 70+ mallia; siirtyminen puhtaisiin korkorajoihin vuoden 2025 puolivÀlissÀ |
Suositut ilmaiset mallit: `moonshotai/kimi-k2.5` (Kimi K2.5), `z-ai/glm4.7` (GLM 4.7), `deepseek-ai/deepseek-v3.2` (DeepSeek V3.2), `nvidia/llama-3.3-70b-instruct`\_, \_\_EN_18
### âȘ CEREBRAS (ilmainen API-avain â inference.cerebras.ai)
| Taso | PÀivÀraja | Hintarajoitus | Huomautuksia |
| -------- | ---------------------------- | ---------------- | -------------------------------------------------- |
| Ilmainen | **1 milj. rahakkeita/pÀivÀ** | 60K TPM / 30 RPM | Maailman nopein LLM-pÀÀtelmÀ; nollautuu pÀivittÀin |
Saatavilla ilmaiseksi: `llama-3.3-70b`, `llama-3.1-8b`, `deepseek-r1-distill-llama-70b`
### đŽ GROQ (ilmainen API-avain â console.groq.com)
| Taso | PÀivÀraja | Hintarajoitus | Huomautuksia |
| -------- | ------------- | -------------------- | ------------------------------------------- |
| Ilmainen | **14.4K RPD** | 30 rpm mallia kohden | Ei luottokorttia; 429 rajalla, ei veloiteta |
Saatavilla ilmaiseksi: `llama-3.3-70b-versatile`, `gemma2-9b-it`, `mixtral-8x7b`, `whisper-large-v3`
### đŽ LONGCAT AI (ilmainen API-avain â longcat.chat) đ
| Malli | Etuliite | PÀivittÀinen ilmainen kiintiö | Huomautuksia |
| ----------------------------- | -------- | ----------------------------- | ------------------------------- |
| `LongCat-Flash-Lite` | `lc/` | **50 milj. rahakkeita** đ„ | Suurin ilmainen kiintiö koskaan |
| `LongCat-Flash-Chat` | `lc/` | 500 000 kuponkia | Monipuolinen chat |
| `LongCat-Flash-Thinking` | `lc/` | 500 000 kuponkia | PÀÀttely / CoT |
| `LongCat-Flash-Thinking-2601` | `lc/` | 500 000 kuponkia | Tammikuun 2026 versio |
| `LongCat-Flash-Omni-2603` | `lc/` | 500 000 kuponkia | Multimodaalinen |
> 100 % ilmainen julkisessa beta-tilassa. Rekisteröidy osoitteessa [longcat.chat](https://longcat.chat) sÀhköpostitse tai puhelimitse. Nollautuu pÀivittÀin 00:00 UTC.
### đą POLLINATIONS AI (Ei vaadi API-avainta) đ
| Malli | Etuliite | Hintarajoitus | Toimittaja Takana |
| ---------- | -------- | ------------- | ------------------- |
| `openai` | `pol/` | 1 tarve/15 s | GPT-5 |
| `claude` | `pol/` | 1 tarve/15 s | Antrooppinen Claude |
| `gemini` | `pol/` | 1 tarve/15 s | Google Gemini |
| `deepseek` | `pol/` | 1 tarve/15 s | DeepSeek V3 |
| `llama` | `pol/` | 1 tarve/15 s | Meta Llama 4 Scout |
| `mistral` | `pol/` | 1 tarve/15 s | Mistral AI |
> ⚠**Nolla kitkaa:** Ei rekisteröitymistÀ, ei API-avainta. LisÀÀ Pollinations-palveluntarjoaja tyhjÀllÀ avainkentÀllÀ ja se toimii vÀlittömÀsti.
### đ CLOUDFLARE WORKERS AI (ilmainen API-avain â cloudflare.com) đ
| Taso | PÀivittÀiset neuronit | Vastaava kÀyttö | Huomautuksia |
| -------- | --------------------- | --------------------------------------------- | ------------------------------------ |
| Ilmainen | **10 000** | ~150 LLM vastinetta / 500s audio / 15K upotus | Maailmanlaajuinen etu, yli 50 mallia |
Suositut ilmaiset mallit: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (ilmainen ÀÀni!), `@cf/qwen/qwen2.5-coder-15b-instruct`
> Vaatii API-tunnuksen + tilitunnuksen osoitteesta [dash.cloudflare.com](https://dash.cloudflare.com). Tallenna tilitunnus palveluntarjoajan asetuksiin.
### 𣣠SCALEWAY AI (1 milj. ilmaista merkkiĂ€ â scaleway.com) đ
| Taso | Ilmainen kiintiö | Sijainti | Notes |
| -------- | ---------------------- | -------------- | --------------------------------- |
| Ilmainen | **1 milj. rahakkeita** | đ«đ· Pariisi, EU | Luottokorttia ei tarvita rajoissa |
Saatavilla ilmaiseksi: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`
> EU/GDPR-yhteensopiva. Hanki API-avain osoitteesta [console.scaleway.com](https://console.scaleway.com).
> **đĄ The Ultimate Free Stack (11 tarjoajaa, 0 dollaria ikuisesti):**
>
> ```
> Kiro (kr/) â Claude Sonnet/Haiku UNLIMITED
> iFlow (if/) â kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
> LongCat Lite (lc/) â LongCat-Flash-Lite â 50M tokens/day đ„
> Pollinations (pol/) â GPT-5, Claude, DeepSeek, Llama 4 â no key needed
> Qwen (qw/) â qwen3-coder models UNLIMITED
> Gemini (gemini/) â Gemini 2.5 Flash â 1,500 req/day free
> Cloudflare AI (cf/) â 50+ models â 10K Neurons/day
> Scaleway (scw/) â Qwen3 235B, Llama 70B â 1M free tokens (EU)
> Groq (groq/) â Llama/Gemma â 14.4K req/day ultra-fast
> NVIDIA NIM (nvidia/) â 70+ open models â 40 RPM forever
> Cerebras (cerebras/) â Llama/Qwen world-fastest â 1M tok/day
> ```
## đïž Ilmainen transkriptioyhdistelmĂ€
> Literoi mikĂ€ tahansa ÀÀni/video hintaan **$0** â Deepgram-johdot 200 dollarilla ilmaiseksi, AssemblyAI 50 dollarin varavara, Groq Whisper rajoittamattomana hĂ€tĂ€varmuuskopiona.
| Palveluntarjoaja | Ilmaisia ââluottoja | Paras malli | Hintarajoitus |
| ----------------- | ------------------------------------------- | -------------------------------------------------- | --------------------------------------- |
| đą **Deepgram** | **200 dollaria ilmaiseksi** (kirjautuminen) | `nova-3` â paras tarkkuus, yli 30 kieltĂ€ | Ei RPM-rajoitusta ilmaisille luottoille |
| đ” **AssemblyAI** | **50 dollaria ilmaiseksi** (kirjautuminen) | `universal-3-pro` â luvut, tunnelma, henkilötiedot | Ei RPM-rajoitusta ilmaisille luottoille |
| đŽ **Groq** | **Ilmainen ikuisesti** | `whisper-large-v3` â OpenAI Whisper | 30 RPM (nopeus rajoitettu) |
**Ehdotettu yhdistelmÀ kohteessa `/dashboard/combos`:**
```
Name: free-transcription
Strategy: Priority
Nodes:
[1] deepgram/nova-3 â uses $200 free first
[2] assemblyai/universal-3-pro â fallback when Deepgram credits run out
[3] groq/whisper-large-v3 â free forever, emergency fallback
```
Sitten `/dashboard/media` â **Transkriptio**-vĂ€lilehti: lataa mikĂ€ tahansa ÀÀni- tai videotiedosto â valitse yhdistelmĂ€pÀÀtepiste â hanki transkriptio tuetuissa muodoissa.
## đĄ TĂ€rkeimmĂ€t ominaisuudet
OmniRoute v2.0 on rakennettu toiminnalliseksi alustaksi, ei vain vÀlityspalvelimeksi.
### đ Uutta â ClawRouterin inspiroimia parannuksia (maaliskuu 2026)
| Ominaisuus | MitÀ se tekee |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| ⥠**Grok-4 Fast Family** | xAI-mallit hintaan 0,20 $/0,50 $/M â vertailuarvo 1143 ms (30 % nopeampi kuin Gemini 2.5 Flash) |
| đ§ **GLM-5 Z.AI:n kautta** | 128 000 tuloskonteksti, 0,5 $/1 milj. GLM-perheen uusin lippulaiva |
| đź **MiniMax M2.5** | PÀÀttely + agenttitehtĂ€vĂ€t hintaan 0,30 $/1M â merkittĂ€vĂ€ parannus M2.1:stĂ€ |
| đŻ **ToolCalling Flag mallikohtainen** | Mallikohtainen `toolCalling: true/false` rekisterissĂ€ â AutoCombo ohittaa mallit, joissa ei ole työkaluja |
| đ **Monikielinen tarkoituksentunnistus** | PT/ZH/ES/AR avainsanat AutoCombo-pisteytyksissĂ€ â parempi mallivalinta ei-englanninkieliselle sisĂ€llölle |
| đ **Vertailuarvoihin perustuvat varaehdotukset** | Todellinen p95-viive live-pyyntöjen syötteiden yhdistelmĂ€pisteistĂ€ â AutoCombo oppii todellisista tiedoista |
| đ **PyydĂ€ pÀÀllekkĂ€isyyden poistamista** | SisĂ€ltö-hash-pohjainen dedup-ikkuna â turvallinen usealle agentille, estÀÀ pÀÀllekkĂ€iset veloitukset |
| đ **Pluggable RouterStrategy** | Laajennettava `RouterStrategy`-kĂ€yttöliittymĂ€ â lisÀÀ mukautettu reitityslogiikka laajennuksiksi |
### đ Edellinen v2.0.9+ â leikkikenttĂ€, CLI-sormenjĂ€ljet ja ACP
| Ominaisuus | MitÀ se tekee |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| đź **Model Playground** | Dashboard-sivu minkĂ€ tahansa mallin testaamiseen suoraan â palveluntarjoajan/mallin/pÀÀtepisteen valitsimet, Monaco Editor, suoratoisto, keskeytys, ajoitus |
| đ **CLI-sormenjĂ€lkien vastaavuus** | Palveluntarjoajakohtainen otsikko/runkojĂ€rjestys vastaamaan alkuperĂ€isiĂ€ CLI-allekirjoituksia â vaihda palveluntarjoajan mukaan kohdassa Asetukset > Suojaus. **VĂ€lipalvelimesi IP-osoite sĂ€ilyy** |
| đ€ **ACP-tuki (Agent Client Protocol)** | CLI-agentin etsintĂ€ (Codex, Claude, Goose, Gemini CLI, OpenClaw + 9 muuta), prosessin luonti, `/api/acp/agents` pÀÀtepiste |
| đ€ **ACP Agents Dashboard** | VianetsintĂ€ âș Agentit -sivu â 14 agentin ruudukko, jossa on asennustila, versio ja mukautettu agenttilomake mille tahansa CLI-työkalulle. **OpenCode**-kĂ€yttĂ€jĂ€t saavat "Download opencode.json" -painikkeen, joka luo automaattisesti kĂ€yttövalmiin kokoonpanon kaikille saatavilla oleville malleille. |
| đ§ **Mukautettu malli `apiFormat` Reititys** | Mukautetut mallit, joissa on `apiFormat: "responses"`, ohjaavat nyt oikein Responses API -kÀÀntĂ€jÀÀn |
| đą ** Codex Workspace Isolation** | Useita Codex-työtiloja sĂ€hköpostissa â OAuth erottaa yhteydet oikein työtilan tunnuksen |
| đ **Automaattinen elektroninen pĂ€ivitys** | TyöpöytĂ€sovellus tarkistaa pĂ€ivitykset + automaattinen asennus uudelleenkĂ€ynnistyksen yhteydessĂ€ |
### đ€ Agentti- ja protokollatoiminnot (v2.0)
| Ominaisuus | MitÀ se tekee |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| đ§ **MCP-palvelin (16 työkalua)** | IDE/agenttityökalut kolmen siirron kautta: stdio, SSE (`/api/mcp/sse`), Streamable HTTP (`/api/mcp/stream`) |
| đ€ **A2A-palvelin (JSON-RPC + SSE)** | Agenttien vĂ€linen tehtĂ€vien suorittaminen synkronointi- ja suoratoistovirroilla |
| đ§ **Konsolidoitu pÀÀtepistesivu** | VĂ€lilehdillĂ€ varustettu hallintasivu Endpoint Proxy-, MCP-, A2A- ja API Endpoints -vĂ€lilehdillĂ€ |
| đïž **Palvelun kĂ€yttöönoton/poistamisen valinnat** | ON/OFF kytkimet MCP:lle ja A2A:lle ja asetusten pysyvyys (oletus: OFF) |
| đ°ïž **MCP Runtime Heartbeat** | Todellinen prosessin tila (pid, kĂ€ytettĂ€vyys, sykeikĂ€, kuljetus, mittaustila) |
| đ **MCP Audit Trail** | Suodatettavat tarkastuslokit onnistumis/epĂ€onnistuminen ja avainattribuutio |
| đ **MCP Scope Enforcement** | 9 tarkkoja kĂ€yttöoikeuksia työkalujen ohjattuun kĂ€yttöön |
| đĄ **A2A-tehtĂ€vĂ€n elinkaaren hallinta** | Listaa/suodata tehtĂ€viĂ€, tarkasta tapahtumat/artefaktit, peruuta kĂ€ynnissĂ€ olevat tehtĂ€vĂ€t |
| đ **Agenttikortin löytĂ€minen** | `/.well-known/agent.json` asiakkaan automaattiseen löytĂ€miseen |
| đ§Ș **Protokollan E2E-testivaljaat** | Todellinen MCP SDK + A2A-asiakasvirta `test:protocols:e2e` |
| âïž **Toimintaohjaimet** | Vaihda yhdistelmĂ€, kĂ€ytĂ€ kimmoisuusprofiileja, nollaa katkaisijat yhdeltĂ€ ohjauspinnalta |
### đ§ Reititys ja Ă€lykkyys
| Ominaisuus | MitÀ se tekee |
| ------------------------------------- | --------------------------------------------------------------------------------------- |
| đŻ **Smart 4-Tier Fallback** | Automaattinen reitti: Tilaus â API-avain â Halpa â Ilmainen |
| đ **Reaaliaikainen kiintiöseuranta** | Live-tunnusten mÀÀrĂ€ + nollaa lĂ€htölaskenta palveluntarjoajaa kohti |
| đ **KÀÀnnösmuoto** | OpenAI â Claude â Gemini â Vastaukset skeematurvallisilla muunnoksilla |
| đ„ **Useiden tilien tuki** | Useita tilejĂ€ per palveluntarjoaja Ă€lykkÀÀllĂ€ valinnalla |
| đ **Automaattinen Token Refresh** | OAuth-tunnukset pĂ€ivittyvĂ€t automaattisesti yrittĂ€mĂ€llĂ€ uudelleen |
| đš **Muokatut yhdistelmĂ€t** | 6 tasapainotusstrategiaa + varaketjun ohjaus |
| đ **Wildcard-reititin** | `provider/*` dynaaminen reititys |
| đ§ **Ajatteleva budjettihallinta** | LĂ€pivienti-, automaatti-, mukautetut ja mukautuvat pÀÀttelyrajat |
| đ **Mallialiakset** | SisÀÀnrakennettu + mukautetun mallin alias ja siirtoturva |
| ⥠**Taustan heikkeneminen** | Ohjaa matalan prioriteetin taustatehtÀvÀt halvempiin malleihin |
| đ§Ș **Task-Aware Smart Routing** | Automaattinen mallin valinta sisĂ€ltötyypin mukaan (koodaus/nĂ€kemys/analyysi/yhteenveto) |
| đŹ **JĂ€rjestelmĂ€n pikaruiskutus** | Globaalia kĂ€yttĂ€ytymisen valvontaa sovelletaan johdonmukaisesti |
| đ **Responses API -yhteensopivuus** | TĂ€ysi `/v1/responses` tuki Codexille ja edistyneille agenttityönkuluille |
### đ” Multimodaaliset sovellusliittymĂ€t
| Ominaisuus | MitÀ se tekee |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| đŒïž **Kuvan luominen** | `/v1/images/generations` pilvellĂ€ ja paikallisilla taustaohjelmilla |
| đ **Upotukset** | `/v1/embeddings` haku- ja RAG-putkistoja varten |
| đ€ **ĂĂ€nitranskriptio** | `/v1/audio/transcriptions` â 7 palveluntarjoajaa (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), automaattinen kielentunnistus, MP4/MP3/WAV-tuki |
| đ **TekstistĂ€ puheeksi** | `/v1/audio/speech` â 10 palveluntarjoajaa (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) oikeilla virheilmoituksilla |
| đŹ **Videon sukupolvi** | `/v1/videos/generations` (ComfyUI + SD WebUI -työnkulut) |
| đ” **Musiikin sukupolvi** | `/v1/music/generations` (ComfyUI-työnkulut) |
| đĄïž **Moderaatiot** | `/v1/moderations` turvallisuustarkastukset |
| đ **UudelleenjĂ€rjestys** | `/v1/rerank` osuvuuden pisteytykseen |
| đ **Verkkohaku** đ | `/v1/search` â 5 palveluntarjoajaa (Serper, Brave, Perplexity, Exa, Tavily), yli 6 500 ilmaista kuukaudessa, automaattinen vikasieto, vĂ€limuisti |
### đĄïž Joustavuus, turvallisuus ja hallinto
| Ominaisuus | MitÀ se tekee |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| đ **Katkaisijat** | Mallikohtainen laukaisu/palautus kynnysohjaimilla |
| đŻ **Endpoint-Aware mallit** | Mukautetut mallit ilmoittavat tuetut pÀÀtepisteet + API-muoto |
| đĄïž **Ukkosen vastainen lauma** | Mutex + semaforisuojat uudelleenyritys-/nopeustapahtumissa |
| đ§ **Semanttinen + allekirjoitusvĂ€limuisti** | Kustannusten/viiveen vĂ€hentĂ€minen kahdella vĂ€limuistikerroksella |
| ⥠**PyydÀ idempotenssia** | Kaksoissuojaikkuna |
| đ **TLS-sormenjĂ€lkien huijaus** | Selaimen kaltainen TLS-sormenjĂ€lki â **vĂ€hentÀÀ botin havaitsemista ja tilimerkintöjĂ€** |
| đ **CLI-sormenjĂ€lkien vastaavuus** | Vastaa alkuperĂ€isten CLI-pyyntöjen allekirjoituksia â **vĂ€hentÀÀ eston riskiĂ€ sĂ€ilyttĂ€en samalla vĂ€lityspalvelimen IP-osoitteen** |
| đ **IP-suodatus** | Salli-/estoluettelon hallinta paljaille kĂ€yttöönotuksille |
| đ **Muokattavat hintarajat** | Muokattavat globaalit/toimittajatason rajoitukset pysyvillĂ€ |
| đ **API-avainten hallinta + rajaus** | Suojattu avainten myöntĂ€minen/kierto ja mallin/toimittajan hallintalaitteet |
| đĄïž **Suojattu `/models`** | Valinnainen todennus ja palveluntarjoajan piilottaminen malliluetteloon |
### đ Havaittavuus ja analytiikka
| Ominaisuus | MitÀ se tekee |
| ----------------------------------------- | ----------------------------------------------------------------------- |
| đ **Pyyntö + vĂ€lityspalvelimen kirjaus** | TĂ€ysi pyyntö/vastaus ja vĂ€lityspalvelimen kirjaus |
| đ **Unified Logs Dashboard** | Pyyntö-, vĂ€lityspalvelin-, tarkastus- ja konsolinĂ€kymĂ€t yhdellĂ€ sivulla |
| đ **PyydĂ€ telemetriaa** | p50/p95/p99 latenssi ja pyynnön jĂ€ljitys |
| đ„ **Terveyden hallintapaneeli** | KĂ€yttöaika, katkaisutilat, lukitukset, vĂ€limuistitilastot |
| đ° **Kustannusseuranta** | Budjetin hallinta ja mallikohtainen hinnoittelun nĂ€kyvyys |
| đ **Analytiikan visualisoinnit** | Mallin/palveluntarjoajan kĂ€yttötiedot ja trendinĂ€kymĂ€t |
| đ§Ș **Arviointikehys** | Golden set -testaus konfiguroitavilla ottelustrategioilla |
### âïž KĂ€yttöönotto ja alusta
| Ominaisuus | MitÀ se tekee |
| ----------------------------------- | ------------------------------------------------------------------------------- |
| đ **Ota kĂ€yttöön missĂ€ tahansa** | Localhost, VPS, Docker, pilviympĂ€ristöt |
| đŸ **Cloud Sync** | MÀÀritysten synkronointi pilvityön kautta |
| đ **Varmuuskopioi/Palauta** | Vienti/tuonti ja katastrofien palautusvirrat |
| đ§ **Ohjattu kĂ€yttöönottotoiminto** | EnsimmĂ€isen kerran ohjattu asennus |
| đ§ **CLI Tools Dashboard** | Asennus yhdellĂ€ napsautuksella suosittuja koodaustyökaluja varten |
| đź **Model Playground** | Testaa mitĂ€ tahansa palveluntarjoajaa/mallia/pÀÀtepistettĂ€ hallintapaneelista |
| đ **CLI-sormenjĂ€lkivalitsin** | Palveluntarjoajakohtainen sormenjĂ€lkien vastaavuus kohdassa Asetukset > Suojaus |
| đ **i18n (30 kieltĂ€)** | TĂ€ysi kojelauta + asiakirjojen kielen tuki RTL-kattauksella |
| đ§č **TyhjennĂ€ kaikki mallit** | Yhden napsautuksen malliluettelon tyhjennys toimittajan tiedoissa |
| đ **Ongelman mallit** | Standardoidut GitHub-mallit bugeille ja ominaisuuksille |
| đ **Muokattu tietohakemisto** | `DATA_DIR` ohitus tallennuspaikalle |
### Ominaisuus Deep Dive
#### ĂlykĂ€s varavaihtoehto ja kĂ€ytĂ€nnöllinen kustannusten hallinta
```txt
Combo: "my-coding-stack"
1. cc/claude-opus-4-6
2. nvidia/llama-3.3-70b
3. glm/glm-4.7
4. if/kimi-k2-thinking
```
Kun kiintiö, korko tai kunto epÀonnistuu, OmniRoute siirtyy automaattisesti seuraavaan ehdokkaaseen ilman manuaalista vaihtoa.
#### Protokollanhallinta, joka on nÀkyvÀ ja toimiva
- MCP + A2A ovat löydettÀvissÀ kÀyttöliittymÀssÀ ja asiakirjoissa (ei piilotettu)
- Protokollan tilasovellusliittymÀt paljastavat reaaliaikaiset toimintatiedot (`/api/mcp/*`, `/api/a2a/*`)
- Hallintapaneelit sisÀltÀvÀt toimintoja 2. pÀivÀn toimintoihin (kombinvaihto, katkaisijan nollaukset, tehtÀvien peruutus)
#### KÀÀntÀjÀ + validointityönkulku
KÀÀntÀjÀ-alue sisÀltÀÀ:
- **Playground**: pyydÀ muunnostarkistuksia
- **Chat Tester**: tÀydellinen pyyntö/vastaus edestakaisin
- **Testipenkki**: useita tapauksia yhdellÀ kertaa
- **Live Monitor**: reaaliaikainen liikennenÀkymÀ
Plus protokollan validointi oikeiden asiakkaiden kanssa `npm run test:protocols:e2e`:n kautta.
> đ **[MCP Server README](open-sse/mcp-server/README.md)** â Työkaluviittaus, IDE-mÀÀritykset ja asiakasesimerkit
>
> đ **[A2A Server README](src/lib/a2a/README.md)** â Taidot, JSON-RPC-menetelmĂ€t, suoratoisto ja tehtĂ€vien elinkaari
## đ§Ș Arvioinnit (Evals)
OmniRoute sisĂ€ltÀÀ sisÀÀnrakennetun arviointikehyksen, jolla testataan LLM-vastauksen laatua kultaiseen joukkoon verrattuna. KĂ€ytĂ€ sitĂ€ kojelaudan kohdassa **Analytics â Evals**.
### SisÀÀnrakennettu kultainen setti
Esiladattu "OmniRoute Golden Set" sisÀltÀÀ testitapauksia:
- Tervehdys, matematiikka, maantiede, koodin luominen
- JSON-muodon yhteensopivuus, kÀÀnnös, hinnanalennusten luominen
- Turvallisuuskielto (haitallinen sisÀltö), laskenta, boolen logiikka
### Arviointistrategiat
| Strategia | Kuvaus | Esimerkki |
| ---------- | ------------------------------------------------------------------------ | -------------------------------- |
| `exact` | Tulosten on vastattava tarkasti | `"4"` |
| `contains` | Tulosteen tulee sisÀltÀÀ alimerkkijono (kirjainkoolla ei ole merkitystÀ) | `"Paris"` |
| `regex` | Tulostuksen on vastattava regex-mallia | `"1.*2.*3"` |
| `custom` | Mukautettu JS-funktio palauttaa true/false | `(output) => output.length > 10` |
---
## đ Asennusopas
### Protokollan asetukset (MCP + A2A)
đ§© MCP-asetukset (mallikontekstiprotokolla)
Aloita MCP-siirto stdio-tilassa:
```bash
omniroute --mcp
```
Suositeltu vahvistuskulku:
1. YhdistÀ MCP-asiakas stdion kautta.
2. Suorita `omniroute_get_health`.
3. Suorita `omniroute_list_combos`.
4. Avaa `/dashboard/mcp` vahvistaaksesi syke, aktiivisuus ja tarkastus.
HyödyllisiÀ sovellusliittymiÀ automatisointiin:
- `GET /api/mcp/status`
- `GET /api/mcp/tools`
- `GET /api/mcp/audit`
- `GET /api/mcp/audit/stats`
đ€ A2A-asennus (Agent2Agent)
Tutustu agenttiin:
```bash
curl http://localhost:20128/.well-known/agent.json
```
LÀhetÀ tehtÀvÀ:
```bash
curl -X POST http://localhost:20128/a2a \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'
```
Hallitse elinkaarta:
- `GET /api/a2a/status`
- `GET /api/a2a/tasks`
- `GET /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/cancel`
KÀyttöliittymÀ:
- `/dashboard/a2a` tehtÀvÀn/tilan/virran havainnointia ja savutoimintoja varten
đ§Ș PÀÀstĂ€ pÀÀhĂ€n -protokollan validointi
Vahvista molemmat protokollat oikeilla asiakkailla:
```bash
npm run test:protocols:e2e
```
TÀmÀ varmistaa:
- MCP SDK -asiakas yhdistÀ/luettelo/soita
- A2A Discovery/Send/stream/get/cancel
- Tarkista tiedot MCP-tarkastuksessa ja A2A-tehtÀvienhallinnan sovellusliittymissÀ
đł Tilauksen tarjoajat
### Claude Code (Pro/Max)
```bash
Dashboard â Providers â Connect Claude Code
â OAuth login â Auto token refresh
â 5-hour + weekly quota tracking
Models:
cc/claude-opus-4-6
cc/claude-sonnet-4-5-20250929
cc/claude-haiku-4-5-20251001
```
**Provinkki:** KÀytÀ Opusta monimutkaisiin tehtÀviin ja Sonnetia nopeutta varten. OmniRoute jÀljityskiintiö mallia kohden!
### OpenAI Codex (Plus/Pro)
```bash
Dashboard â Providers â Connect Codex
â OAuth login (port 1455)
â 5-hour + weekly reset
Models:
cx/gpt-5.2-codex
cx/gpt-5.1-codex-max
```
#### Codex Account Limit Management (5h + viikoittain)
Jokaisella Codex-tilillÀ on nyt kÀytÀntökytkimet kohteessa `Dashboard -> Providers`:
- `5h` (ON/OFF): ota kÀyttöön 5 tunnin ikkunan kynnyskÀytÀntö.
- `Weekly` (ON/OFF): ota kÀyttöön viikoittaisen ikkunan kynnyskÀytÀntö.
- KynnyskÀyttÀytyminen: kun kÀytössÀ oleva ikkuna saavuttaa >=90 % kÀytön, tili ohitetaan.
- KiertokÀyttÀytyminen: OmniRoute reitittÀÀ automaattisesti seuraavalle kelvolliselle Codex-tilille.
- Nollaa toiminta: kun palveluntarjoajan `resetAt` aika kuluu, tili tulee uudelleen kelpoiseksi automaattisesti.
Skenaariot:
- `5h ON` + `Weekly ON`: tili ohitetaan, kun jompikumpi ikkuna saavuttaa kynnyksen.
- `5h OFF` + `Weekly ON`: vain viikoittainen kÀyttö voi estÀÀ tilin.
- `5h ON` + `Weekly OFF`: vain 5 tunnin kÀyttö voi estÀÀ tilin.
- `resetAt` hyvÀksytty: tili siirtyy uudelleen kiertoon automaattisesti (ei manuaalista uudelleenkÀyttöÀ).
### Gemini CLI (ILMAINEN 180 000/kk!)
```bash
Dashboard â Providers â Connect Gemini CLI
â Google OAuth
â 180K completions/month + 1K/day
Models:
gc/gemini-3-flash-preview
gc/gemini-2.5-pro
```
**Paras hinta-laatusuhde:** Valtava ilmainen taso! KÀytÀ tÀtÀ ennen maksettuja tasoja.
### GitHub Copilot
```bash
Dashboard â Providers â Connect GitHub
â OAuth via GitHub
â Monthly reset (1st of month)
Models:
gh/gpt-5
gh/claude-4.5-sonnet
gh/gemini-3-pro
```
đ API-avaintoimittajat
### NVIDIA NIM (ILMAINEN kehittĂ€jĂ€n pÀÀsy â yli 70 mallia)
1. Rekisteröidy: [build.nvidia.com](https://build.nvidia.com)
2. Hanki ilmainen API-avain (sisÀltÀÀ 1000 johtopÀÀtöskrediittiÀ)
3. Kojelauta â LisÀÀ toimittaja â NVIDIA NIM:
- API-avain: `nvapi-your-key`
**Mallit:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` ja yli 50 muuta
**Provinkki:** OpenAI-yhteensopiva API â toimii saumattomasti OmniRouten muotokÀÀnnöksen kanssa!
### DeepSeek
1. Rekisteröidy: [platform.deepseek.com](https://platform.deepseek.com)
2. Hanki API-avain
3. Dashboard â Add Provider â DeepSeek
**Mallit:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
### Groq (ilmainen taso saatavilla!)
1. Rekisteröidy: [console.groq.com](https://console.groq.com)
2. Hanki API-avain (ilmainen taso mukana)
3. Dashboard â Add Provider â Groq
**Mallit:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
**Provinkki:** ErittĂ€in nopea pÀÀttely â paras reaaliaikaiseen koodaukseen!
### OpenRouter (100+ mallia)
1. Rekisteröidy: [openrouter.ai](https://openrouter.ai)
2. Hanki API-avain
3. Dashboard â Add Provider â OpenRouter
**Mallit:** KÀytÀ yli 100 mallia kaikilta tÀrkeimmiltÀ palveluntarjoajilta yhdellÀ API-avaimella.
đ° Halvat palveluntarjoajat (Varmuuskopio)
### GLM-4.7 (PÀivittÀinen nollaus, 0,6 $/1 milj.)
1. Rekisteröidy: [Zhipu AI](https://open.bigmodel.cn/)
2. Hanki API-avain Coding Planista
3. Hallintapaneeli â LisÀÀ API-avain:
- Palveluntarjoaja: `glm`
- API-avain: `your-key`
**KÀytÀ:** `glm/glm-4.7`
**Provinkki:** Koodaussuunnitelma tarjoaa 3-kertaisen kiintiön 1/7 hinnalla! Nollaa pÀivittÀin klo 10.00.
### MiniMax M2.1 (5 h nollaus, 0,20 $/1 milj.)
1. Rekisteröidy: [MiniMax](https://www.minimax.io/)
2. Hanki API-avain
3. Kojelauta â LisÀÀ API-avain
**KÀytÀ:** `minimax/MiniMax-M2.1`
**Ammattilaisen vinkki:** Halvin vaihtoehto pitkÀlle kontekstille (1 milj. merkkiÀ)!
### Kimi K2 (9 dollaria/kk asunto)
1. Tilaa: [Moonshot AI](https://platform.moonshot.ai/)
2. Hanki API-avain
3. Kojelauta â LisÀÀ API-avain
**KÀytÀ:** `kimi/kimi-latest`
**Ammattilaisen vinkki:** KiinteÀ 9 dollaria kuukaudessa 10 miljoonalle tokenille = 0,90 dollaria / 1 miljoona todellista hintaa!
đ ILMAISIA palveluntarjoajia (hĂ€tĂ€varmuuskopio)
### iFlow (5 ILMAISTA mallia OAuthin kautta)
```bash
Dashboard â Connect iFlow
â iFlow OAuth login
â Unlimited usage
Models:
if/kimi-k2-thinking
if/qwen3-coder-plus
if/glm-4.7
if/minimax-m2
if/deepseek-r1
```
### Qwen (4 ILMAISTA mallia laitekoodin kautta)
```bash
Dashboard â Connect Qwen
â Device code authorization
â Unlimited usage
Models:
qw/qwen3-coder-plus
qw/qwen3-coder-flash
```
### Kiro (Claude ILMAINEN)
```bash
Dashboard â Connect Kiro
â AWS Builder ID or Google/GitHub
â Unlimited usage
Models:
kr/claude-sonnet-4.5
kr/claude-haiku-4.5
```
đš Luo komboja
### Esimerkki 1: Maksimoi tilaus â Halpa varmuuskopio
```
Dashboard â Combos â Create New
Name: premium-coding
Models:
1. cc/claude-opus-4-6 (Subscription primary)
2. glm/glm-4.7 (Cheap backup, $0.6/1M)
3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)
Use in CLI: premium-coding
```
### Esimerkki 2: Vain ilmainen (nollahinta)
```
Name: free-combo
Models:
1. gc/gemini-3-flash-preview (180K free/month)
2. if/kimi-k2-thinking (unlimited)
3. qw/qwen3-coder-plus (unlimited)
Cost: $0 forever!
```
đ§ CLI-integrointi
### Kohdistimen IDE
```
Settings â Models â Advanced:
OpenAI API Base URL: http://localhost:20128/v1
OpenAI API Key: [from OmniRoute dashboard]
Model: cc/claude-opus-4-6
```
### Claude Code
KÀytÀ kojelaudan **CLI Tools** -sivua mÀÀrittÀÀksesi yhdellÀ napsautuksella tai muokkaa `~/.claude/settings.json` manuaalisesti.
### Codex CLI
```bash
export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"
codex "your prompt"
```
### OpenClaw
**Vaihtoehto 1 â hallintapaneeli (suositus):**
```
Dashboard â CLI Tools â OpenClaw â Select Model â Apply
```
**Vaihtoehto 2 â Manuaalinen:** Muokkaa `~/.openclaw/openclaw.json`:
```json
{
"models": {
"providers": {
"omniroute": {
"baseUrl": "http://127.0.0.1:20128/v1",
"apiKey": "sk_omniroute",
"api": "openai-completions"
}
}
}
}
```
> **Huomaa:** OpenClaw toimii vain paikallisen OmniRouten kanssa. KÀytÀ `127.0.0.1` `localhost` sijaan IPv6-resoluutioongelmien vÀlttÀmiseksi.
### Cline / Continue / RooCode
```
Settings â API Configuration:
Provider: OpenAI Compatible
Base URL: http://localhost:20128/v1
API Key: [from OmniRoute dashboard]
Model: if/kimi-k2-thinking
```
### OpenCode
**Vaihe 1:** LisÀÀ OmniRoute mukautetuksi palveluntarjoajaksi:
```bash
opencode
/connect
# Select "Other" â Enter ID: "omniroute" â Enter your OmniRoute API key
```
**Vaihe 2:** Luo/muokkaa `opencode.json` projektisi juuressa:
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"omniroute": {
"npm": "@ai-sdk/openai-compatible",
"name": "OmniRoute",
"options": {
"baseURL": "http://localhost:20128/v1"
},
"models": {
"cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
"gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
"if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
}
}
}
}
```
**Vaihe 3:** Valitse malli OpenCodessa:
```bash
/models
# Select any OmniRoute model from the list
```
> **Vinkki:** LisÀÀ mikÀ tahansa malli, joka on saatavilla OmniRoute `/v1/models` -pÀÀtepisteessÀsi `models` -osioon. KÀytÀ muotoa `provider/model-id` OmniRoute-hallintapaneelista.
---
## đ VianetsintĂ€
Laajenna vianetsintÀopas napsauttamalla
**"Kielimalli ei antanut viestejÀ"**
- Palveluntarjoajan kiintiö kĂ€ytetty loppuun â Tarkista kojelaudan kiintiön seuranta
- Ratkaisu: KÀytÀ yhdistelmÀvaraa tai vaihda halvempaan tasoon
**hintarajoitus**
- Tilauskiintiö loppu â Varaa GLM/MiniMaxiin
- LisÀÀ yhdistelmĂ€: `cc/claude-opus-4-6 â glm/glm-4.7 â if/kimi-k2-thinking`
**OAuth-tunnus vanhentunut**
- OmniRoute pÀivittÀÀ automaattisesti
- Jos ongelmat jatkuvat: Kojelauta â Palveluntarjoaja â YhdistĂ€ uudelleen
**Korkeat kustannukset**
- Tarkista kĂ€yttötilastot kohdassa Dashboard â Costs
- Vaihda ensisijaiseksi malliksi GLM/MiniMax
- Use free tier (Gemini CLI, iFlow) for non-critical tasks
**Kojelauta/API-portit ovat vÀÀrin**
- `PORT` on kanoninen perusportti (ja oletuksena API-portti)
- `API_PORT` ohittaa vain OpenAI-yhteensopivan API-kuuntelijan
- `DASHBOARD_PORT` ohittaa vain kojelaudan/Next.js-kuuntelijan
- Aseta `NEXT_PUBLIC_BASE_URL` kojelautaasi/julkiseen URL-osoitteeseen (OAuth-takaisinsoittoja varten)
**Pilvisynkronointivirheet**
- Vahvista `BASE_URL` pistettÀ kÀynnissÀ olevaan esiintymÀÀsi
- Vahvista `CLOUD_URL` pistettÀ odotettuun pilvipÀÀtepisteeseen
- PidÀ `NEXT_PUBLIC_*`-arvot kohdakkain palvelinpuolen arvojen kanssa
**EnsimmÀinen kirjautuminen ei toimi**
- Tarkista `INITIAL_PASSWORD` kohteessa `.env`
- Jos ei ole asetettu, varasalasana on `123456`
**Ei pyyntölokeja**
- Aseta `ENABLE_REQUEST_LOGS=true` kohteeseen `.env`
**Yhteystesti nÀyttÀÀ "Virheellinen" OpenAI-yhteensopiville palveluntarjoajille**
- Monet palveluntarjoajat eivÀt paljasta `/models`-pÀÀtepistettÀ
- OmniRoute v1.0.6+ sisÀltÀÀ varatarkistuksen chatin loppuunsaattamisen kautta
- Varmista, ettÀ perus-URL sisÀltÀÀ `/v1`-liitteen
### đ OAuth etĂ€palvelimella
> **â ïž TĂ€rkeÀÀ kĂ€yttĂ€jille, jotka kĂ€yttĂ€vĂ€t OmniRoutea VPS:ssĂ€, Dockerissa tai millĂ€ tahansa etĂ€palvelimella**
#### Miksi Antigravity / Gemini CLI OAuth epÀonnistuu etÀpalvelimissa?
**Antigravity**- ja **Gemini CLI** -palveluntarjoajat kÀyttÀvÀt **Google OAuth 2.0** -versiota. Google edellyttÀÀ, ettÀ OAuth-kulun `redirect_uri` vastaa tÀsmÀlleen yhtÀ sovelluksen Google Cloud Consolessa esirekisteröityistÀ URI:ista.
OmniRouteen niputetut OAuth-kirjautumistiedot on rekisteröity **vain `localhost` varten**. Kun kÀytÀt OmniRoutea etÀpalvelimella (esim. `https://omniroute.myserver.com`), Google hylkÀÀ todennuksen seuraavilla tavoilla:
```
Error 400: redirect_uri_mismatch
```
#### Ratkaisu: MÀÀritÀ omat OAuth-kirjautumistietosi
Sinun on luotava **OAuth 2.0 -asiakastunnus** Google Cloud Consolessa palvelimesi URI:lla.
#### Askel askeleelta
**1. Avaa Google Cloud Console**
Siirry osoitteeseen: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
**2. Luo uusi OAuth 2.0 -asiakastunnus**
- Napsauta **"+ Luo kirjautumistiedot"** â **"OAuth-asiakastunnus"**
- Sovellustyyppi: **"Web-sovellus"**
- Nimi: kaikki mistÀ pidÀt (esim. `OmniRoute Remote`)
**3. LisÀÀ valtuutetut uudelleenohjaus-URI:t**
LisÀÀ **"Authorized redirect URIs"** -kenttÀÀn:
```
https://your-server.com/callback
```
> Korvaa `your-server.com` palvelimesi verkkotunnuksella tai IP-osoitteella (lisÀÀ tarvittaessa portti, esim. `http://45.33.32.156:20128/callback`).
**4. Tallenna ja kopioi tunnistetiedot**
Luomisen jÀlkeen Google nÀyttÀÀ **Client ID** ja **Client Secret**.
**5. Aseta ympÀristömuuttujat**
`.env` (tai Docker-ympÀristömuuttujat):
```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
```
**6. KÀynnistÀ OmniRoute uudelleen**
```bash
# npm:
npm run dev
# Docker:
docker restart omniroute
```
**7. YritÀ muodostaa yhteys uudelleen**
Dashboard â Providers â Antigravity (tai Gemini CLI) â OAuth
Google ohjaa nyt oikein osoitteeseen `https://your-server.com/callback`.
---
#### VĂ€liaikainen kiertotapa (ilman mukautettuja kirjautumistietoja)
Jos et halua mÀÀrittÀÀ omia tunnistetietojasi juuri nyt, voit silti kÀyttÀÀ **manuaalista URL-kulkua**:
1. OmniRoute avaa Googlen valtuutus-URL-osoitteen
2. Valtuutuksen jÀlkeen Google yrittÀÀ uudelleenohjata osoitteeseen `localhost` (joka epÀonnistuu etÀpalvelimella)
3. **Kopioi koko URL-osoite** selaimesi osoitepalkista (vaikka sivu ei latautuisi)
4. LiitÀ URL-osoite OmniRoute-yhteysmodaalissa nÀkyvÀÀn kenttÀÀn
5. Napsauta **"YhdistÀ"**
> TÀmÀ toimii, koska URL-osoitteessa oleva valtuutuskoodi on kelvollinen riippumatta siitÀ, ladattiinko uudelleenohjaussivu.
---
đ§đ· VersĂŁo em PortuguĂȘs
#### Onko OAuth do Antigravity / Gemini CLI falha em servidores Remotos?
Os provedores **Antigravity** ja **Gemini CLI** usam **Google OAuth 2.0** para autenticação. O Google exige que a `redirect_uri` usada no fluxo OAuth seja **exatamente** uma das URIs pre-cadastradas no Google Cloud Console do aplicativo.
As credenciais OAuth embutidas no OmniRoute estĂŁo cadastradas **apenas para `localhost`**. Quando vocĂȘ acessa o OmniRoute em um servidor Remoto (esim. `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:
```
Error 400: redirect_uri_mismatch
```
#### Ratkaisu: MÀÀritÀ suas próprias credenciais OAuth
VocĂȘ precisa criar um **OAuth 2.0 Client ID** ei Google Cloud Console com URI do seu servidor.
#### Passo a passo
**1. Acesse tai Google Cloud Console**
Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
**2. Crie um novo OAuth 2.0 -asiakastunnus**
- Klikkaa em **"+ Luo kirjautumistiedot"** â **"OAuth-asiakastunnus"**
- Tipo de aplicativo: **"Web-sovellus"**
- Nimi: escolha qualquer nome (esim.: `OmniRoute Remote`)
**3. Adicione valtuutettuina uudelleenohjaus-URI:ina**
No campo **"Authorized redirect URIs"**, lisÀys:
```
https://seu-servidor.com/callback
```
> Korvaa `seu-servidor.com` pelo dominio tai IP do seu servidor (mukaan lukien porta se necessĂĄrio, esim. `http://45.33.32.156:20128/callback`).
**4. Tallenna kopio valtuutuksena**
ApĂłs criar, o Google mostrarĂĄ o **Client ID** e o **Client Secret**.
**5. MÀÀritÀ variåveis de ambiente**
Ei seu `.env` (ou nas variĂĄveis de ambiente do Docker):
```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
```
**6. Reinicie o OmniRoute**
```bash
# Se usando npm:
npm run dev
# Se usando Docker:
docker restart omniroute
```
**7. Tente conectar novamente**
Dashboard â Providers â Antigravity (ou Gemini CLI) â OAuth
Agora o Google redirecionarå corretamente para `https://seu-servidor.com/callback` e a autenticação funcionarå.
---
#### Workaround temporĂĄrio (sem configurar credenciais prĂłprias)
Se nĂŁo quiser criar credenciais prĂłprias agora, ainda Ă© possĂvel usar o fluxo **manual de URL**:
1. OmniRoute lÀhettÀÀ Googlen lupa-osoitteen
2. ApĂłs vocĂȘ autorizar, o Google tentarĂĄ redirecionar para `localhost` (que falha no servidor Remoto)
3. **Kopioi URL-osoite tÀydellinen** da barra de endereço do seu selaimessa (mesmo que a pågina não carregue)
4. Cole essa URL no campo que aparece no modal de conexĂŁo do OmniRoute
5. Klikkaa em **"YhdistÀ"**
> Este workaround funciona porque o código de autorização na URL é vålido independente do redirect ter carregado ou não.
---
## đ ïž Tech Stack
Laajenna teknisen pinon tiedot klikkaamalla
- **Suoritusaika**: Node.js 18â22 LTS (â ïž Node.js 24+ -versiota **ei tueta** â `better-sqlite3` alkuperĂ€iset binaarit eivĂ€t ole yhteensopivia)
- **Kieli**: TypeScript 5.9 â **100 % TypeScript** `src/` ja `open-sse/` (nolla `any` ydinmoduuleissa versiosta 2.0 lĂ€htien)
- **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
- **Tietokanta**: LowDB (JSON) + SQLite (verkkotunnuksen tila + vÀlityspalvelimen lokit + MCP-tarkastus + reitityspÀÀtökset)
- **Kaaviot**: Zod (MCP-työkalun I/O-validointi, API-sopimukset)
- **Protokollat**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
- **Striimaus**: Palvelimen lÀhettÀmÀt tapahtumat (SSE)
- **Auth**: OAuth 2.0 (PKCE) + JWT + API-avaimet + MCP-valtuutus
- **Testaus**: Node.js-testausohjelma + Vitest (900+ testiÀ, mukaan lukien yksikkö, integrointi, E2E)
- **CI/CD**: GitHub Actions (automaattinen npm-julkaisu + Docker Hub julkaisussa)
- **Verkkosivusto**: [omniroute.online](https://omniroute.online)
- **Paketti**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
- **Dokkeri**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
- **KestÀvyys**: Katkaisija, eksponentiaalinen takaisku, ukkosen esto, TLS-huijaus, automaattinen yhdistelmÀ itsekorjaus
---
## đ Dokumentaatio
| Asiakirja | Kuvaus |
| ---------------------------------------------- | --------------------------------------------------------------- |
| [User Guide](docs/USER_GUIDE.md) | Palveluntarjoajat, yhdistelmÀt, CLI-integrointi, kÀyttöönotto |
| [API Reference](docs/API_REFERENCE.md) | Kaikki pÀÀtepisteet esimerkeineen |
| [MCP Server](open-sse/mcp-server/README.md) | 16 MCP-työkalua, IDE-konfiguraatioita, Python/TS/Go-asiakkaita |
| [A2A Server](src/lib/a2a/README.md) | JSON-RPC 2.0 -protokolla, taidot, suoratoisto, tehtÀvÀnhallinta |
| [Auto-Combo Engine](docs/auto-combo.md) | 6-faktorinen pisteytys, tilapaketit, itsestÀÀn paraneva |
| [Troubleshooting](docs/TROUBLESHOOTING.md) | YleisiÀ ongelmia ja ratkaisuja |
| [Architecture](docs/ARCHITECTURE.md) | JÀrjestelmÀarkkitehtuuri ja sisÀosat |
| [Contributing](CONTRIBUTING.md) | KehittÀmisjÀrjestelyt ja -ohjeet |
| [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0 -spesifikaatio |
| [Security Policy](SECURITY.md) | Haavoittuvuusraportointi ja tietoturvakÀytÀnnöt |
| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | TĂ€ydellinen opas: VM + nginx + Cloudflare-asennus |
| [Features Gallery](docs/FEATURES.md) | Visuaalinen kojelautakierros kuvakaappauksilla |
| [Release Checklist](docs/RELEASE_CHECKLIST.md) | Julkaisua edeltÀvÀn vahvistuksen vaiheet |
---
## đșïž Etenemissuunnitelma
OmniRoutella on **210+ suunniteltua ominaisuutta** useissa kehitysvaiheissa. TÀssÀ ovat tÀrkeimmÀt alueet:
| Luokka | Suunnitellut ominaisuudet | Kohokohdat |
| ------------------------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| đ§ **Routing & Intelligence** | 25+ | PienimmĂ€n viiveen reititys, tunnistepohjainen reititys, kiintiön esitarkastus, P2C-tilin valinta |
| đ **Turvallisuus ja vaatimustenmukaisuus** | 20+ | SSRF-karkaisu, valtuustietojen peittĂ€minen, pÀÀtepistekohtainen nopeusraja, hallintaavaimen laajuus |
| đ **Havaittavuus** | 15+ | OpenTelemetry-integraatio, reaaliaikainen kiintiöiden seuranta, kustannusseuranta mallikohtaisesti |
| đ **Tarjoajien integraatiot** | 20+ | Dynaaminen mallirekisteri, palveluntarjoajan jÀÀhtyminen, usean tilin Codex, Copilot-kiintiön jĂ€sentĂ€minen |
| ⥠**Suorituskyky** | 15+ | KaksoisvÀlimuistikerros, kehotevÀlimuisti, vastausvÀlimuisti, suoratoiston yllÀpitÀminen, erÀ-API |
| đ **Ekosysteemi** | 10+ | WebSocket API, konfiguroinnin hot-reload, hajautettu konfiguraatiosĂ€ilö, kaupallinen tila |
### đ Tulossa pian
- đ **OpenCode Integration** - Natiivitoimittajan tuki OpenCode AI -koodaus-IDE:lle
- đ **TRAE-integraatio** â TĂ€ysi tuki TRAE AI -kehityskehykselle
- đŠ **ErĂ€sovellusliittymĂ€** â Asynkroninen erĂ€kĂ€sittely joukkopyyntöille
- đŻ **Tagipohjainen reititys** - Reittipyynnöt mukautettujen tunnisteiden ja metatietojen perusteella
- đ° **Alhaisimman kustannustason strategia** - Valitse automaattisesti halvin saatavilla oleva palveluntarjoaja
> đ TĂ€ydelliset ominaisuudet saatavilla osoitteessa [**OMNI_TOKEN_342**](docs/new-features/) (217 yksityiskohtaista spesifikaatiota)
---
## đ„ Avustajat
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
### Kuinka osallistua
1. Haarukka arkisto
2. Luo ominaisuushaara (`git checkout -b feature/amazing-feature`)
3. Vahvista muutokset (`git commit -m 'Add amazing feature'`)
4. TyönnÀ haaraan (`git push origin feature/amazing-feature`)
5. Avaa vetopyyntö
Katso tarkemmat ohjeet osoitteesta [CONTRIBUTING.md](CONTRIBUTING.md).
### Uuden version julkaisu
```bash
# Create a release â npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes
```
---
## đ TĂ€htihistoria
## Stargazers ajan myötÀ
## [](https://starchart.cc/diegosouzapw/OmniRoute)
## đ Kiitokset
Erityinen kiitos **[9router](https://github.com/decolua/9router)**, **[decolua](https://github.com/decolua)** - alkuperÀinen projekti, joka inspiroi tÀtÀ haarukkaa. OmniRoute rakentaa tÀlle uskomattomalle perustalle lisÀominaisuuksia, multimodaalisia API-liittymiÀ ja tÀydellistÀ TypeScript-uudelleenkirjoitusta.
Erityinen kiitos **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** - alkuperÀiselle Go-toteutukselle, joka inspiroi tÀtÀ JavaScript-porttia.
---
## đ Lisenssi
MIT-lisenssi â katso lisĂ€tietoja osoitteesta [LICENSE](LICENSE).
---