mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-18 21:22:28 +03:00
ecc89eef14
* feat(providers): add Zylo UnoRouter and Poolside registries * feat(providers): integrate audited free-tier gateways * feat: add wave2 free-tier provider registries * feat(providers): add Mixlayer Speka and TokenReply registries * feat: add wave 2 free-tier provider registries * fix: align meganova provider slug * feat(providers): integrate wave2 free-tier gateways * feat(providers): add Wave 3-A free-tier registries * feat(providers): add HelyxAI Auriko and Poixe registries * feat(providers): add Naga AI and Chat Oripe registries * feat(providers): integrate wave3 free-tier gateways * feat(providers): add FreeInference registry * feat(providers): add Free.ai registry * feat(providers): integrate wave4 free-tier gateways * docs: synchronize provider and free-tier inventories * refactor(providers): split audited gateway catalog * feat(providers): add audited Void AI and HelixMind gateways * feat(providers): finalize audited free-tier integration * test(providers): update APIKEY split count to 229 after rebase onto release/v3.8.50 The rebase merged the release catalog (201 APIKEY providers) with the PR's 28 free-tier additions, yielding 229 total. Correct the characterization count so the partition assertion reflects the true merged state. --------- Co-authored-by: diegosouzapw <diegosouzapw@users.noreply.github.com> Co-authored-by: backryun <bakryun0718@proton.me>
217 lines
9.8 KiB
Markdown
217 lines
9.8 KiB
Markdown
# Free Tiers Guide: Understand and Combine Free AI Access
|
|
|
|
> **TL;DR**: OmniRoute registers 329 providers, with **155 catalog entries marked free/no-auth**. The stricter audited budget currently covers **43 recurring pools / 522 model budget entries**. Connect several suitable providers for broader fallback capacity; every quota, approval rule, privacy policy, and paid-overage condition still applies.
|
|
|
|
---
|
|
|
|
## What Are Free Tiers?
|
|
|
|
Many AI providers offer some form of **free access**. Depending on the provider, that may
|
|
mean a no-auth endpoint, recurring quota, rate-limited uncapped access, a signup grant,
|
|
manual approval, or a temporary promotion. Some options require an account, API key,
|
|
credit card, KYC, or acceptance of provider-specific terms.
|
|
|
|
OmniRoute **aggregates** these free tiers into one endpoint. Instead of signing up for 10 different services, you connect them all to OmniRoute and use `model: "auto"` to automatically pick the best free option for each request.
|
|
|
|
---
|
|
|
|
## Representative Free-Access Providers
|
|
|
|
### Recurring, Keyless, or Uncapped Access
|
|
|
|
These providers have a recurring, keyless, or uncapped free-access path in the audited catalog. “Uncapped” means no published token cap; rate, concurrency, account, regional, and policy limits can still apply:
|
|
|
|
| Provider | Models | Quota | How to Connect |
|
|
|----------|--------|-------|----------------|
|
|
| **Kiro AI** | Claude Sonnet 4.5, Haiku 4.5, DeepSeek V3.2, and others | Audited catalog estimates a 25K-token shared monthly pool | OAuth/account flow; ToS flagged `avoid` in the catalog |
|
|
| **OpenCode Free** | Current `*-free` model set in the provider registry | Keyless; no published token cap | No provider credential; ToS flagged `avoid` |
|
|
| **Pollinations** | Current keyless model set; some former models are discontinued or key-required | Keyless; no published token cap | No provider credential for the keyless models |
|
|
| **Cloudflare AI** | Workers AI catalog | Audited pool estimates ~30M tokens/month from published usage units | Cloudflare account and API credentials |
|
|
| **Gemini** | Gemini Flash family | Audited pool estimates ~60M tokens/month | Google AI Studio API key; rate limits apply |
|
|
| **Groq** | Llama, GPT-OSS, and Qwen models | Audited pool estimates ~15M tokens/month | Groq API key; rate limits apply |
|
|
| **Cerebras** | GLM 4.7 and GPT-OSS 120B | Audited pool estimates ~30M tokens/month | Cerebras API key; rate limits apply |
|
|
|
|
### Signup Grants and Provider-Specific Credits
|
|
|
|
These providers give you **free credits** when you sign up:
|
|
|
|
| Provider | Free Credits | Models | How to Get |
|
|
|----------|-------------|--------|------------|
|
|
| **DeepSeek** | 5M free tokens | DeepSeek V4 | Sign up at platform.deepseek.com |
|
|
| **LongCat** | 10M-token one-time grant | LongCat 2.0 | API key + KYC; pay-as-you-go after the grant |
|
|
| **Together** | $25 signup credit represented as ~25M tokens in the budget model | Provider catalog | Sign up and verify current terms |
|
|
| **Vertex AI** | $300 signup credit represented as ~300M tokens in the budget model | Gemini and partner models | Google Cloud account; billing and eligibility rules apply |
|
|
|
|
### Other Limited Access
|
|
|
|
These providers have **free tiers** with specific limits:
|
|
|
|
| Provider | Free Limit | Models | Best For |
|
|
|----------|-----------|--------|----------|
|
|
| **GitHub Models** | Audited shared pool estimates ~18M tokens/month | Broad model evaluation |
|
|
| **Hugging Face** | Small recurring monthly pool | Experiments and model variety |
|
|
| **OpenRouter free models** | Shared request-limited pool; optional one-time top-up increases the recurring allowance | Broad fallback catalog |
|
|
| **AI Horde** | Keyless community capacity; availability varies | Opportunistic distributed inference |
|
|
|
|
---
|
|
|
|
## How to Stack Free Tiers
|
|
|
|
The magic of OmniRoute is **stacking free tiers**. Instead of relying on one provider, you connect multiple free providers and let OmniRoute automatically pick the best one for each request.
|
|
|
|
### Example: Broader Free-Tier Coverage
|
|
|
|
Connect several providers to reduce dependence on any single quota:
|
|
|
|
1. **Gemini** — recurring API-key quota
|
|
2. **Groq** — recurring API-key quota
|
|
3. **Pollinations** — keyless, rate-limited access
|
|
4. **LongCat** — one-time signup grant (requires KYC)
|
|
|
|
Then use `model: "auto"` and OmniRoute will:
|
|
- Try the highest-ranked eligible connection first
|
|
- If its quota or health check fails → try the next configured provider
|
|
- If the keyless provider is unavailable → continue through the remaining targets
|
|
- If all fail → use LongCat as backup
|
|
|
|
**Result**: broader free-tier coverage with automatic fallback — not a guarantee of unlimited capacity.
|
|
|
|
---
|
|
|
|
## How to Connect Free Providers
|
|
|
|
### Step 1: Open the Dashboard
|
|
|
|
Go to `http://localhost:20128` in your browser.
|
|
|
|
### Step 2: Go to Providers
|
|
|
|
Click **Providers** in the sidebar.
|
|
|
|
### Step 3: Click Add Provider
|
|
|
|
Click the **+ Add Provider** button.
|
|
|
|
### Step 4: Select a Free Provider
|
|
|
|
Browse the catalog and inspect each provider's current `hasFree`, auth, quota, privacy,
|
|
and ToS metadata. The provider card and the
|
|
[Free Tiers Reference](../reference/FREE_TIERS.md) distinguish recurring pools,
|
|
uncapped/keyless access, signup credits, discontinued entries, and higher-risk sources.
|
|
|
|
### Step 5: Click Connect
|
|
|
|
For a `NOAUTH` provider, no credential is required. OAuth and API-key providers must be
|
|
connected through their documented account flow.
|
|
|
|
### Step 6: Repeat
|
|
|
|
Connect several providers whose terms and privacy model fit your use case.
|
|
|
|
---
|
|
|
|
## Reading the Catalog Correctly
|
|
|
|
- `NOAUTH` means OmniRoute does not ask you for a provider credential; it does not
|
|
guarantee uptime, privacy, or unlimited capacity.
|
|
- `hasFree` is discovery metadata. It can represent a recurring quota, keyless access,
|
|
signup credit, approval program, or promotion.
|
|
- `recurring-uncapped` means no published token ceiling was available; rate and
|
|
concurrency limits still apply.
|
|
- `one-time-initial` does not recur after the signup grant is consumed.
|
|
- `tos: avoid` is a warning to review provider terms and account risk before use.
|
|
- Entries marked `discontinued` remain historical evidence and must not be presented as
|
|
currently free.
|
|
|
|
---
|
|
|
|
## How OmniRoute Makes Free Tiers Better
|
|
|
|
### 1. Automatic Fallback
|
|
|
|
If one free provider is busy or down, OmniRoute automatically tries the next one. You don't need to do anything.
|
|
|
|
### 2. Smart Routing
|
|
|
|
OmniRoute picks the **best free provider** for each request based on:
|
|
- Speed — Which provider is fastest right now?
|
|
- Quality — Which provider is best for this task?
|
|
- Capacity — Which provider has quota remaining?
|
|
|
|
### 3. Token Savings
|
|
|
|
OmniRoute's compression pipeline can reduce eligible prompt and tool-output tokens. The
|
|
actual savings depend on content, selected engines, provider accounting, and fidelity
|
|
settings; compression does not multiply every provider quota by a fixed amount.
|
|
|
|
### 4. Multi-Account Support
|
|
|
|
If provider terms permit multiple accounts or credentials, OmniRoute can treat each
|
|
connection as a separate routing candidate. Do not create extra accounts to evade a
|
|
provider's quota or access policy.
|
|
|
|
---
|
|
|
|
## Free Tier Math
|
|
|
|
The live, pool-deduplicated catalog currently reports:
|
|
|
|
| Metric | Current audited value | Interpretation |
|
|
| --- | ---: | --- |
|
|
| Recurring quantified grant | **~1.53B tokens/month** | Shared pools counted once; excludes uncapped providers from the sum |
|
|
| First month with signup grants | **~2.15B tokens** | Recurring total plus one-time and recurring credits |
|
|
| Quantified inventory | **43 pools / 522 model budget entries** | Budget-model coverage, not the full 329-provider catalog |
|
|
| Recurring/keyless/uncapped providers represented | **58** | Provider presence in recurring forms of the audited budget catalog |
|
|
| Free/no-auth discovery entries | **155** | Broader provider metadata; not all have a quantifiable recurring quota |
|
|
|
|
These values are computed from `open-sse/config/freeModelCatalog.ts`; see the
|
|
[Free Tiers Reference](../reference/FREE_TIERS.md) for pool deduplication, ToS flags,
|
|
discontinued entries, and signup-credit methodology.
|
|
|
|
---
|
|
|
|
## Common Questions
|
|
|
|
### "Is this really free?"
|
|
|
|
The catalog records provider-published terms and project research, but offers can change.
|
|
Verify the provider's current pricing, quota, privacy policy, and eligibility before use.
|
|
|
|
### "Will the free tier run out?"
|
|
|
|
Every provider can rate-limit, change models, suspend access, or go offline. Multiple
|
|
connections improve fallback coverage but do not guarantee an available free route.
|
|
|
|
### "Can I use free providers for production?"
|
|
|
|
Only if the provider's SLA, data handling, limits, and terms meet your production
|
|
requirements. Critical workloads should have monitored, contractually suitable fallback.
|
|
|
|
### "What's the catch?"
|
|
|
|
Tradeoffs may include strict limits, waitlists, KYC, credit-card verification, training on
|
|
prompts, weaker privacy, no SLA, model churn, geographic restrictions, paid overage, or
|
|
account-policy risk. OmniRoute surfaces the available metadata; you choose what to enable.
|
|
|
|
### "How do I get more free quota?"
|
|
|
|
1. Connect more free providers
|
|
2. Enable appropriate compression engines and measure savings for your workload
|
|
3. Use `auto/cheap` to prioritize free/cheap providers
|
|
4. Add additional permitted providers or credentials without violating provider terms
|
|
|
|
### "Do free providers have worse quality?"
|
|
|
|
Not necessarily. Some providers expose the same model families available through paid
|
|
routes, but limits, latency, privacy, reliability, and model versions can differ. Use the
|
|
Free Provider Rankings page as a quality signal and verify the actual model served.
|
|
|
|
---
|
|
|
|
## What's Next?
|
|
|
|
- **[Auto-Combo Guide](./AUTO-COMBO-GUIDE.md)** — Let OmniRoute pick the best AI for you
|
|
- **[Providers Guide](./PROVIDERS-GUIDE.md)** — Connect more providers
|
|
- **[Troubleshooting](../guides/TROUBLESHOOTING.md)** — Fix common issues
|
|
- **[Free Tiers Reference](../reference/FREE_TIERS.md)** — Full list of free tiers
|