diff --git a/README.pl.md b/README.pl.md
new file mode 100644
index 0000000000..87532906b0
--- /dev/null
+++ b/README.pl.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — darmowa bramka AI
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Nigdy nie przestawaj kodować. Inteligentne przekierowywanie do **BEZPŁATNYCH i tanich modeli AI** z automatycznym powrotem.
+
+_Twój uniwersalny serwer proxy API — jeden punkt końcowy, ponad 36 dostawców, zero przestojów._
+
+**Uzupełnienia czatu • Osadzania • Generowanie obrazu • Dźwięk • Zmiana rankingu • 100% TypeScript**
+
+---
+
+### 🤖 Bezpłatny dostawca AI dla Twoich ulubionych agentów kodujących
+
+_Połącz dowolne narzędzie IDE lub CLI oparte na sztucznej inteligencji poprzez OmniRoute — bezpłatną bramę API dla nieograniczonego kodowania._
+
+
+
+
+ # 🚀 OmniRoute — O gateway de IA gratuito
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Nunca pare de codificar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
+
+_Seu proxy de API universal — um endpoint, mais de 36 provedores, tempo de inatividade zero._
+
+**Conclusões de bate-papo • Incorporações • Geração de imagem • Áudio • Reclassificação • 100% TypeScript**
+
+---
+
+### 🤖 Provedor de IA gratuito para seus agentes de codificação favoritos
+
+_Conecte qualquer ferramenta IDE ou CLI com tecnologia de IA por meio do OmniRoute - gateway de API gratuito para codificação ilimitada._
+
+
+
+---
+
+## 🤔 Por que OmniRoute?
+
+**Pare de desperdiçar dinheiro e atingir limites:**
+
+- A cota de assinatura expira sem ser utilizada todos os meses
+- Os limites de taxa impedem você no meio da codificação
+- APIs caras (US$ 20-50/mês por provedor)
+- Troca manual entre provedores
+
+**OmniRoute resolve isso:**
+
+- ✅ **Maximize as assinaturas** - Rastreie a cota, use cada bit antes de redefinir
+- ✅ **Fullback automático** - Assinatura → Chave de API → Barato → Gratuito, tempo de inatividade zero
+- ✅ **Múltiplas contas** - Round-robin entre contas por provedor
+- ✅ **Universal** - Funciona com Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, qualquer ferramenta CLI
+
+---
+
+## 🔄 Como funciona
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Início rápido
+
+**1. Instale globalmente:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 O painel abre às `http://localhost:20128`
+
+| Comando | Descrição |
+| ----------------------- | ------------------------------------- |
+| `omniroute` | Iniciar servidor (porta padrão 20128) |
+| `omniroute --port 3000` | Usar porta personalizada |
+| `omniroute --no-open` | Não abra o navegador automaticamente |
+| `omniroute --help` | Mostrar ajuda |
+
+**2. Conecte um provedor GRATUITO:**
+
+Painel → Provedores → Conectar **Claude Code** ou **Antigravidade** → Login OAuth → Concluído!
+
+**3. Use em sua ferramenta CLI:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**É isso aí!** Comece a codificar com modelos de IA GRATUITOS.
+
+**Alternativa – execute a partir da fonte:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute está disponível como uma imagem pública do Docker em [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Execução rápida:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Com arquivo de ambiente:**
+
+```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
+```
+
+**Usando Docker Compose:**
+
+```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
+```
+
+| Imagem | Etiqueta | Tamanho | Descrição |
+| ------------------------ | -------- | ------- | --------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 MB | Última versão estável |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250 MB | Versão atual |
+
+---
+
+## 💰 Visão geral dos preços
+
+| Nível | Provedor | Custo | Redefinição de cota | Melhor para |
+| ------------------- | ------------------- | -------------------------- | ------------------------ | ----------------------- |
+| **💳 ASSINATURA** | Código Claude (Pro) | $ 20/mês | 5h + semanalmente | Já inscrito |
+| | Códice (Plus/Pro) | US$ 20-200/mês | 5h + semanalmente | Usuários OpenAI |
+| | Gêmeos CLI | **GRÁTIS** | 180 mil/mês + 1 mil/dia | Todos! |
+| | Copiloto GitHub | US$ 10-19/mês | Mensalmente | Usuários do GitHub |
+| **🔑 CHAVE DE API** | NVIDIA NIM | **GRÁTIS** (1000 créditos) | Único | Teste de nível gratuito |
+| | DeepSeek | Pagamento conforme uso | Nenhum | Melhor preço/qualidade |
+| | Groq | Nível gratuito + pago | Taxa limitada | Inferência ultrarrápida |
+| | xAI (Groque) | Pagamento conforme uso | Nenhum | Modelos Grok |
+| | Mistral | Nível gratuito + pago | Taxa limitada | IA Europeia |
+| | OpenRouter | Pagamento conforme uso | Nenhum | Mais de 100 modelos |
+| **💰 BARATO** | GLM-4.7 | US$ 0,6/1 milhão | Diariamente 10h | Backup de orçamento |
+| | MiniMax M2.1 | US$ 0,2/1 milhão | Rolamento de 5 horas | Opção mais barata |
+| | Kimi K2 | $ 9 / mês fixo | 10 milhões de tokens/mês | Custo previsível |
+| **🆓 GRÁTIS** | iFlow | $0 | Ilimitado | 8 modelos grátis |
+| | Qwen | $0 | Ilimitado | 3 modelos grátis |
+| | Kiro | $0 | Ilimitado | Cláudio grátis |
+
+**💡 Dica profissional:** Comece com Gemini CLI (180 mil grátis/mês) + combo iFlow (gratuito ilimitado) = custo de $ 0!
+
+---
+
+## 🎯 Casos de uso
+
+### Caso 1: "Tenho assinatura do Claude Pro"
+
+**Problema:** A cota expira sem ser utilizada, limites de taxa durante codificação pesada
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (use subscription fully)
+ 2. glm/glm-4.7 (cheap backup when quota out)
+ 3. if/kimi-k2-thinking (free emergency fallback)
+
+Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
+vs. $20 + hitting limits = frustration
+```
+
+### Caso 2: "Quero custo zero"
+
+**Problema:** Não posso pagar assinaturas, preciso de codificação de IA confiável
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K free/month)
+ 2. if/kimi-k2-thinking (unlimited free)
+ 3. qw/qwen3-coder-plus (unlimited free)
+
+Monthly cost: $0
+Quality: Production-ready models
+```
+
+### Caso 3: "Preciso de codificação 24 horas por dia, 7 dias por semana, sem interrupções"
+
+**Problema:** Prazos, não podemos arcar com o tempo de inatividade
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (best quality)
+ 2. cx/gpt-5.2-codex (second subscription)
+ 3. glm/glm-4.7 (cheap, resets daily)
+ 4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
+ 5. if/kimi-k2-thinking (free unlimited)
+
+Result: 5 layers of fallback = zero downtime
+```
+
+### Caso 4: "Quero IA GRATUITA no OpenClaw"
+
+**Problema:** Precisa de assistente de IA em aplicativos de mensagens, totalmente gratuito
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (unlimited free)
+ 2. if/minimax-m2.1 (unlimited free)
+ 3. if/kimi-k2-thinking (unlimited free)
+
+Monthly cost: $0
+Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Principais recursos
+
+### 🧠 Roteamento e inteligência central
+
+| Recurso | O que faz |
+| -------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| 🎯 **Fullback inteligente de 4 camadas** | Roteamento automático: Assinatura → Chave de API → Barato → Grátis |
+| 📊 **Acompanhamento de cotas em tempo real** | Contagem de tokens ativos + contagem regressiva redefinida por provedor |
+| 🔄 **Tradução de formato** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro sem costura + higienização de resposta |
+| 👥 **Suporte para múltiplas contas** | Múltiplas contas por provedor com seleção inteligente |
+| 🔄 **Atualização automática de token** | Os tokens OAuth são atualizados automaticamente com nova tentativa |
+| 🎨 **Combos Personalizados** | 6 estratégias: preencher primeiro, round-robin, p2c, aleatório, menos usado, otimizado para custos |
+| 🧩 **Modelos Personalizados** | Adicione qualquer ID de modelo a qualquer provedor |
+| 🌐 **Roteador curinga** | Rotear padrões `provider/*` para qualquer provedor dinamicamente |
+| 🧠 **Pensando no Orçamento** | Modos de passagem, automático, personalizado e adaptativo para modelos de raciocínio |
+| 💬 **Injeção imediata do sistema** | Prompt de sistema global aplicado em todas as solicitações |
+| 📄 **API de respostas** | Suporte completo à API de respostas OpenAI (`/v1/responses`) para Codex |
+
+### 🎵 APIs multimodais
+
+| Recurso | O que faz |
+| --------------------------------- | ----------------------------------------------------------- |
+| 🖼️ **Geração de imagens** | `/v1/images/generations` — 4 provedores, mais de 9 modelos |
+| 📐 **Incorporações** | `/v1/embeddings` — 6 provedores, mais de 9 modelos |
+| 🎤 **Transcrição de áudio** | `/v1/audio/transcriptions` — Compatível com sussurro |
+| 🔊 **Conversão de texto em fala** | `/v1/audio/speech` — Síntese de áudio multiprovedor |
+| 🛡️ **Moderações** | `/v1/moderations` — Verificações de segurança de conteúdo |
+| 🔀 **Reclassificação** | `/v1/rerank` — Reclassificação da relevância dos documentos |
+
+### 🛡️ Resiliência e segurança
+
+| Recurso | O que faz |
+| -------------------------------------------- | ------------------------------------------------------------------------------------ |
+| 🔌 **Disjuntor** | Abertura/fechamento automático por provedor com limites configuráveis |
+| 🛡️ **Rebanho Anti-Trovão** | Mutex + limite de taxa de semáforo para provedores de chaves de API |
+| 🧠 **Cache Semântico** | Cache de duas camadas (assinatura + semântica) reduz custo e latência |
+| ⚡ **Solicitar Idempotência** | Janela de desduplicação 5s para solicitações duplicadas |
+| 🔒 **Falsificação de impressão digital TLS** | Ignore a detecção de bot baseada em TLS via wreq-js |
+| 🌐 **Filtragem de IP** | Lista de permissões/lista de bloqueio para controle de acesso à API |
+| 📊 **Limites de taxas editáveis** | RPM configurável, intervalo mínimo e simultâneo máximo no nível do sistema |
+| 🛡 **Proteção de endpoint de API** | Autenticação + bloqueio de provedor para o endpoint `/models` |
+| 🔒 **Visibilidade do proxy** | Crachás codificados por cores: 🟢 global, 🟡 provedor, 🔵 por conexão com display IP |
+| 🌐 **Configuração de proxy de 3 níveis** | Configurar proxies em nível global, por provedor ou por conexão |
+
+### 📊 Observabilidade e análise
+
+| Recurso | O que faz |
+| ------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| 📝 **Solicitar registro** | Modo de depuração com logs completos de solicitação/resposta |
+| 💾 **Logs de proxy SQLite** | Logs de proxy persistentes sobrevivem às reinicializações do servidor |
+| 📊 **Painel de análise** | Alimentado por recargas: cartões de estatísticas, gráfico de uso de modelo, tabela de provedores |
+| 📈 **Acompanhamento do progresso** | Eventos de progresso SSE opcionais para streaming |
+| 🧪 **Avaliações LLM** | Teste de Golden Set com 4 estratégias de jogo |
+| 🔍 **Solicitar Telemetria** | Agregação de latência p50/p95/p99 + rastreamento X-Request-Id |
+| 📋 **Painel de registros** | Página unificada de 4 guias: Logs de solicitação, Logs de proxy, Logs de auditoria, Console |
+| 🖥️ **Visualizador de registros do console** | Visualizador em estilo terminal em tempo real com filtro de nível, pesquisa, rolagem automática |
+| 📑 **Registro baseado em arquivo** | O interceptor do console captura toda a saída para o arquivo de log JSON com rotação |
+| 🏥 **Painel de saúde** | Tempo de atividade do sistema, estados de disjuntores, bloqueios, estatísticas de cache |
+| 💰 **Acompanhamento de custos** | Gestão orçamentária + configuração de preços por modelo |
+
+### ☁️ Implantação e sincronização
+
+| Recurso | O que faz |
+| --------------------------------------- | ------------------------------------------------------------------------------------ |
+| 💾 **Sincronização na nuvem** | Sincronize a configuração entre dispositivos por meio do Cloudflare Workers |
+| 🌐 **Implante em qualquer lugar** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **Gerenciamento de chaves de API** | Gerar, alternar e definir o escopo de chaves de API por provedor |
+| 🧙 **Assistente de integração** | Configuração guiada em 4 etapas para usuários iniciantes |
+| 🔧 **Painel de Ferramentas CLI** | Configurar com um clique Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Backups de banco de dados** | Backup, restauração, exportação e importação automáticos para todas as configurações |
+| 🌐 **Internacionalização** | i18n completo com next-intl — Suporte Inglês + Português (Brasil) |
+| 🌍 **Seletor de idioma** | Ícone de globo no cabeçalho para troca de idioma em tempo real (🇺🇸/🇧🇷) |
+| 📂 **Diretório de dados personalizado** | `DATA_DIR` env var para substituir o caminho de armazenamento padrão `~/.omniroute` |
+
+
+📖 Detalhes do recurso
+
+### 🎯 Fallback inteligente de 4 camadas
+
+Crie combos com fallback automático:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (your subscription)
+ 2. nvidia/llama-3.3-70b (free NVIDIA API)
+ 3. glm/glm-4.7 (cheap backup, $0.6/1M)
+ 4. if/kimi-k2-thinking (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Rastreamento de cotas em tempo real
+
+- Consumo de token por provedor
+- Redefinir contagem regressiva (5 horas, diariamente, semanalmente)
+- Estimativa de custos para níveis pagos
+- Relatórios mensais de gastos
+
+### 🔄 Tradução de formato
+
+Tradução perfeita entre formatos:
+
+- **OpenAI** ↔ **Claude** ↔ **Gêmeos** ↔ **Respostas OpenAI**
+- Sua ferramenta CLI envia o formato OpenAI → OmniRoute traduz → O provedor recebe o formato nativo
+- Funciona com qualquer ferramenta que suporte endpoints OpenAI personalizados
+- **Higienização de resposta** — Remove campos não padrão para compatibilidade estrita com o OpenAI SDK
+- **Normalização de funções** — `developer` → `system` para não-OpenAI; `system` → `user` para modelos GLM/ERNIE
+- ** Extração de tags Think ** — `` blocos → `reasoning_content` para modelos de pensamento
+- **Saída estruturada** — `json_schema` → `responseMimeType`/`responseSchema` de Gêmeos
+
+### 👥 Suporte para múltiplas contas
+
+- Adicione várias contas por provedor
+- Round-robin automático ou roteamento baseado em prioridade
+- Fallback para a próxima conta quando alguém atingir a cota
+
+### 🔄 Atualização automática de token
+
+- Os tokens OAuth são atualizados automaticamente antes da expiração
+- Não é necessária reautenticação manual
+- Experiência perfeita em todos os provedores
+
+### 🎨 Combos Personalizados
+
+- Crie combinações ilimitadas de modelos
+- 6 estratégias: preencher primeiro, round-robin, poder de duas escolhas, aleatório, menos usado, otimizado para custos
+- Compartilhe combos entre dispositivos com Cloud Sync
+
+### 🏥 Painel de saúde
+
+- Status do sistema (tempo de atividade, versão, uso de memória)
+- Estados do disjuntor por provedor (Fechado/Aberto/Meio-Aberto)
+- Status do limite de taxa e bloqueios ativos
+- Estatísticas de cache de assinatura
+- Telemetria de latência (p50/p95/p99) + cache de prompt
+- Redefinir o status de saúde com um clique
+
+### 🔧 Parque do Tradutor
+
+OmniRoute inclui um poderoso Translator Playground integrado com **4 modos** para depuração, teste e monitoramento de traduções de API:
+
+| Modo | Descrição |
+| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Parque Infantil** | Tradução direta de formato — cole qualquer corpo de solicitação de API e veja instantaneamente como o OmniRoute o traduz entre formatos de provedor (OpenAI ↔ Claude ↔ Gemini ↔ API de respostas). Inclui modelos de exemplo e detecção automática de formato. |
+| **💬 Testador de bate-papo** | Envie solicitações de chat reais por meio do OmniRoute e veja o percurso completo: sua entrada, a solicitação traduzida, a resposta do provedor e a resposta traduzida de volta. Inestimável para validar o roteamento combinado. |
+| **🧪 Bancada de testes** | Modo de teste em lote — defina vários casos de teste com diferentes entradas e resultados esperados, execute-os todos de uma vez e compare os resultados entre provedores e modelos. |
+| **📱Monitoramento ao vivo** | Monitoramento de solicitações em tempo real: observe as solicitações recebidas conforme elas fluem pelo OmniRoute, veja as traduções de formato acontecendo ao vivo e identifique problemas instantaneamente. |
+
+**Acesso:** Painel → Tradutor (barra lateral)
+
+### 💾 Sincronização na nuvem
+
+- Sincronize provedores, combos e configurações entre dispositivos
+- Sincronização automática em segundo plano
+- Armazenamento criptografado seguro
+
+
+
+---
+
+## 📖 Guia de configuração
+
+
+💳 Provedores de assinatura
+
+### Código Claude (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
+```
+
+**Dica profissional:** Use o Opus para tarefas complexas e o Sonnet para velocidade. OmniRoute rastreia cota por modelo!
+
+### Codex OpenAI (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
+```
+
+### Gemini CLI (GRÁTIS 180K/mês!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Melhor valor:** Grande nível gratuito! Use isso antes dos níveis pagos.
+
+### GitHub Copiloto
+
+```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
+```
+
+
+
+
+🔑 Provedores de chave de API
+
+### NVIDIA NIM (1000 créditos GRÁTIS!)
+
+1. Inscreva-se: [build.nvidia.com](https://build.nvidia.com)
+2. Obtenha uma chave de API gratuita (1.000 créditos de inferência incluídos)
+3. Painel → Adicionar Provedor → NVIDIA NIM:
+ - Chave API: `nvapi-your-key`
+
+**Modelos:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` e mais de 50
+
+**Dica profissional:** API compatível com OpenAI — funciona perfeitamente com a tradução de formato do OmniRoute!
+
+### DeepSeek
+
+1. Inscreva-se: [platform.deepseek.com](https://platform.deepseek.com)
+2. Obtenha a chave API
+3. Painel → Adicionar provedor → DeepSeek
+
+**Modelos:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (nível gratuito disponível!)
+
+1. Inscreva-se: [console.groq.com](https://console.groq.com)
+2. Obtenha a chave API (nível gratuito incluído)
+3. Painel → Adicionar Provedor → Groq
+
+**Modelos:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Dica profissional:** Inferência ultrarrápida — melhor para codificação em tempo real!
+
+### OpenRouter (mais de 100 modelos)
+
+1. Inscreva-se: [openrouter.ai](https://openrouter.ai)
+2. Obtenha a chave API
+3. Painel → Adicionar Provedor → OpenRouter
+
+**Modelos:** acesse mais de 100 modelos de todos os principais fornecedores por meio de uma única chave de API.
+
+
+
+
+💰 Provedores baratos (backup)
+
+### GLM-4.7 (redefinição diária, US$ 0,6/1 milhão)
+
+1. Inscreva-se: [Zhipu AI](https://open.bigmodel.cn/)
+2. Obtenha a chave API do plano de codificação
+3. Painel → Adicionar chave API:
+ - Provedor: `glm`
+ - Chave API: `your-key`
+
+**Usar:** `glm/glm-4.7`
+
+**Dica profissional:** O plano de codificação oferece cota 3× com custo de 1/7! Redefinir diariamente às 10h.
+
+### MiniMax M2.1 (redefinição de 5h, US$ 0,20/1 milhão)
+
+1. Inscreva-se: [MiniMax](https://www.minimax.io/)
+2. Obtenha a chave API
+3. Painel → Adicionar chave API
+
+**Usar:** `minimax/MiniMax-M2.1`
+
+**Dica profissional:** Opção mais barata para contexto longo (1 milhão de tokens)!
+
+### Kimi K2 (US$ 9/mês fixo)
+
+1. Inscreva-se: [Moonshot AI](https://platform.moonshot.ai/)
+2. Obtenha a chave API
+3. Painel → Adicionar chave API
+
+**Usar:** `kimi/kimi-latest`
+
+**Dica profissional:** $9 fixos/mês para 10 milhões de tokens = $0,90/custo efetivo de 1 milhão!
+
+
+
+
+🆓 Provedores GRATUITOS (backup de emergência)
+
+### iFlow (8 modelos GRATUITOS)
+
+```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 (3 modelos GRATUITOS)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude GRÁTIS)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Criar Combos
+
+### Exemplo 1: Maximize a assinatura → Backup barato
+
+```
+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
+```
+
+### Exemplo 2: somente gratuito (custo zero)
+
+```
+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!
+```
+
+
+
+
+🔧 Integração CLI
+
+### Cursor IDE
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Código Cláudio
+
+Use a página **Ferramentas CLI** no painel para configuração com um clique ou edite `~/.claude/settings.json` manualmente.
+
+### CLI do Codex
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+###OpenClaw
+
+**Opção 1 — Painel (recomendado):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Opção 2 — Manual:** Editar `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Observação:** OpenClaw só funciona com OmniRoute local. Use `127.0.0.1` em vez de `localhost` para evitar problemas de resolução de IPv6.
+
+### Cline / Continuar / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Modelos Disponíveis
+
+
+Ver todos os modelos disponíveis
+
+**Código Claude (`cc/`)** - Pro/Máx:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Códice (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATUITO:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**Copiloto do GitHub (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Créditos GRATUITOS:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- Mais de 50 modelos em [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - US$ 0,6/1 milhão:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - US$ 0,2/1 milhão:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATUITO:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATUITO:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATUITO:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - mais de 100 modelos:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Qualquer modelo de [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Avaliações (Evals)
+
+OmniRoute inclui uma estrutura de avaliação integrada para testar a qualidade da resposta do LLM em relação a um conjunto dourado. Acesse-o em **Analytics → Evals** no painel.
+
+### Conjunto Dourado Integrado
+
+O "OmniRoute Golden Set" pré-carregado contém 10 casos de teste cobrindo:
+
+- Saudações, matemática, geografia, geração de código
+- Conformidade com o formato JSON, tradução, remarcação
+- Recusa de segurança (conteúdo prejudicial), contagem, lógica booleana
+
+### Estratégias de Avaliação
+
+| Estratégia | Descrição | Exemplo |
+| ---------- | --------------------------------------------------------------------------- | -------------------------------- |
+| `exact` | A saída deve corresponder exatamente | `"4"` |
+| `contains` | A saída deve conter substring (sem distinção entre maiúsculas e minúsculas) | `"Paris"` |
+| `regex` | A saída deve corresponder ao padrão regex | `"1.*2.*3"` |
+| `custom` | Função JS personalizada retorna verdadeiro/falso | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
+
+
+
+> **⚠️ IMPORTANTE para usuários com OmniRoute em VPS/Docker/servidor remoto**
+
+### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
+
+Os provedores **Antigravity** e **Gemini CLI** usam **Google OAuth 2.0** para autenticação. O Google exige que um `redirect_uri` usado no fluxo OAuth seja **exatamente** uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.
+
+As credenciais OAuth incorporadas no OmniRoute estão cadastradas **apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (ex: `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Solução: Configure suas próprias credenciais OAuth
+
+Você precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com o URI do seu servidor.
+
+####Passo a passo
+
+**1. Acesse o Console do Google Cloud**
+
+Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. Crie um novo ID de cliente OAuth 2.0**
+
+- Clique em **"+ Criar credenciais"** → **"ID do cliente OAuth"**
+- Tipo de aplicativo: **"Aplicativo Web"**
+- Nome: escolha qualquer nome (ex: `OmniRoute Remote`)
+
+**3. Adicionar como URIs de redirecionamento autorizados**
+
+No campo **"URIs de redirecionamento autorizados"**, adicionado:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Substitua `seu-servidor.com` pelo domínio ou IP do seu servidor (inclua a porta se necessário, ex: `http://45.33.32.156:20128/callback`).
+
+**4. Salve e copie as credenciais**
+
+Após criar, o Google mostrará o **Client ID** e o **Client Secret**.
+
+**5. Configurar como variáveis de ambiente**
+
+No 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**
+
+Painel → Provedores → Antigravidade (ou Gemini CLI) → OAuth
+
+Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e a autenticação funcionará.
+
+---
+
+### Solução alternativa temporária (sem configurar credenciais próprias)
+
+Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
+
+1. O OmniRoute abrirá uma URL de autorização do Google
+2. Após você autorizar, o Google tentará redirecionar para `localhost` (que falha no servidor remoto)
+3. **Copie a URL completa** da barra de endereço do seu navegador (mesmo que a página não carregue)
+4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
+5. Clique em **"Conectar"**
+
+> Esta solução alternativa funciona porque o código de autorização na URL é válido, independentemente do redirecionamento ter sido carregado ou não.
+
+---
+
+## 🐛 Solução de problemas
+
+
+Clique para expandir o guia de solução de problemas
+
+**"O modelo de linguagem não forneceu mensagens"**
+
+- Cota do provedor esgotada → Verifique o rastreador de cota do painel
+- Solução: use o combo substituto ou mude para um nível mais barato
+
+** Limitação de taxa **
+
+- Cota de assinatura esgotada → Fallback para GLM/MiniMax
+- Adicionar combinação: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**O token OAuth expirou**
+
+- Atualizado automaticamente pelo OmniRoute
+- Se os problemas persistirem: Painel → Provedor → Reconectar
+
+**Custos elevados**
+
+- Verifique as estatísticas de uso em Painel → Custos
+- Mude o modelo primário para GLM/MiniMax
+- Use o nível gratuito (Gemini CLI, iFlow) para tarefas não críticas
+
+**Painel abre na porta errada**
+
+- Definir `PORT=20128` e `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Erros de sincronização na nuvem**
+
+- Verifique `BASE_URL` aponta para sua instância em execução
+- Verifique os pontos `CLOUD_URL` para o endpoint de nuvem esperado
+- Mantenha os valores `NEXT_PUBLIC_*` alinhados com os valores do lado do servidor
+
+**Primeiro login não funciona**
+
+- Verifique `INITIAL_PASSWORD` em `.env`
+- Se não definida, a senha substituta é `123456`
+
+**Sem registros de solicitação**
+
+- Definir `ENABLE_REQUEST_LOGS=true` em `.env`
+
+**O teste de conexão mostra "Inválido" para provedores compatíveis com OpenAI**
+
+- Muitos provedores não expõem um endpoint `/models`
+- OmniRoute v1.0.6+ inclui validação de fallback por meio de conclusões de chat
+- Certifique-se de que o URL base inclua o sufixo `/v1`
+
+
+
+---
+
+## 🛠️ Pilha de tecnologia
+
+- **Tempo de execução**: Node.js 18–22 LTS (⚠️ Node.js 24+ **não é compatível** — `better-sqlite3` binários nativos são incompatíveis)
+- **Idioma**: TypeScript 5.9 — **100% TypeScript** em `src/` e `open-sse/` (v1.0.6)
+- **Estrutura**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Banco de dados**: LowDB (JSON) + SQLite (estado do domínio + logs de proxy)
+- **Streaming**: eventos enviados pelo servidor (SSE)
+- **Autenticação**: OAuth 2.0 (PKCE) + JWT + chaves de API
+- **Testes**: executor de testes Node.js (mais de 368 testes de unidade)
+- **CI/CD**: GitHub Actions (publicação automática de npm + Docker Hub no lançamento)
+- **Site**: [omniroute.online](https://omniroute.online)
+- **Pacote**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Resiliência**: Disjuntor, espera exponencial, rebanho anti-trovão, falsificação de TLS
+
+---
+
+## 📖 Documentação
+
+| Documento | Descrição |
+| -------------------------------------------- | ------------------------------------------------------ |
+| [User Guide](docs/USER_GUIDE.md) | Provedores, combos, integração CLI, implantação |
+| [API Reference](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Problemas e soluções comuns |
+| [Architecture](docs/ARCHITECTURE.md) | Arquitetura do sistema e componentes internos |
+| [Contributing](CONTRIBUTING.md) | Configuração e diretrizes de desenvolvimento |
+| [OpenAPI Spec](docs/openapi.yaml) | Especificação OpenAPI 3.0 |
+| [Security Policy](SECURITY.md) | Relatórios de vulnerabilidades e práticas de segurança |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: configuração de VM + nginx + Cloudflare |
+| [Features Gallery](docs/FEATURES.md) | Tour visual do painel com capturas de tela |
+
+### 📸 Visualização do painel
+
+
+Clique para ver as capturas de tela do painel
+
+| Página | Captura de tela |
+| -------------------- | ------------------------------------------------- |
+| **Fornecedores** |  |
+| **Combos** |  |
+| **Análise** |  |
+| **Saúde** |  |
+| **Tradutor** |  |
+| **Configurações** |  |
+| **Ferramentas CLI** |  |
+| **Registros de uso** |  |
+| **Ponto final** |  |
+
+
+
+---
+
+## 🗺️ Roteiro
+
+OmniRoute tem **210+ recursos planejados** em diversas fases de desenvolvimento. Aqui estão as principais áreas:
+
+| Categoria | Recursos planejados | Destaques |
+| --------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------ |
+| 🧠 **Roteamento e Inteligência** | 25+ | Roteamento de menor latência, roteamento baseado em tags, simulação de cota, seleção de conta P2C |
+| 🔒 **Segurança e Conformidade** | 20+ | Proteção SSRF, camuflagem de credenciais, limite de taxa por endpoint, escopo de chave de gerenciamento |
+| 📊 **Observabilidade** | 15+ | Integração OpenTelemetry, monitoramento de cotas em tempo real, rastreamento de custos por modelo |
+| 🔄 **Integrações com Provedores** | 20+ | Registro de modelo dinâmico, resfriamento de provedor, Codex multicontas, análise de cotas do Copilot |
+| ⚡ **Desempenho** | 15+ | Camada de cache dupla, cache de prompt, cache de resposta, manutenção de atividade de streaming, API em lote |
+| 🌐 **Ecossistema** | 10+ | API WebSocket, configuração hot-reload, armazenamento de configuração distribuído, modo comercial |
+
+### 🔜 Em breve
+
+- 🔗 **Integração OpenCode** — Suporte de provedor nativo para o IDE de codificação OpenCode AI
+- 🔗 **Integração TRAE** — Suporte total para a estrutura de desenvolvimento TRAE AI
+- 📦 **API Batch** — Processamento assíncrono em lote para solicitações em massa
+- 🎯 **Roteamento baseado em tags** — Roteie solicitações com base em tags personalizadas e metadados
+- 💰 **Estratégia de custo mais baixo** — Selecione automaticamente o provedor mais barato disponível
+
+> 📝 Especificações completas de recursos disponíveis em [**OMNI_TOKEN_147**](docs/new-features/) (217 especificações detalhadas)
+
+---
+
+## 📧 Suporte
+
+> 💬 **Junte-se à nossa comunidade!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Obtenha ajuda, compartilhe dicas e fique atualizado.
+
+- **Site**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problemas**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Projeto Original**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Colaboradores
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Como contribuir
+
+1. Bifurque o repositório
+2. Crie sua ramificação de recursos (`git checkout -b feature/amazing-feature`)
+3. Confirme suas alterações (`git commit -m 'Add amazing feature'`)
+4. Envie para a ramificação (`git push origin feature/amazing-feature`)
+5. Abra uma solicitação pull
+
+Consulte [CONTRIBUTING.md](CONTRIBUTING.md) para obter diretrizes detalhadas.
+
+### Lançando uma nova versão
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 História das Estrelas
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Agradecimentos
+
+Agradecimentos especiais a **[9router](https://github.com/decolua/9router)** de **[decolua](https://github.com/decolua)** — o projeto original que inspirou este fork. OmniRoute se baseia nessa base incrível com recursos adicionais, APIs multimodais e uma reescrita completa do TypeScript.
+
+Agradecimentos especiais a **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — a implementação Go original que inspirou esta versão JavaScript.
+
+---
+
+## 📄 Licença
+
+Licença MIT - consulte [LICENSE](LICENSE) para obter detalhes.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gateway de IA Gratuito
+
+
+
+### Nunca pare de codificar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
+
+_Seu proxy universal de API — um endpoint, mais de 36 provedores, tempo de inatividade zero._
+
+### 🌐 Internacionalização (i18n)
+
+O painel do OmniRoute suporta **múltiplos idiomas**. Atualmente disponível em:
+
+| Idioma | Código | Estado |
+| --------------------- | ------- | ----------- |
+| 🇺🇸 Inglês | `en` | ✅ Completo |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Completo |
+
+**Para alterar o idioma:** Clique no seletor de idioma (🇺🇸 PT) no cabeçalho do painel → selecione o idioma desejado.
+
+**Para adicionar um novo idioma:**
+
+1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
+2. Adicione o código em `src/i18n/config.ts` → `LOCALES` e `LANGUAGES`
+3. Reinicie o servidor
+
+### ⚡ Início Rápido
+
+```bash
+# Instalar via npm
+npx omniroute@latest
+
+# Ou rodar do código-fonte
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+### 🐳 Docker
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Funcionalidades Principais
+
+- **36+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
+- **Roteamento inteligente** — Fallback automático entre provedores
+- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
+- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
+- **Cache semântico** — Reduz custos e latência
+- **OAuth automático** — Tokens renovam automaticamente
+- **Combos personalizados** — 6 estratégias de roteamento
+- **Dashboard completo** — Monitoramento, logs, análises, configurações
+- **Ferramentas CLI** — Configure Claude Code, Codex, Cursor, Cline com um clique
+- **100% TypeScript** — Código limpo e digitado
+
+### 📖 Documentação
+
+| Documento | Descrição |
+| ----------------------------------------------- | -------------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, implantar |
+| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
+| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e portas do sistema |
+| [Contribuição](CONTRIBUTING.md) | Configuração de desenvolvimento e diretrizes |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: VM + nginx + Cloudflare |
+
+### 📧Suporte
+
+> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
+
+- **Site**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problemas**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Construído com ❤️ para desenvolvedores que codificam 24 horas por dia, 7 dias por semana
+
+ omniroute.online
+
diff --git a/README.ro.md b/README.ro.md
new file mode 100644
index 0000000000..d324b2781d
--- /dev/null
+++ b/README.ro.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — Gateway-ul gratuit AI
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Nu opriți niciodată codificarea. Dirijare inteligentă către **modele AI GRATUITE și cu costuri reduse** cu rezervă automată.
+
+_Proxy-ul dvs. universal API - un punct final, peste 36 de furnizori, zero timpi de nefuncționare._
+
+**Finalizări de chat • Încorporare • Generare de imagini • Audio • Reclasificare • 100% TypeScript**
+
+---
+
+### 🤖 Furnizor AI gratuit pentru agenții tăi preferați de codare
+
+_Conectați orice instrument IDE sau CLI alimentat de AI prin OmniRoute — gateway API gratuit pentru codare nelimitată._
+
+
+
+---
+
+## 🤔 Чому OmniRoute?
+
+**Припиніть витрачати гроші та досягати лімітів:**
+
+- Квота підписки закінчується без використання кожного місяця
+- Обмеження швидкості перешкоджають кодуванню в середині
+- Дорогі API ($20-50/місяць за постачальника)
+- Ручне перемикання між провайдерами
+
+**OmniRoute вирішує цю проблему:**
+
+- ✅ **Збільште кількість підписок** - Відстежуйте квоту, використовуйте кожен біт перед скиданням
+- ✅ **Автоматичний резерв** - Підписка → Ключ API → Дешево → Безкоштовно, без простоїв
+- ✅ **Кілька облікових записів** - Циклічний цикл між обліковими записами кожного постачальника
+- ✅ **Універсальний** - Працює з Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, будь-яким інструментом CLI
+
+---
+
+## 🔄 Як це працює
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Швидкий старт
+
+**1. Встановити глобально:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Інформаційна панель відкривається в `http://localhost:20128`
+
+| Команда | Опис |
+| ----------------------- | ---------------------------------------------- |
+| `omniroute` | Запустити сервер (порт за замовчуванням 20128) |
+| `omniroute --port 3000` | Використовувати спеціальний порт |
+| `omniroute --no-open` | Не відкривати автоматично браузер |
+| `omniroute --help` | Показати довідку |
+
+**2. Підключіть БЕЗКОШТОВНОГО провайдера:**
+
+Інформаційна панель → Постачальники → Підключити **Claude Code** або **Antigravity** → Вхід OAuth → Готово!
+
+**3. Використовуйте у своєму інструменті CLI:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**Ось і все!** Почніть кодувати з БЕЗКОШТОВНИМИ моделями ШІ.
+
+**Альтернатива — запустити з джерела:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Докер
+
+OmniRoute доступний як загальнодоступний образ Docker на [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Швидкий біг:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**З файлом середовища:**
+
+```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 Compose:**
+
+```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
+```
+
+| Зображення | Тег | Розмір | Опис |
+| ------------------------ | -------- | ------- | -------------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 МБ | Останній стабільний випуск |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250 МБ | Поточна версія |
+
+---
+
+## 💰 Короткий огляд цін
+
+| Рівень | Постачальник | Вартість | Скидання квоти | Найкраще для |
+| ------------------ | ---------------- | ------------------------------- | ----------------------------- | ---------------------------- |
+| **💳 ПІДПИСКА** | Клод Код (Pro) | 20 доларів США на місяць | 5 годин + щотижня | Вже підписані |
+| | Codex (Plus/Pro) | $20-200/міс | 5 годин + щотижня | Користувачі OpenAI |
+| | Gemini CLI | **БЕЗКОШТОВНО** | 180 тис./місяць + 1 тис./день | всі! |
+| | Копілот GitHub | $10-19/міс | Щомісяця | Користувачі GitHub |
+| **🔑 КЛЮЧ API** | NVIDIA NIM | **БЕЗКОШТОВНО** (1000 кредитів) | Одноразова | Безкоштовне тестування рівня |
+| | DeepSeek | Оплата за використання | Жодного | Краща ціна/якість |
+| | Groq | Безкоштовний рівень + платний | Оцінка обмежена | Надшвидкий висновок |
+| | xAI (Грок) | Оплата за використання | Жодного | Моделі Grok |
+| | Містраль | Безкоштовний рівень + платний | Оцінка обмежена | Європейський ШІ |
+| | OpenRouter | Оплата за використання | Жодного | 100+ моделей |
+| **💰 ДЕШЕВО** | GLM-4.7 | $0,6/1 млн | Щодня о 10 ранку | Резервне копіювання бюджету |
+| | MiniMax M2.1 | $0,2/1 млн | 5-годинний роликовий | Найдешевший варіант |
+| | Кімі К2 | 9 $/міс квартира | 10 млн токенів/міс | Передбачувана вартість |
+| **🆓 БЕЗКОШТОВНО** | iFlow | $0 | Необмежений | 8 моделей безкоштовно |
+| | Квен | $0 | Необмежений | 3 моделі безкоштовно |
+| | Кіро | $0 | Необмежений | Клод безкоштовно |
+
+**💡 Порада професіонала:** Почніть із Gemini CLI (180 тис. безкоштовно/місяць) + iFlow (необмежено безкоштовно) = 0 доларів США!
+
+---
+
+## 🎯 Випадки використання
+
+### Випадок 1: «У мене є підписка на Claude Pro»
+
+**Проблема:** Квота закінчується невикористаною, обмеження швидкості під час інтенсивного кодування
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (use subscription fully)
+ 2. glm/glm-4.7 (cheap backup when quota out)
+ 3. if/kimi-k2-thinking (free emergency fallback)
+
+Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
+vs. $20 + hitting limits = frustration
+```
+
+### Випадок 2: "Я хочу нульову вартість"
+
+**Проблема:** не можу дозволити собі підписку, потрібне надійне кодування ШІ
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K free/month)
+ 2. if/kimi-k2-thinking (unlimited free)
+ 3. qw/qwen3-coder-plus (unlimited free)
+
+Monthly cost: $0
+Quality: Production-ready models
+```
+
+### Випадок 3: «Мені потрібне кодування 24/7, без перерв»
+
+**Проблема:** Дедлайни, не можу дозволити собі простою
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (best quality)
+ 2. cx/gpt-5.2-codex (second subscription)
+ 3. glm/glm-4.7 (cheap, resets daily)
+ 4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
+ 5. if/kimi-k2-thinking (free unlimited)
+
+Result: 5 layers of fallback = zero downtime
+```
+
+### Випадок 4: «Я хочу БЕЗКОШТОВНОГО ШІ в OpenClaw»
+
+**Проблема:** потрібен помічник штучного інтелекту в програмах для обміну повідомленнями, повністю безкоштовний
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (unlimited free)
+ 2. if/minimax-m2.1 (unlimited free)
+ 3. if/kimi-k2-thinking (unlimited free)
+
+Monthly cost: $0
+Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Основні характеристики
+
+### 🧠 Основна маршрутизація та інтелект
+
+| Особливість | Що він робить |
+| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| 🎯 **Розумний 4-рівневий резервний варіант** | Авто-маршрут: Підписка → Ключ API → Дешево → Безкоштовно |
+| 📊 **Відстеження квот у реальному часі** | Підрахунок живих токенів + скидання зворотного відліку для кожного постачальника |
+| 🔄 **Формат перекладу** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro seamless + відповідь санація |
+| 👥 **Підтримка кількох облікових записів** | Кілька облікових записів на постачальника з інтелектуальним вибором |
+| 🔄 **Автоматичне оновлення токенів** | Маркери OAuth оновлюються автоматично з повторною спробою |
+| 🎨 **Користувацькі комбо** | 6 стратегій: спочатку заповнює, циклічний, p2c, випадковий, найменш використовуваний, оптимізований за витратами |
+| 🧩 **Користувацькі моделі** | Додайте будь-який ідентифікатор моделі до будь-якого постачальника |
+| 🌐 **Wildcard Router** | Динамічно направляйте шаблони `provider/*` до будь-якого постачальника |
+| 🧠 **Мислення про бюджет** | Наскрізний, автоматичний, настроюваний і адаптивний режими для моделей міркування |
+| 💬 **Швидке впровадження системи** | Глобальне системне підказка застосовується до всіх запитів |
+| 📄 **API відповідей** | Повна підтримка OpenAI Responses API (`/v1/responses`) для Codex |
+
+### 🎵 Мультимодальні API
+
+| Особливість | Що він робить |
+| ---------------------------------- | ----------------------------------------------------- |
+| 🖼️ **Створення зображень** | `/v1/images/generations` — 4 провайдери, 9+ моделей |
+| 📐 **Вбудовування** | `/v1/embeddings` — 6 провайдерів, 9+ моделей |
+| 🎤 **Транскрипція аудіо** | `/v1/audio/transcriptions` — сумісний із Whisper |
+| 🔊 **Створення тексту в мовлення** | `/v1/audio/speech` — Багатопровайдерний аудіосинтез |
+| 🛡️ **Модерації** | `/v1/moderations` — Перевірка безпеки вмісту |
+| 🔀 **Переранжування** | `/v1/rerank` — Переранжування релевантності документа |
+
+### 🛡️ Стійкість і безпека
+
+| Особливість | Що він робить |
+| ------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 🔌 **Автоматичний вимикач** | Автоматичне відкриття/закриття для кожного постачальника з настроюваними пороговими значеннями |
+| 🛡️ **Anti-Thundering Herd** | Mutex + обмеження швидкості семафора для постачальників ключів API |
+| 🧠 **Семантичний кеш** | Дворівневий кеш (підпис + семантика) зменшує вартість і затримку |
+| ⚡ **Запит на ідемпотентність** | 5-секундне вікно дедупляції для дублікатів запитів |
+| 🔒 **Підробка відбитків пальців TLS** | Обійти виявлення ботів на основі TLS через wreq-js |
+| 🌐 **IP-фільтрація** | Білий/чорний список для керування доступом API |
+| 📊 **Редаговані ліміти ставок** | Конфігурація RPM, мінімальний проміжок і максимальна одночасність на рівні системи |
+| 🛡 **API Endpoint Protection** | Аутентифікація + блокування постачальника для кінцевої точки `/models` |
+| 🔒 **Видимість проксі** | Кольорові значки: 🟢 глобальний, 🟡 постачальник, 🔵 кожне підключення з відображенням IP |
+| 🌐 **3-рівнева конфігурація проксі** | Налаштуйте проксі-сервери на глобальному рівні, на рівні кожного постачальника чи кожного підключення |
+
+### 📊 Спостережливість і аналітика
+
+| Особливість | Що він робить |
+| ------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
+| 📝 **Подати запит на реєстрацію** | Режим налагодження з повними журналами запитів/відповідей |
+| 💾 **Журнали проксі SQLite** | Постійні журнали проксі зберігаються після перезавантаження сервера |
+| 📊 **Інформаційна панель аналітики** | На основі Recharts: картки статистики, діаграма використання моделей, таблиця провайдерів |
+| 📈 **Відстеження прогресу** | Увімкніть події прогресу SSE для потокового передавання |
+| 🧪 **Оцінки LLM** | Тестування золотого набору з 4 стратегіями матчу |
+| 🔍 **Надіслати запит на телеметрію** | агрегація затримок p50/p95/p99 + трасування X-Request-Id |
+| 📋 **Інформаційна панель журналів** | Уніфікована сторінка з 4 вкладками: журнали запитів, журнали проксі, журнали аудиту, консоль |
+| 🖥️ **Перегляд журналу консолі** | Переглядач у режимі реального часу у стилі терміналу з фільтром рівнів, пошуком, автоматичним прокручуванням |
+| 📑 **Логування на основі файлів** | Перехоплювач консолі захоплює весь вихід у файл журналу JSON із обертанням |
+| 🏥 **Інформаційна панель здоров’я** | Час роботи системи, стани автоматичного вимикача, блокування, статистика кешу |
+| 💰 **Відстеження витрат** | Управління бюджетом + конфігурація ціноутворення для кожної моделі |
+
+### ☁️ Розгортання та синхронізація
+
+| Особливість | Що він робить |
+| ------------------------------------------- | ----------------------------------------------------------------------------------- |
+| 💾 **Хмарна синхронізація** | Синхронізація конфігурації між пристроями через Cloudflare Workers |
+| 🌐 **Розгортайте будь-де** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **Керування ключами API** | Генерувати, обертати та використовувати ключі API для кожного постачальника |
+| 🧙 **Майстер адаптації** | 4-етапне покрокове налаштування для користувачів, які вперше |
+| 🔧 **Інформаційна панель інструментів CLI** | Налаштувати в один клік Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Резервне копіювання БД** | Автоматичне резервне копіювання, відновлення, експорт і імпорт для всіх налаштувань |
+| 🌐 **Інтернаціоналізація** | Повний i18n із next-intl — підтримка англійської та португальської (Бразилія) |
+| 🌍 **Вибір мови** | Значок глобуса в заголовку для перемикання мов у реальному часі (🇺🇸/🇧🇷) |
+| 📂 **Каталог користувацьких даних** | `DATA_DIR` змінна env для перевизначення типового шляху зберігання `~/.omniroute` |
+
+
+📖 Деталі функції
+
+### 🎯 Smart 4-Tier Fallback
+
+Створюйте комбо з автоматичним резервним варіантом:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (your subscription)
+ 2. nvidia/llama-3.3-70b (free NVIDIA API)
+ 3. glm/glm-4.7 (cheap backup, $0.6/1M)
+ 4. if/kimi-k2-thinking (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Відстеження квот у реальному часі
+
+- Споживання токенів на постачальника
+- Скидання зворотного відліку (5 годин, щодня, щотижня)
+- Оцінка вартості платних рівнів
+- Щомісячні звіти про витрати
+
+### 🔄 Переклад формату
+
+Плавний переклад між форматами:
+
+- **OpenAI** ↔ **Клод** ↔ **Близнюки** ↔ **Відповіді OpenAI**
+- Ваш інструмент CLI надсилає формат OpenAI → OmniRoute перекладає → Постачальник отримує рідний формат
+- Працює з будь-яким інструментом, який підтримує спеціальні кінцеві точки OpenAI
+- **Дезінфікація відповіді** — видаляє нестандартні поля для суворої сумісності з OpenAI SDK
+- **Нормалізація ролі** — `developer` → `system` для не-OpenAI; `system` → `user` для моделей GLM/ERNIE
+- **Вилучення тегів мислення** — `` блоків → `reasoning_content` для моделей мислення
+- **Структурований вихід** — `json_schema` → Gemini `responseMimeType`/`responseSchema`
+
+### 👥 Підтримка кількох облікових записів
+
+- Додайте кілька облікових записів для кожного постачальника
+- Автоматична циклічна або пріоритетна маршрутизація
+- Повернення до наступного облікового запису, коли досягається квота
+
+### 🔄 Автоматичне оновлення токенів
+
+- Маркери OAuth автоматично оновлюються до закінчення терміну дії
+- Повторна автентифікація вручну не потрібна
+- Бездоганний досвід у всіх постачальників
+
+### 🎨 Спеціальні комбо
+
+- Створюйте необмежену кількість комбінацій моделей
+- 6 стратегій: спочатку заповнюй, циклічна, сила двох варіантів, випадкова, найменш використовувана, оптимізована за витратами
+- Діліться комбо на різних пристроях за допомогою Cloud Sync
+
+### 🏥 Інформаційна панель здоров'я
+
+- Статус системи (час роботи, версія, використання пам'яті)
+- Стани автоматичного вимикача для кожного постачальника (замкнуто/розімкнуто/напіврозімкнуто)
+- Статус обмеження швидкості та активні блокування
+ — Статистика кешу підписів
+- Телеметрія затримки (p50/p95/p99) + кеш підказок
+- Скинути стан здоров'я одним клацанням миші
+
+### 🔧 Ігровий майданчик для перекладачів
+
+OmniRoute містить потужний вбудований Translator Playground із **4 режимами** для налагодження, тестування та моніторингу перекладів API:
+
+| Режим | Опис |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Ігровий майданчик** | Прямий переклад формату — вставте будь-яке тіло запиту API та миттєво подивіться, як OmniRoute перекладає його між форматами постачальників (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Включає приклади шаблонів і автоматичне визначення формату. |
+| **💬 Тестер чату** | Надсилайте справжні запити в чат через OmniRoute і переглядайте повну інформацію: ваші дані, перекладений запит, відповідь постачальника та перекладену відповідь. Безцінний для перевірки комбінованої маршрутизації. |
+| **🧪 Тестовий стенд** | Режим пакетного тестування — визначте кілька тестів із різними вхідними та очікуваними результатами, запустіть їх усі одночасно та порівняйте результати між постачальниками та моделями. |
+| **📱 Live Monitor** | Моніторинг запитів у режимі реального часу — спостерігайте за вхідними запитами, коли вони проходять через OmniRoute, переглядайте трансляції форматів у реальному часі та миттєво виявляйте проблеми. |
+
+**Доступ:** Інформаційна панель → Перекладач (бічна панель)
+
+### 💾 Cloud Sync
+
+- Синхронізація постачальників, комбінацій і налаштувань на всіх пристроях
+- Автоматична фонова синхронізація
+- Безпечне зашифроване сховище
+
+
+
+---
+
+## 📖 Посібник із налаштування
+
+
+💳 Постачальники підписки
+
+### 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
+```
+
+**Професійна порада:** використовуйте Opus для складних завдань, Sonnet для швидкості. OmniRoute відстежує квоту на модель!
+
+### 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
+```
+
+### Gemini CLI (БЕЗКОШТОВНО 180K/місяць!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Найкраще:** Величезний безкоштовний рівень! Використовуйте це перед платними рівнями.
+
+### Копілот GitHub
+
+```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
+
+### NVIDIA NIM (БЕЗКОШТОВНІ 1000 кредитів!)
+
+1. Зареєструйтесь: [build.nvidia.com](https://build.nvidia.com)
+2. Отримайте безкоштовний ключ API (1000 кредитів включено)
+3. Інформаційна панель → Додати постачальника → NVIDIA NIM:
+ - Ключ API: `nvapi-your-key`
+
+**Моделі:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` та понад 50 інших
+
+**Порада професіонала:** OpenAI-сумісний API — бездоганно працює з перекладом формату OmniRoute!
+
+### DeepSeek
+
+1. Зареєструйтеся: [platform.deepseek.com](https://platform.deepseek.com)
+2. Отримайте ключ API
+3. Інформаційна панель → Додати постачальника → DeepSeek
+
+**Моделі:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (доступний безкоштовний рівень!)
+
+1. Зареєструйтеся: [console.groq.com](https://console.groq.com)
+2. Отримайте ключ API (включає безкоштовний рівень)
+3. Інформаційна панель → Додати постачальника → Groq
+
+**Моделі:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Професійна порада:** Надшвидкий висновок — найкращий для кодування в реальному часі!
+
+### OpenRouter (100+ моделей)
+
+1. Зареєструйтеся: [openrouter.ai](https://openrouter.ai)
+2. Отримайте ключ API
+3. Інформаційна панель → Додати провайдера → OpenRouter
+
+**Моделі:** Отримуйте доступ до понад 100 моделей від усіх основних постачальників за допомогою єдиного ключа API.
+
+
+
+
+💰 Дешеві постачальники (резервні)
+
+### GLM-4.7 (щоденне скидання, $0,6/1 млн)
+
+1. Зареєструйтеся: [Zhipu AI](https://open.bigmodel.cn/)
+2. Отримайте ключ API від Coding Plan
+3. Інформаційна панель → Додати ключ API:
+ - Постачальник: `glm`
+ - Ключ API: `your-key`
+
+**Використовуйте:** `glm/glm-4.7`
+
+**Професійна порада:** План кодування пропонує 3x квоту за 1/7 вартості! Скидання щодня о 10:00.
+
+### MiniMax M2.1 (5 годин скидання, $0,20/1 млн)
+
+1. Зареєструйтеся: [MiniMax](https://www.minimax.io/)
+2. Отримайте ключ API
+3. Інформаційна панель → Додати ключ API
+
+**Використовуйте:** `minimax/MiniMax-M2.1`
+
+**Порада:** Найдешевший варіант для довгого контексту (1 млн токенів)!
+
+### Kimi K2 ($9/місяць)
+
+1. Підпишіться: [Moonshot AI](https://platform.moonshot.ai/)
+2. Отримайте ключ API
+3. Інформаційна панель → Додати ключ API
+
+**Використання:** `kimi/kimi-latest`
+
+**Професійна порада:** Фіксовані 9 доларів США на місяць за 10 мільйонів токенів = 0,90 доларів США за 1 млн. ефективних витрат!
+
+
+
+
+🆓 БЕЗКОШТОВНІ постачальники (аварійне резервне копіювання)
+
+### iFlow (8 БЕЗКОШТОВНИХ моделей)
+
+```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 (3 БЕЗКОШТОВНІ моделі)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Кіро (Клод БЕЗКОШТОВНО)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Створення комбо
+
+### Приклад 1: максимізація підписки → дешеве резервне копіювання
+
+```
+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
+```
+
+### Приклад 2: лише безкоштовно (нульова вартість)
+
+```
+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
+
+### Курсор IDE
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Клод Код
+
+Використовуйте сторінку **Інструменти CLI** на інформаційній панелі для налаштування одним клацанням миші або редагуйте `~/.claude/settings.json` вручну.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Варіант 1 — Інформаційна панель (рекомендовано):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Варіант 2 — вручну:** Редагувати `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Примітка:** OpenClaw працює лише з локальним OmniRoute. Використовуйте `127.0.0.1` замість `localhost`, щоб уникнути проблем із вирішенням IPv6.
+
+### Cline / Продовжити / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Доступні моделі
+
+
+Переглянути всі доступні моделі
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - БЕЗКОШТОВНО:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**Копілот GitHub (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - БЕЗКОШТОВНІ кредити:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- більше 50 моделей на [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - 0,6 $/1 млн:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0,2/1 млн.:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - БЕЗКОШТОВНО:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - БЕЗКОШТОВНО:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - БЕЗКОШТОВНО:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ моделей:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Будь-яка модель від [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Оцінки (Evals)
+
+OmniRoute містить вбудовану систему оцінювання для перевірки якості відповіді LLM на відповідність золотому набору. Доступ до нього через **Аналітика → Оцінки** на інформаційній панелі.
+
+### Вбудований Золотий набір
+
+Попередньо завантажений "Золотий набір OmniRoute" містить 10 тестів, які охоплюють:
+
+- Привітання, математика, географія, генерація коду
+- Відповідність формату JSON, переклад, розмітка
+- Відмова безпеки (шкідливий контент), підрахунок, булева логіка
+
+### Стратегії оцінювання
+
+| Стратегія | Опис | Приклад |
+| ---------- | -------------------------------------------------------------- | -------------------------------- |
+| `exact` | Вихідні дані повинні точно відповідати | `"4"` |
+| `contains` | Вихідні дані повинні містити підрядок (незалежно від регістру) | `"Paris"` |
+| `regex` | Вихідні дані мають відповідати шаблону регулярного виразу | `"1.*2.*3"` |
+| `custom` | Спеціальна функція JS повертає true/false | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (віддалене налаштування OAuth)
+
+
+
+> **⚠️ ВАЖЛИВО для використання OmniRoute у віддаленому VPS/Docker/сервері**
+
+### Чи OAuth для Antigravity / Gemini CLI не підтримує віддалені сервери?
+
+Провідники **Antigravity** і **Gemini CLI** використовують **Google OAuth 2.0** для автентифікації. Google вимагає, щоб `redirect_uri` не використовував fluxo OAuth, який **exatamente** має URI перед кадастрадами без додатка Google Cloud Console.
+
+Оскільки повноваження OAuth embutidas, OmniRoute не встановлено в кадастрадах **apenas para `localhost`**. Якщо ви маєте доступ до OmniRoute у віддаленому сервері (наприклад: `https://omniroute.meuservidor.com`), або Google rejeita a autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Рішення: налаштуйте власні облікові записи OAuth
+
+Потрібно точно написати **Ідентифікатор клієнта OAuth 2.0** у Google Cloud Console через URI вашого сервера.
+
+#### Passo a passo
+
+**1. Доступ до 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 ID клієнта**
+
+- Натисніть **"+ Створити облікові дані"** → **"Ідентифікатор клієнта OAuth"**
+- Tipo de aplicativo: **"Веб-програма"**
+- Назва: escolha qualquer nome (наприклад: `OmniRoute Remote`)
+
+**3. Додайте як авторизовані URI перенаправлення**
+
+Без поля **"Авторизовані URI перенаправлення"**, додайте:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Замініть `seu-servidor.com` домен або IP на свій сервер (включно з необхідним портом, наприклад: `http://45.33.32.156:20128/callback`).
+
+**4. Зберегти електронну копію як ідентифікацію**
+
+Наприклад, Google показує **Ідентифікатор клієнта** і **Секрет клієнта**.
+
+**5. Налаштувати як variáveis de ambiente**
+
+Немає `.env` (або наших варіантів середовища 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**
+
+Інформаційна панель → Постачальники → Антигравітація (або Gemini CLI) → OAuth
+
+Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e a authenticação funcionará.
+
+---
+
+### Тимчасове вирішення проблеми (необхідне налаштування облікових записів)
+
+Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
+
+1. OmniRoute скидає URL-адресу авторизації Google
+2. Якщо ви авторизуєтеся, перенаправлення даних Google для `localhost` (неможливо віддалено від сервера)
+3. **Скопіюйте повну URL-адресу** для переходу до вашого браузера (повідомте, що сторінка не створена)
+4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
+5. Натисніть **"Підключити"**
+
+> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
+
+---
+
+## 🐛 Усунення несправностей
+
+
+Натисніть, щоб розгорнути посібник з усунення несправностей
+
+**"Мовна модель не надавала повідомлень"**
+
+- Квота постачальника вичерпана → Перевірте систему відстеження квот на інформаційній панелі
+- Рішення: скористайтеся комбінованим альтернативним варіантом або перейдіть на дешевший рівень
+
+**Обмеження швидкості**
+
+— Вичерпана квота на підписку → Повернення до GLM/MiniMax
+
+- Додати комбо: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Термін дії маркера OAuth минув**
+
+— Автоматично оновлено OmniRoute
+
+- Якщо проблеми не зникають: Інформаційна панель → Постачальник → Повторне підключення
+
+**Високі витрати**
+
+- Перевірте статистику використання в Інформаційній панелі → Витрати
+- Переключіть основну модель на GLM/MiniMax
+- Використовуйте безкоштовний рівень (Gemini CLI, iFlow) для некритичних завдань
+
+**Інформаційна панель відкривається через неправильний порт**
+
+- Встановити `PORT=20128` та `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Помилки хмарної синхронізації**
+
+- Переконайтеся, що `BASE_URL` вказує на ваш запущений екземпляр
+- Перевірте `CLOUD_URL` вказує на очікувану кінцеву точку хмари
+- Зберігайте значення `NEXT_PUBLIC_*` у відповідності зі значеннями на стороні сервера
+
+**Перший вхід не працює**
+
+- Перевірте `INITIAL_PASSWORD` в `.env`
+- Якщо не встановлено, резервний пароль – `123456`
+
+**Немає журналів запитів**
+
+- Установіть `ENABLE_REQUEST_LOGS=true` в `.env`
+
+**Тест з’єднання показує «Недійсне» для OpenAI-сумісних постачальників**
+
+- Багато постачальників не розкривають кінцеву точку `/models`
+- OmniRoute v1.0.6+ включає резервну перевірку через завершення чату
+- Переконайтеся, що базова URL-адреса містить суфікс `/v1`
+
+
+
+---
+
+## 🛠️ Tech Stack
+
+- **Серед виконання**: Node.js 18–22 LTS (⚠️ Node.js 24+ **не підтримується** — рідні двійкові файли `better-sqlite3` несумісні)
+- **Мова**: TypeScript 5.9 — **100% TypeScript** для `src/` та `open-sse/` (версія 1.0.6)
+- **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
+- **База даних**: LowDB (JSON) + SQLite (стан домену + журнали проксі)
+- **Потокове передавання**: події, надіслані сервером (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + ключі API
+- **Тестування**: програма для тестування Node.js (368+ модульних тестів)
+- **CI/CD**: дії GitHub (автоматична публікація npm + Docker Hub після випуску)
+- **Веб-сайт**: [omniroute.online](https://omniroute.online)
+- **Пакет**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Стійкість**: автоматичний вимикач, експоненціальна віддача, захист від громового стада, підробка TLS
+
+---
+
+## 📖 Документація
+
+| Документ | Опис |
+| -------------------------------------------- | ----------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | Постачальники, комбо, інтеграція CLI, розгортання |
+| [API Reference](docs/API_REFERENCE.md) | Усі кінцеві точки з прикладами |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Загальні проблеми та рішення |
+| [Architecture](docs/ARCHITECTURE.md) | Архітектура системи та внутрішні |
+| [Contributing](CONTRIBUTING.md) | Розробка установки та рекомендацій |
+| [OpenAPI Spec](docs/openapi.yaml) | Специфікація OpenAPI 3.0 |
+| [Security Policy](SECURITY.md) | Повідомлення про вразливості та методи безпеки |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Повний посібник: налаштування VM + nginx + Cloudflare |
+| [Features Gallery](docs/FEATURES.md) | Огляд інформаційної панелі зі знімками екрана |
+
+### 📸 Попередній перегляд інформаційної панелі
+
+
+Натисніть, щоб переглянути знімки панелі інструментів
+
+| Сторінка | Скріншот |
+| ------------------------ | ------------------------------------------------- |
+| **Постачальники** |  |
+| **Комбінації** |  |
+| **Аналітика** |  |
+| **Здоров'я** |  |
+| **Перекладач** |  |
+| **Налаштування** |  |
+| **Інструменти CLI** |  |
+| **Журнали використання** |  |
+| **Кінцева точка** |  |
+
+
+
+---
+
+## 🗺️ Дорожня карта
+
+OmniRoute має **заплановано понад 210 функцій** на кількох етапах розробки. Ось ключові області:
+
+| Категорія | Заплановані особливості | Основні моменти |
+| -------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| 🧠 **Маршрутизація та інтелект** | 25+ | Маршрутизація з найменшою затримкою, маршрутизація на основі тегів, попередній перегляд квот, вибір облікового запису P2C |
+| 🔒 **Безпека та відповідність** | 20+ | Захист SSRF, маскування облікових даних, обмеження швидкості для кінцевої точки, визначення обсягу ключа керування |
+| 📊 **Спостережливість** | 15+ | Інтеграція OpenTelemetry, моніторинг квот у реальному часі, відстеження витрат на модель |
+| 🔄 **Інтеграція постачальників** | 20+ | Реєстр динамічної моделі, час відновлення провайдера, Codex із кількома обліковими записами, розбір квоти Copilot |
+| ⚡ **Виконання** | 15+ | Подвійний рівень кешу, кеш запитів, кеш відповідей, потокове підтримання активності, пакетний API |
+| 🌐 **Екосистема** | 10+ | API WebSocket, гаряче перезавантаження конфігурації, розподілене сховище конфігурацій, комерційний режим |
+
+### 🔜 Незабаром
+
+- 🔗 **Інтеграція OpenCode** — власна підтримка постачальника для IDE кодування OpenCode AI
+- 🔗 **Інтеграція TRAE** — повна підтримка інфраструктури розробки TRAE AI
+- 📦 **Batch API** — асинхронна пакетна обробка масових запитів
+- 🎯 **Маршрутизація на основі тегів** — Маршрутизація запитів на основі спеціальних тегів і метаданих
+- 💰 **Стратегія найнижчої вартості** — автоматично вибирайте найдешевшого доступного постачальника
+
+> 📝 Повні специфікації функцій доступні в [**OMNI_TOKEN_147**](docs/new-features/) (217 детальних специфікацій)
+
+---
+
+## 📧 Підтримка
+
+> 💬 **Приєднуйтесь до нашої спільноти!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — отримуйте допомогу, діліться порадами та будьте в курсі подій.
+
+- **Веб-сайт**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Проблеми**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Оригінальний проект**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Автори
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Як зробити внесок
+
+1. Розгалужте репозиторій
+2. Створіть свою гілку функцій (`git checkout -b feature/amazing-feature`)
+3. Зафіксуйте свої зміни (`git commit -m 'Add amazing feature'`)
+4. Push до відділення (`git push origin feature/amazing-feature`)
+5. Відкрийте Pull Request
+
+Див. [CONTRIBUTING.md](CONTRIBUTING.md), щоб отримати докладні вказівки.
+
+### Випуск нової версії
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Зоряна історія
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Подяка
+
+Особлива подяка **[9router](https://github.com/decolua/9router)** від **[decolua](https://github.com/decolua)** — оригінального проекту, який надихнув цей форк. OmniRoute спирається на цю неймовірну основу завдяки додатковим функціям, мультимодальним API і повному перепису TypeScript.
+
+Особлива подяка **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — оригінальній реалізації Go, яка надихнула цей порт JavaScript.
+
+---
+
+## 📄 Ліцензія
+
+Ліцензія Массачусетського технологічного інституту – подробиці див. [LICENSE](LICENSE).
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gateway de IA Gratuito
+
+
+
+### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com reserve automático.
+
+_Універсальний проксі-сервер API — кінцева точка, 36+ постачальників, нуль простоїв._
+
+### 🌐 Internacionalização (i18n)
+
+Інформаційна панель OmniRoute підтримує **багато ідіом**. Актуально доступні:
+
+| Ідіома | Código | Статус |
+| ----------------------- | ------- | -------- |
+| 🇺🇸 англійська | `en` | ✅ Повне |
+| 🇧🇷 Português (Бразилія) | `pt-BR` | ✅ Повне |
+
+**Параметр троакар або ідіома:** Натисніть без вибору ідіоми (🇺🇸 EN) без заголовка на інформаційній панелі → вибір ідіоми.
+
+**Para adicionar um nova idioma:**
+
+1. Викличте `src/i18n/messages/{codigo}.json` на основі `en.json`
+2. Додайте код `src/i18n/config.ts` → `LOCALES` і `LANGUAGES`
+3. Reinicie або сервер
+
+### ⚡ Início Rápido
+
+```bash
+# Instalar via npm
+npx omniroute@latest
+
+# Ou rodar do código-fonte
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+### 🐳 Докер
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Funcionalidades Principais
+
+- **36+ провідників IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek та ін.
+- **Roteamento inteligente** — Запасні автоматичні постачальники
+- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
+- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
+- **Cache semântico** — Зменшити налаштування та затримку
+- **OAuth automático** — автоматичне оновлення токенів
+- **Combos personalizados** — 6 estratégias de roteamento
+- **Помна панель приладів** — Моніторинг, журнали, аналізи, конфігурації
+- **Інструменти CLI** — налаштуйте Claude Code, Codex, Cursor, Cline за допомогою кліка
+- **100% TypeScript** — Código limpo e tipado
+
+### 📖 Documentação
+
+| Documento | Опис |
+| ----------------------------------------------- | ------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Провідори, комбо, CLI, розгортання |
+| [Referência da API](docs/API_REFERENCE.md) | Усі кінцеві точки з прикладами |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções |
+| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura e internos do sistema |
+| [Contribuição](CONTRIBUTING.md) | Setup de desenvolvimento e guidelines |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Повна версія: VM + nginx + Cloudflare |
+
+### 📧 Підтримуйте
+
+> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Тир dúvidas, compartilhe dicas e fique atualizado.
+
+- **Веб-сайт**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Проблеми**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Створено з ❤️ для розробників, які працюють у режимі 24/7
+
+ omniroute.online
+
diff --git a/README.vi.md b/README.vi.md
new file mode 100644
index 0000000000..aaa3c41de5
--- /dev/null
+++ b/README.vi.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — Cổng AI miễn phí
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Không bao giờ ngừng viết mã. Định tuyến thông minh tới **Mô hình AI MIỄN PHÍ và chi phí thấp** với tính năng dự phòng tự động.
+
+_Proxy API phổ quát của bạn — một điểm cuối, hơn 36 nhà cung cấp, không có thời gian ngừng hoạt động._
+
+**Hoàn thành cuộc trò chuyện • Nhúng • Tạo hình ảnh • Âm thanh • Sắp xếp lại • 100% TypeScript**
+
+---
+
+### 🤖 Nhà cung cấp AI miễn phí cho các tác nhân mã hóa yêu thích của bạn
+
+_Kết nối mọi công cụ IDE hoặc CLI được hỗ trợ bởi AI thông qua OmniRoute — cổng API miễn phí để mã hóa không giới hạn._
+
+
+
+---
+
+## 🤔 Tại sao lại là OmniRoute?
+
+**Ngưng lãng phí tiền và đạt đến giới hạn:**
+
+- Hạn mức đăng ký hết hạn không được sử dụng hàng tháng
+- Giới hạn tốc độ khiến bạn không thể viết mã giữa chừng
+- API đắt tiền ($20-50/tháng cho mỗi nhà cung cấp)
+- Chuyển đổi thủ công giữa các nhà cung cấp
+
+**OmniRoute giải quyết vấn đề này:**
+
+- ✅ **Tối đa hóa số lượt đăng ký** - Theo dõi hạn ngạch, sử dụng từng bit trước khi đặt lại
+- ✅ **Tự động dự phòng** - Đăng ký → Khóa API → Giá rẻ → Miễn phí, không có thời gian ngừng hoạt động
+- ✅ **Nhiều tài khoản** - Luân chuyển giữa các tài khoản cho mỗi nhà cung cấp
+- ✅ **Universal** - Hoạt động với Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, mọi công cụ CLI
+
+---
+
+## 🔄 Nó hoạt động như thế nào
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Bắt đầu nhanh
+
+**1. Cài đặt trên toàn cầu:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Trang tổng quan mở lúc `http://localhost:20128`
+
+| Lệnh | Mô tả |
+| ----------------------- | --------------------------------------- |
+| `omniroute` | Máy chủ khởi động (cổng mặc định 20128) |
+| `omniroute --port 3000` | Sử dụng cổng tùy chỉnh |
+| `omniroute --no-open` | Không tự động mở trình duyệt |
+| `omniroute --help` | Hiển thị trợ giúp |
+
+**2. Kết nối nhà cung cấp MIỄN PHÍ:**
+
+Bảng điều khiển → Nhà cung cấp → Kết nối **Mã Claude** hoặc **AntiGravity** → Đăng nhập OAuth → Xong!
+
+**3. Sử dụng trong công cụ CLI của bạn:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**Chỉ vậy thôi!** Bắt đầu viết mã với các mô hình AI MIỄN PHÍ.
+
+**Thay thế - chạy từ nguồn:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute có sẵn dưới dạng hình ảnh Docker công khai trên [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Chạy nhanh:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Với tệp môi trường:**
+
+```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
+```
+
+**Sử dụng Docker Compose:**
+
+```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
+```
+
+| Hình ảnh | Gắn thẻ | Kích thước | Mô tả |
+| ------------------------ | -------- | ---------- | ------------------------------ |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Bản phát hành ổn định mới nhất |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Phiên bản hiện tại |
+
+---
+
+## 💰 Sơ lược về giá
+
+| Bậc | Nhà cung cấp | Chi phí | Đặt lại hạn ngạch | Tốt nhất cho |
+| --------------- | ------------------- | ---------------------------- | --------------------- | ----------------------- |
+| **💳 ĐĂNG KÝ** | Mã Claude (Pro) | $20/tháng | 5h + hàng tuần | Đã đăng ký |
+| | Codex (Plus/Pro) | $20-200/tháng | 5h + hàng tuần | Người dùng OpenAI |
+| | Song Tử CLI | **MIỄN PHÍ** | 180K/tháng + 1K/ngày | Mọi người! |
+| | Phi công phụ GitHub | $10-19/tháng | Hàng tháng | Người dùng GitHub |
+| **🔑 KHÓA API** | NVIDIA NIM | **MIỄN PHÍ** (1000 tín dụng) | Một lần | Kiểm tra bậc miễn phí |
+| | DeepSeek | Trả tiền cho mỗi lần sử dụng | Không có | Giá/chất lượng tốt nhất |
+| | Groq | Cấp miễn phí + trả phí | Tỷ lệ giới hạn | Suy luận cực nhanh |
+| | xAI (Grok) | Trả tiền cho mỗi lần sử dụng | Không có | Mô hình Grok |
+| | Mistral | Cấp miễn phí + trả phí | Tỷ lệ giới hạn | AI Châu Âu |
+| | OpenRouter | Trả tiền cho mỗi lần sử dụng | Không có | Hơn 100 mẫu |
+| **💰 RẺ** | GLM-4.7 | 0,6 USD/1 triệu USD | 10 giờ sáng hàng ngày | Dự phòng ngân sách |
+| | MiniMax M2.1 | 0,2 USD/1 triệu USD | lăn 5 giờ | Lựa chọn rẻ nhất |
+| | Kimi K2 | $9/tháng căn hộ | 10 triệu token/tháng | Chi phí dự đoán |
+| **🆓 MIỄN PHÍ** | iFlow | $0 | Không giới hạn | 8 mẫu miễn phí |
+| | Qwen | $0 | Không giới hạn | 3 mẫu miễn phí |
+| | Kiro | $0 | Không giới hạn | Claude miễn phí |
+
+**💡 Mẹo chuyên nghiệp:** Bắt đầu với Gemini CLI (180K miễn phí/tháng) + combo iFlow (miễn phí không giới hạn) = chi phí $0!
+
+---
+
+## 🎯 Trường hợp sử dụng
+
+### Trường hợp 1: "Tôi có đăng ký Claude Pro"
+
+**Vấn đề:** Hạn ngạch hết hạn không được sử dụng, giới hạn tốc độ trong quá trình mã hóa nặng
+
+```
+Combo: "maximize-claude"
+ 1. cc/claude-opus-4-6 (use subscription fully)
+ 2. glm/glm-4.7 (cheap backup when quota out)
+ 3. if/kimi-k2-thinking (free emergency fallback)
+
+Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
+vs. $20 + hitting limits = frustration
+```
+
+### Trường hợp 2: "Tôi muốn chi phí bằng 0"
+
+**Vấn đề:** Không đủ khả năng đăng ký, cần mã hóa AI đáng tin cậy
+
+```
+Combo: "free-forever"
+ 1. gc/gemini-3-flash (180K free/month)
+ 2. if/kimi-k2-thinking (unlimited free)
+ 3. qw/qwen3-coder-plus (unlimited free)
+
+Monthly cost: $0
+Quality: Production-ready models
+```
+
+### Trường hợp 3: "Tôi cần code 24/7, không bị gián đoạn"
+
+**Vấn đề:** Thời hạn, không đủ khả năng cho thời gian ngừng hoạt động
+
+```
+Combo: "always-on"
+ 1. cc/claude-opus-4-6 (best quality)
+ 2. cx/gpt-5.2-codex (second subscription)
+ 3. glm/glm-4.7 (cheap, resets daily)
+ 4. minimax/MiniMax-M2.1 (cheapest, 5h reset)
+ 5. if/kimi-k2-thinking (free unlimited)
+
+Result: 5 layers of fallback = zero downtime
+```
+
+### Trường hợp 4: "Tôi muốn AI MIỄN PHÍ trong OpenClaw"
+
+**Vấn đề:** Cần trợ lý AI trong ứng dụng nhắn tin, hoàn toàn miễn phí
+
+```
+Combo: "openclaw-free"
+ 1. if/glm-4.7 (unlimited free)
+ 2. if/minimax-m2.1 (unlimited free)
+ 3. if/kimi-k2-thinking (unlimited free)
+
+Monthly cost: $0
+Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Tính năng chính
+
+### 🧠 Định tuyến lõi & thông minh
+
+| Tính năng | Nó làm gì |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| 🎯 **Dự phòng 4 tầng thông minh** | Tự động định tuyến: Đăng ký → Khóa API → Giá rẻ → Miễn phí |
+| 📊 **Theo dõi hạn ngạch theo thời gian thực** | Số lượng mã thông báo trực tiếp + đếm ngược đặt lại cho mỗi nhà cung cấp |
+| 🔄 **Dịch định dạng** | OpenAI ↔ Claude ↔ Gemini ↔ Con trỏ ↔ Kiro liền mạch + vệ sinh phản hồi |
+| 👥 **Hỗ trợ nhiều tài khoản** | Nhiều tài khoản cho mỗi nhà cung cấp với lựa chọn thông minh |
+| 🔄 **Tự động làm mới mã thông báo** | Mã thông báo OAuth tự động làm mới bằng thử lại |
+| 🎨 **Combo tùy chỉnh** | 6 chiến lược: điền trước, quay vòng, p2c, ngẫu nhiên, ít sử dụng nhất, tối ưu hóa chi phí |
+| 🧩 **Mẫu tùy chỉnh** | Thêm bất kỳ ID mẫu nào vào bất kỳ nhà cung cấp nào |
+| 🌐 **Bộ định tuyến ký tự đại diện** | Định tuyến động các mẫu `provider/*` tới bất kỳ nhà cung cấp nào |
+| 🧠 **Ngân sách suy nghĩ** | Các chế độ truyền qua, tự động, tùy chỉnh và thích ứng cho các mô hình lý luận |
+| 💬 **Tiêm nhắc nhở hệ thống** | Lời nhắc hệ thống toàn cầu được áp dụng cho tất cả các yêu cầu |
+| 📄 **API phản hồi** | Hỗ trợ đầy đủ API phản hồi OpenAI (`/v1/responses`) cho Codex |
+
+### 🎵 API đa phương thức
+
+| Tính năng | Nó làm gì |
+| ------------------------------------- | ------------------------------------------------------------ |
+| 🖼️ **Tạo hình ảnh** | `/v1/images/generations` — 4 nhà cung cấp, hơn 9 mô hình |
+| 📐 **Nhúng** | `/v1/embeddings` — 6 nhà cung cấp, hơn 9 mô hình |
+| 🎤 **Phiên âm âm thanh** | `/v1/audio/transcriptions` — Tương thích với lời thì thầm |
+| 🔊 **Chuyển văn bản thành giọng nói** | `/v1/audio/speech` — Tổng hợp âm thanh từ nhiều nhà cung cấp |
+| 🛡️ **Kiểm duyệt** | `/v1/moderations` — Kiểm tra an toàn nội dung |
+| 🔀 **Sắp xếp lại** | `/v1/rerank` — Sắp xếp lại mức độ liên quan của tài liệu |
+
+### 🛡️ Khả năng phục hồi và bảo mật
+
+| Tính năng | Nó làm gì |
+| -------------------------------------- | -------------------------------------------------------------------------------------- |
+| 🔌 **Ngắt mạch** | Tự động mở/đóng theo từng nhà cung cấp với các ngưỡng có thể định cấu hình |
+| 🛡️ **Bầy chống sấm sét** | Mutex + giới hạn tốc độ semaphore cho nhà cung cấp khóa API |
+| 🧠 **Bộ đệm ngữ nghĩa** | Bộ đệm hai lớp (chữ ký + ngữ nghĩa) giảm chi phí và độ trễ |
+| ⚡ **Yêu cầu quyền bình đẳng** | Khoảng thời gian loại trừ 5 giây đối với các yêu cầu trùng lặp |
+| 🔒 **Giả mạo vân tay TLS** | Bỏ qua việc phát hiện bot dựa trên TLS thông qua wreq-js |
+| 🌐 **Lọc IP** | Danh sách cho phép/danh sách chặn để kiểm soát truy cập API |
+| 📊 **Giới hạn tỷ lệ có thể chỉnh sửa** | RPM có thể định cấu hình, khoảng cách tối thiểu và đồng thời tối đa ở cấp hệ thống |
+| 🛡 **Bảo vệ điểm cuối API** | Kiểm soát xác thực + chặn nhà cung cấp cho điểm cuối `/models` |
+| 🔒 **Khả năng hiển thị proxy** | Huy hiệu được mã hóa màu: 🟢 toàn cầu, 🟡 nhà cung cấp, 🔵 mỗi kết nối với màn hình IP |
+| 🌐 **Cấu hình proxy 3 cấp** | Định cấu hình proxy ở cấp độ toàn cầu, theo nhà cung cấp hoặc theo từng kết nối |
+
+### 📊 Khả năng quan sát & phân tích
+
+| Tính năng | Nó làm gì |
+| ---------------------------------------- | --------------------------------------------------------------------------------------------- |
+| 📝 **Yêu cầu ghi nhật ký** | Chế độ gỡ lỗi với nhật ký yêu cầu/phản hồi đầy đủ |
+| 💾 **Nhật ký proxy SQLite** | Nhật ký proxy liên tục vẫn tồn tại khi khởi động lại máy chủ |
+| 📊 **Bảng thông tin phân tích** | Recharts-Powered: thẻ thống kê, biểu đồ sử dụng mô hình, bảng nhà cung cấp |
+| 📈 **Theo dõi tiến độ** | Chọn tham gia các sự kiện tiến trình SSE để phát trực tuyến |
+| 🧪 **Đánh giá LLM** | Thử nghiệm set vàng với 4 chiến thuật trận đấu |
+| 🔍 **Yêu cầu đo từ xa** | tổng hợp độ trễ p50/p95/p99 + theo dõi X-Request-Id |
+| 📋 **Bảng điều khiển nhật ký** | Trang 4 tab hợp nhất: Nhật ký yêu cầu, Nhật ký proxy, Nhật ký kiểm tra, Bảng điều khiển |
+| 🖥️ **Trình xem nhật ký bảng điều khiển** | Trình xem kiểu thiết bị đầu cuối thời gian thực với bộ lọc cấp độ, tìm kiếm, tự động cuộn |
+| 📑 **Ghi nhật ký dựa trên tệp** | Trình chặn chặn của bảng điều khiển ghi lại tất cả đầu ra vào tệp nhật ký JSON bằng cách xoay |
+| 🏥 **Bảng thông tin sức khỏe** | Thời gian hoạt động của hệ thống, trạng thái ngắt mạch, khóa, số liệu thống kê bộ đệm |
+| 💰 **Theo dõi chi phí** | Quản lý ngân sách + cấu hình giá theo từng mô hình |
+
+### ☁️ Triển khai & đồng bộ
+
+| Tính năng | Nó làm gì |
+| ---------------------------------- | --------------------------------------------------------------------------------------- |
+| 💾 **Đồng bộ đám mây** | Đồng bộ hóa cấu hình trên các thiết bị thông qua Cloudflare Workers |
+| 🌐 **Triển khai mọi nơi** | Localhost, VPS, Docker, Công nhân Cloudflare |
+| 🔑 **Quản lý khóa API** | Tạo, xoay vòng và phạm vi khóa API cho mỗi nhà cung cấp |
+| 🧙 **Trình hướng dẫn giới thiệu** | Thiết lập có hướng dẫn 4 bước cho người dùng lần đầu |
+| 🔧 **Bảng điều khiển công cụ CLI** | Định cấu hình bằng một cú nhấp chuột Claude, Codex, Cline, OpenClaw, Kilo, AntiGravity |
+| 🔄 **Sao lưu DB** | Tự động sao lưu, khôi phục, xuất và nhập cho tất cả cài đặt |
+| 🌐 **Quốc tế hóa** | I18n đầy đủ với hỗ trợ next-intl — Tiếng Anh + Tiếng Bồ Đào Nha (Brazil) |
+| 🌍 **Bộ chọn ngôn ngữ** | Biểu tượng quả địa cầu trong tiêu đề để chuyển đổi ngôn ngữ theo thời gian thực (🇺🇸/🇧🇷) |
+| 📂 **Thư mục dữ liệu tùy chỉnh** | `DATA_DIR` env var để ghi đè đường dẫn lưu trữ `~/.omniroute` mặc định |
+
+
+📖 Chi tiết tính năng
+
+### 🎯 Dự phòng 4 tầng thông minh
+
+Tạo combo với dự phòng tự động:
+
+```
+Combo: "my-coding-stack"
+ 1. cc/claude-opus-4-6 (your subscription)
+ 2. nvidia/llama-3.3-70b (free NVIDIA API)
+ 3. glm/glm-4.7 (cheap backup, $0.6/1M)
+ 4. if/kimi-k2-thinking (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Theo dõi hạn ngạch theo thời gian thực
+
+- Tiêu thụ mã thông báo trên mỗi nhà cung cấp
+- Đặt lại đếm ngược (5 giờ, hàng ngày, hàng tuần)
+- Ước tính chi phí cho các bậc trả phí
+- Báo cáo chi tiêu hàng tháng
+
+### 🔄 Dịch định dạng
+
+Dịch liền mạch giữa các định dạng:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **Phản hồi của OpenAI**
+- Công cụ CLI của bạn gửi định dạng OpenAI → OmniRoute dịch → Nhà cung cấp nhận định dạng gốc
+- Hoạt động với mọi công cụ hỗ trợ điểm cuối OpenAI tùy chỉnh
+- **Sạch hóa phản hồi** — Loại bỏ các trường không chuẩn để tương thích nghiêm ngặt với OpenAI SDK
+- **Chuẩn hóa vai trò** — `developer` → `system` đối với non-OpenAI; `system` → `user` dành cho kiểu máy GLM/ERNIE
+- **Trích xuất thẻ suy nghĩ** — `` khối → `reasoning_content` cho các mô hình tư duy
+- **Đầu ra có cấu trúc** — `json_schema` → `responseMimeType`/`responseSchema` của Gemini
+
+### 👥 Hỗ trợ nhiều tài khoản
+
+- Thêm nhiều tài khoản cho mỗi nhà cung cấp
+- Tự động định tuyến vòng tròn hoặc dựa trên mức độ ưu tiên
+- Dự phòng tài khoản tiếp theo khi đạt hạn ngạch
+
+### 🔄 Tự động làm mới mã thông báo
+
+- Mã thông báo OAuth tự động làm mới trước khi hết hạn
+- Không cần xác thực lại thủ công
+- Trải nghiệm liền mạch trên tất cả các nhà cung cấp
+
+### 🎨 Combo tùy chỉnh
+
+- Tạo kết hợp mô hình không giới hạn
+- 6 chiến lược: điền trước, quay vòng, sức mạnh của hai lựa chọn, ngẫu nhiên, ít sử dụng nhất, tối ưu hóa chi phí
+- Chia sẻ combo trên các thiết bị với Cloud Sync
+
+### 🏥 Bảng thông tin sức khỏe
+
+- Trạng thái hệ thống (thời gian hoạt động, phiên bản, mức sử dụng bộ nhớ)
+- Trạng thái ngắt mạch của mỗi nhà cung cấp (Đóng/Mở/Nửa mở)
+- Trạng thái giới hạn tỷ lệ và khóa hoạt động
+- Thống kê bộ đệm chữ ký
+- Đo từ xa độ trễ (p50/p95/p99) + bộ đệm nhắc nhở
+- Đặt lại tình trạng sức khỏe chỉ bằng một cú nhấp chuột
+
+### 🔧 Sân chơi dịch thuật
+
+OmniRoute bao gồm Sân chơi dịch thuật tích hợp mạnh mẽ với **4 chế độ** để gỡ lỗi, kiểm tra và giám sát các bản dịch API:
+
+| Chế độ | Mô tả |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻Sân chơi** | Dịch định dạng trực tiếp - dán bất kỳ nội dung yêu cầu API nào và xem ngay cách OmniRoute dịch nó giữa các định dạng nhà cung cấp (OpenAI ↔ Claude ↔ Gemini ↔ API phản hồi). Bao gồm các mẫu ví dụ và tự động phát hiện định dạng. |
+| **💬 Trình kiểm tra trò chuyện** | Gửi các yêu cầu trò chuyện thực tế thông qua OmniRoute và xem toàn bộ hành trình: thông tin đầu vào của bạn, yêu cầu được dịch, phản hồi của nhà cung cấp và phản hồi được dịch lại. Vô giá để xác nhận định tuyến kết hợp. |
+| **🧪 Ghế thử nghiệm** | Chế độ thử nghiệm hàng loạt - xác định nhiều trường hợp thử nghiệm với đầu vào và đầu ra dự kiến khác nhau, chạy tất cả chúng cùng một lúc và so sánh kết quả giữa các nhà cung cấp và mô hình. |
+| **📱 Giám sát trực tiếp** | Giám sát yêu cầu theo thời gian thực — xem các yêu cầu đến khi chúng truyền qua OmniRoute, xem các bản dịch định dạng đang diễn ra trực tiếp và xác định các vấn đề ngay lập tức. |
+
+**Truy cập:** Bảng điều khiển → Trình dịch (thanh bên)
+
+### 💾 Đồng bộ đám mây
+
+- Đồng bộ hóa nhà cung cấp, combo và cài đặt trên các thiết bị
+- Đồng bộ nền tự động
+- Lưu trữ được mã hóa an toàn
+
+
+
+---
+
+## 📖 Hướng dẫn thiết lập
+
+
+💳 Nhà cung cấp đăng ký
+
+### Mã Claude (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
+```
+
+**Mẹo chuyên nghiệp:** Sử dụng Opus cho các tác vụ phức tạp, Sonnet cho tốc độ. OmniRoute theo dõi hạn ngạch cho mỗi mô hình!
+
+### 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
+```
+
+### Gemini CLI (MIỄN PHÍ 180K/tháng!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Giá trị tốt nhất:** Cấp miễn phí rất lớn! Sử dụng điều này trước các bậc trả phí.
+
+### Phi công phụ GitHub
+
+```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
+```
+
+
+
+
+🔑 Nhà cung cấp khóa API
+
+### NVIDIA NIM (1000 tín dụng MIỄN PHÍ!)
+
+1. Đăng ký: [build.nvidia.com](https://build.nvidia.com)
+2. Nhận khóa API miễn phí (bao gồm 1000 tín dụng suy luận)
+3. Bảng điều khiển → Thêm nhà cung cấp → NVIDIA NIM:
+ - Khóa API: `nvapi-your-key`
+
+**Mẫu máy:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` và hơn 50 mẫu khác
+
+**Mẹo chuyên nghiệp:** API tương thích với OpenAI — hoạt động trơn tru với tính năng dịch định dạng của OmniRoute!
+
+### Tìm kiếm sâu
+
+1. Đăng ký: [platform.deepseek.com](https://platform.deepseek.com)
+2. Nhận khóa API
+3. Trang tổng quan → Thêm nhà cung cấp → DeepSeek
+
+**Mẫu xe:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Có sẵn bậc miễn phí!)
+
+1. Đăng ký: [console.groq.com](https://console.groq.com)
+2. Nhận khóa API (bao gồm bậc miễn phí)
+3. Bảng điều khiển → Thêm nhà cung cấp → Groq
+
+**Mẫu xe:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Mẹo chuyên nghiệp:** Suy luận cực nhanh — tốt nhất cho mã hóa thời gian thực!
+
+### OpenRouter (Hơn 100 mẫu)
+
+1. Sign up: [openrouter.ai](https://openrouter.ai)
+2. Nhận khóa API
+3. Bảng điều khiển → Thêm nhà cung cấp → OpenRouter
+
+**Mô hình:** Truy cập hơn 100 mô hình từ tất cả các nhà cung cấp chính thông qua một khóa API duy nhất.
+
+
+
+
+💰 Nhà cung cấp giá rẻ (Dự phòng)
+
+### GLM-4.7 (Đặt lại hàng ngày, 0,6 USD/1 triệu)
+
+1. Đăng ký: [Zhipu AI](https://open.bigmodel.cn/)
+2. Nhận khóa API từ Gói mã hóa
+3. Bảng điều khiển → Thêm khóa API:
+ - Nhà cung cấp: `glm`
+ - Khóa API: `your-key`
+
+**Sử dụng:** `glm/glm-4.7`
+
+**Mẹo chuyên nghiệp:** Gói mã hóa cung cấp hạn ngạch 3× với chi phí 1/7! Đặt lại vào 10:00 sáng hàng ngày.
+
+### MiniMax M2.1 (đặt lại 5 giờ, 0,20 USD/1M)
+
+1. Đăng ký: [MiniMax](https://www.minimax.io/)
+2. Nhận khóa API
+3. Bảng điều khiển → Thêm khóa API
+
+**Sử dụng:** `minimax/MiniMax-M2.1`
+
+**Mẹo chuyên nghiệp:** Tùy chọn rẻ nhất cho ngữ cảnh dài (1 triệu mã thông báo)!
+
+### Kimi K2 ($9/tháng cố định)
+
+1. Đăng ký: [Moonshot AI](https://platform.moonshot.ai/)
+2. Nhận khóa API
+3. Bảng điều khiển → Thêm khóa API
+
+**Sử dụng:** `kimi/kimi-latest`
+
+**Mẹo chuyên nghiệp:** Đã sửa lỗi 9 USD/tháng cho 10 triệu mã thông báo = 0,90 USD/1 triệu chi phí hiệu quả!
+
+
+
+
+🆓 Nhà cung cấp MIỄN PHÍ (Dự phòng khẩn cấp)
+
+### iFlow (8 mẫu MIỄN PHÍ)
+
+```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 (3 mẫu MIỄN PHÍ)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude MIỄN PHÍ)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Tạo Combo
+
+### Ví dụ 1: Tối đa hóa đăng ký → Sao lưu giá rẻ
+
+```
+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
+```
+
+### Example 2: Free-Only (Zero Cost)
+
+```
+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!
+```
+
+
+
+
+🔧 Tích hợp CLI
+
+### IDE con trỏ
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Mã Claude
+
+Sử dụng trang **Công cụ CLI** trong trang tổng quan để định cấu hình bằng một cú nhấp chuột hoặc chỉnh sửa `~/.claude/settings.json` theo cách thủ công.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Tùy chọn 1 — Trang tổng quan (được khuyến nghị):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Tùy chọn 2 — Thủ công:** Chỉnh sửa `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Lưu ý:** OpenClaw chỉ hoạt động với OmniRoute cục bộ. Sử dụng `127.0.0.1` thay vì `localhost` để tránh các vấn đề về độ phân giải IPv6.
+
+### Cline / Tiếp tục / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Mẫu có sẵn
+
+
+Xem tất cả các mẫu có sẵn
+
+**Mã Claude (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - MIỄN PHÍ:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**Phi công phụ GitHub (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Tín dụng MIỄN PHÍ:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- Hơn 50 mẫu khác trên [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - 0,6 USD/1 triệu:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - 0,2 USD/1 triệu:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - MIỄN PHÍ:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - MIỄN PHÍ:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - MIỄN PHÍ:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - Hơn 100 mẫu:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Bất kỳ mẫu nào từ [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Đánh giá (Evals)
+
+OmniRoute bao gồm khung đánh giá tích hợp để kiểm tra chất lượng phản hồi LLM dựa trên bộ vàng. Truy cập thông qua **Analytics → Đánh giá** trong bảng điều khiển.
+
+### Bộ vàng tích hợp
+
+"Bộ vàng OmniRoute" được tải sẵn chứa 10 trường hợp thử nghiệm bao gồm:
+
+- Lời chào, toán, địa lý, tạo mã
+- Tuân thủ định dạng JSON, dịch thuật, đánh dấu
+- Từ chối an toàn (nội dung có hại), đếm, logic boolean
+
+### Chiến lược đánh giá
+
+| Chiến lược | Mô tả | Ví dụ |
+| ---------- | --------------------------------------------------------------- | -------------------------------- |
+| `exact` | Đầu ra phải khớp chính xác | `"4"` |
+| `contains` | Đầu ra phải chứa chuỗi con (không phân biệt chữ hoa chữ thường) | `"Paris"` |
+| `regex` | Đầu ra phải khớp với mẫu biểu thức chính quy | `"1.*2.*3"` |
+| `custom` | Hàm JS tùy chỉnh trả về true/false | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth trên Servidor Remoto (Thiết lập OAuth từ xa)
+
+
+
+> **⚠️ QUAN TRỌNG đối với người sử dụng OmniRoute trên VPS/Docker/servidor remoto**
+
+### Bởi vì OAuth làm cho AntiGravity / Gemini CLI có bị ảnh hưởng bởi các dịch vụ điều khiển từ xa không?
+
+Os đã được chứng minh **AntiGravity** e **Gemini CLI** sử dụng **Google OAuth 2.0** để xác thực. O Google exige que a `redirect_uri` usada no fluxo OAuth seja **exatamente** một trong các URI trước khi lập danh sách trên Google Cloud Console để ứng dụng.
+
+Vì các thông tin xác thực OAuth không có OmniRoute estão cadastradas **apenas para `localhost`**. Bạn có thể truy cập OmniRoute bằng cách điều khiển lại máy chủ (ví dụ: `https://omniroute.meuservidor.com`), hoặc Google sẽ cung cấp thông tin xác thực với:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Giải pháp: Định cấu hình thông tin đăng nhập OAuth
+
+Bạn nên chú ý **OAuth 2.0 Client ID** không có Google Cloud Console vì URI làm dịch vụ của bạn.
+
+#### Vượt qua một lần nữa
+
+**1. Truy cập vào Google Cloud Console**
+
+Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. Hãy yêu cầu ID khách hàng OAuth 2.0 mới**
+
+- Nhấn vào **"+ Tạo thông tin xác thực"** → **"ID khách hàng OAuth"**
+- Mẹo ứng dụng: **"Ứng dụng web"**
+- Tên: escolha qualquer nome (ví dụ: `OmniRoute Remote`)
+
+**3. Adicione dưới dạng URI chuyển hướng được ủy quyền**
+
+Không có quảng cáo **"URI chuyển hướng được ủy quyền"**, khuyến cáo:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Thay thế `seu-servidor.com` từ địa chỉ IP hoặc dịch vụ IP của bạn (bao gồm một cổng cần thiết, ví dụ: `http://45.33.32.156:20128/callback`).
+
+**4. Lưu và sao chép dưới dạng uy tín**
+
+Sau đó, Google đã đăng trên **ID khách hàng** và **Bí mật khách hàng**.
+
+**5. Định cấu hình theo các biến thể của môi trường**
+
+Không có `.env` (hoặc có nhiều biến thể môi trường xung quanh 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 hoặc OmniRoute**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. Lều kết nối mới lạ**
+
+Bảng điều khiển → Nhà cung cấp → Anti Gravity (hoặc Gemini CLI) → OAuth
+
+Google đã chuyển hướng điều chỉnh cho `https://seu-servidor.com/callback` và một chức năng xác thực.
+
+---
+
+### Thời gian giải quyết (sem configurar credenciais próprias)
+
+Nếu không có câu hỏi nào về thông tin xác thực trước đây, bạn có thể sử dụng thông tin **hướng dẫn sử dụng URL**:
+
+1. O OmniRoute tìm kiếm URL tự động của Google
+2. Sau khi bạn tự động đăng ký, hoặc chuyển hướng Google sang `localhost` (bạn không thể điều chỉnh lại dịch vụ)
+3. **Sao chép một URL hoàn chỉnh** da cuối cùng của trình duyệt của bạn (mesmo que a página not carregue)
+4. URL này không có khả năng xuất hiện không có phương thức kết nối nào với OmniRoute
+5. Kết nối với nhau **"Kết nối"**
+
+> Chức năng giải pháp này có thể giúp tự động cấp quyền cho URL và có thể chuyển hướng độc lập đến mục tiêu hoặc không.
+
+---
+
+## 🐛 Khắc phục sự cố
+
+
+Nhấp để mở rộng hướng dẫn khắc phục sự cố
+
+**"Mô hình ngôn ngữ không cung cấp tin nhắn"**
+
+- Đã hết hạn ngạch nhà cung cấp → Kiểm tra trình theo dõi hạn ngạch bảng điều khiển
+- Giải pháp: Sử dụng combo dự phòng hoặc chuyển sang tầng rẻ hơn
+
+**Giới hạn tỷ lệ**
+
+- Hết hạn ngạch đăng ký → Dự phòng sang GLM/MiniMax
+- Thêm tổ hợp: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Mã thông báo OAuth đã hết hạn**
+
+- Tự động làm mới bởi OmniRoute
+- Nếu sự cố vẫn tiếp diễn: Bảng điều khiển → Nhà cung cấp → Kết nối lại
+
+**Chi phí cao**
+
+- Kiểm tra số liệu thống kê sử dụng trong Bảng điều khiển → Chi phí
+- Chuyển mô hình chính sang GLM/MiniMax
+- Sử dụng bậc miễn phí (Gemini CLI, iFlow) cho các tác vụ không quan trọng
+
+**Bảng điều khiển mở sai cổng**
+
+- Đặt `PORT=20128` và `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Lỗi đồng bộ hóa đám mây**
+
+- Xác minh `BASE_URL` trỏ tới phiên bản đang chạy của bạn
+- Xác minh `CLOUD_URL` điểm tới điểm cuối đám mây dự kiến của bạn
+- Giữ các giá trị `NEXT_PUBLIC_*` được căn chỉnh với các giá trị phía máy chủ
+
+**Đăng nhập lần đầu không hoạt động**
+
+- Kiểm tra `INITIAL_PASSWORD` trong `.env`
+- Nếu không được đặt, mật khẩu dự phòng là `123456`
+
+**Không có nhật ký yêu cầu**
+
+- Đặt `ENABLE_REQUEST_LOGS=true` trong `.env`
+
+**Kiểm tra kết nối cho thấy "Không hợp lệ" đối với các nhà cung cấp tương thích với OpenAI**
+
+- Nhiều nhà cung cấp không hiển thị điểm cuối `/models`
+- OmniRoute v1.0.6+ bao gồm xác thực dự phòng thông qua hoàn thành trò chuyện
+- Đảm bảo URL cơ sở bao gồm hậu tố `/v1`
+
+
+
+---
+
+## 🛠️ Ngăn xếp công nghệ
+
+- **Thời gian chạy**: Node.js 18–22 LTS (⚠️ Node.js 24+ **không được hỗ trợ** — `better-sqlite3` các tệp nhị phân gốc không tương thích)
+- **Ngôn ngữ**: TypeScript 5.9 — **100% TypeScript** trên `src/` và `open-sse/` (v1.0.6)
+- **Khung**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Cơ sở dữ liệu**: LowDB (JSON) + SQLite (trạng thái miền + nhật ký proxy)
+- **Truyền phát**: Sự kiện do máy chủ gửi (SSE)
+- **Xác thực**: OAuth 2.0 (PKCE) + JWT + Khóa API
+- **Thử nghiệm**: Trình chạy thử nghiệm Node.js (hơn 368 bài kiểm tra đơn vị)
+- **CI/CD**: GitHub Actions (tự động xuất bản npm + Docker Hub khi phát hành)
+- **Trang web**: [omniroute.online](https://omniroute.online)
+- **Gói**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Khả năng phục hồi**: Ngắt mạch, lùi theo cấp số nhân, chống sét bầy đàn, giả mạo TLS
+
+---
+
+## 📖 Tài liệu
+
+| Tài liệu | Mô tả |
+| -------------------------------------------- | --------------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | Nhà cung cấp, combo, tích hợp CLI, triển khai |
+| [API Reference](docs/API_REFERENCE.md) | Tất cả các điểm cuối có ví dụ |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Các vấn đề thường gặp và giải pháp |
+| [Architecture](docs/ARCHITECTURE.md) | Kiến trúc hệ thống và nội bộ |
+| [Contributing](CONTRIBUTING.md) | Thiết lập và hướng dẫn phát triển |
+| [OpenAPI Spec](docs/openapi.yaml) | Đặc tả OpenAPI 3.0 |
+| [Security Policy](SECURITY.md) | Báo cáo lỗ hổng bảo mật và thực hành bảo mật |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Hướng dẫn đầy đủ: Thiết lập VM + nginx + Cloudflare |
+| [Features Gallery](docs/FEATURES.md) | Tham quan bảng điều khiển trực quan với ảnh chụp màn hình |
+
+### 📸 Xem trước bảng điều khiển
+
+
+Nhấp để xem ảnh chụp màn hình trang tổng quan
+
+| Trang | Ảnh chụp màn hình |
+| ------------------- | ------------------------------------------------- |
+| **Nhà cung cấp** |  |
+| **Combo** |  |
+| **Phân tích** |  |
+| **Sức khỏe** |  |
+| **Người dịch** |  |
+| **Cài đặt** |  |
+| **Công cụ CLI** |  |
+| **Nhật ký sử dụng** |  |
+| **Điểm cuối** |  |
+
+
+
+---
+
+## 🗺️ Lộ trình
+
+OmniRoute có **210+ tính năng được lên kế hoạch** qua nhiều giai đoạn phát triển. Dưới đây là các lĩnh vực chính:
+
+| Danh mục | Tính năng dự kiến | Điểm nổi bật |
+| ------------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------- |
+| 🧠 **Định tuyến & thông minh** | 25+ | Định tuyến có độ trễ thấp nhất, định tuyến dựa trên thẻ, ưu tiên hạn ngạch, chọn tài khoản P2C |
+| 🔒 **Bảo mật & Tuân thủ** | 20+ | Tăng cường SSRF, che giấu thông tin xác thực, giới hạn tốc độ cho mỗi điểm cuối, phạm vi khóa quản lý |
+| 📊 **Khả năng quan sát** | 15+ | Tích hợp OpenTelemetry, giám sát hạn ngạch thời gian thực, theo dõi chi phí trên mỗi mô hình |
+| 🔄 **Tích hợp nhà cung cấp** | 20+ | Đăng ký mô hình động, thời gian hồi chiêu của nhà cung cấp, Codex nhiều tài khoản, phân tích hạn ngạch Copilot |
+| ⚡ **Hiệu suất** | 15+ | Lớp bộ đệm kép, bộ đệm nhắc nhở, bộ đệm phản hồi, lưu giữ luồng, API hàng loạt |
+| 🌐 **Hệ sinh thái** | 10+ | API WebSocket, cấu hình tải lại nóng, kho cấu hình phân tán, chế độ thương mại |
+
+### 🔜 Sắp ra mắt
+
+- 🔗 **Tích hợp OpenCode** — Hỗ trợ của nhà cung cấp gốc cho IDE mã hóa OpenCode AI
+- 🔗 **Tích hợp TRAE** — Hỗ trợ đầy đủ cho khung phát triển TRAE AI
+- 📦 **Batch API** — Xử lý hàng loạt không đồng bộ cho các yêu cầu hàng loạt
+- 🎯 **Định tuyến dựa trên thẻ** — Định tuyến các yêu cầu dựa trên thẻ và siêu dữ liệu tùy chỉnh
+- 💰 **Chiến lược chi phí thấp nhất** — Tự động chọn nhà cung cấp có sẵn rẻ nhất
+
+> 📝 Thông số kỹ thuật đầy đủ tính năng có sẵn trong [**OMNI_TOKEN_147**](docs/new-features/) (217 thông số kỹ thuật chi tiết)
+
+---
+
+## 📧 Hỗ trợ
+
+> 💬 **Tham gia cộng đồng của chúng tôi!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Nhận trợ giúp, chia sẻ mẹo và luôn cập nhật.
+
+- **Trang web**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Vấn đề**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Dự án gốc**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Người đóng góp
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Cách đóng góp
+
+1. Phân nhánh kho lưu trữ
+2. Tạo nhánh tính năng của bạn (`git checkout -b feature/amazing-feature`)
+3. Cam kết thay đổi của bạn (`git commit -m 'Add amazing feature'`)
+4. Đẩy vào nhánh (`git push origin feature/amazing-feature`)
+5. Mở yêu cầu kéo
+
+Xem [CONTRIBUTING.md](CONTRIBUTING.md) để biết hướng dẫn chi tiết.
+
+### Phát hành phiên bản mới
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Lịch sử ngôi sao
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Lời cảm ơn
+
+Đặc biệt cảm ơn **[9router](https://github.com/decolua/9router)** của **[decolua](https://github.com/decolua)** — dự án ban đầu đã truyền cảm hứng cho đợt phân nhánh này. OmniRoute được xây dựng dựa trên nền tảng đáng kinh ngạc đó với các tính năng bổ sung, API đa phương thức và viết lại TypeScript đầy đủ.
+
+Đặc biệt cảm ơn **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — cách triển khai Go ban đầu đã truyền cảm hứng cho cổng JavaScript này.
+
+---
+
+## 📄 Giấy phép
+
+Giấy phép MIT - xem [LICENSE](LICENSE) để biết chi tiết.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gateway de IA Gratuito
+
+
+
+### Nunca pare de codar. Roteamento thông minh cho **mô hình IA MIỄN PHÍ và baixo tùy chỉnh** và tự động dự phòng.
+
+_Seu proxy phổ quát de API — ừm điểm cuối, hơn 36 điểm đã được chứng minh, không có thời gian ngừng hoạt động._
+
+### 🌐 Quốc tế hóa (i18n)
+
+O bảng điều khiển hỗ trợ OmniRoute **nhiều thành ngữ**. Cuối cùng, bạn có thể giải quyết:
+
+| Thành ngữ | Código | Trạng thái |
+| --------------------- | ------- | ------------- |
+| 🇺🇸 Tiếng Anh | `en` | ✅ Hoàn thiện |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Hoàn thiện |
+
+**Para trocar o thành ngữ:** Clique no seletor de Idi chỉ (🇺🇸 EN) không có tiêu đề làm bảng điều khiển → chọn lựa hoặc thành ngữ desejado.
+
+**Thêm một thành ngữ mới:**
+
+1. Khóc `src/i18n/messages/{codigo}.json` dựa trên `en.json`
+2. Adicione hoặc código em `src/i18n/config.ts` → `LOCALES` e `LANGUAGES`
+3. Phục hồi hoặc phục vụ
+
+### ⚡ Início Rápido
+
+```bash
+# Instalar via npm
+npx omniroute@latest
+
+# Ou rodar do código-fonte
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+### 🐳 Docker
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Chức năng chính
+
+- **36+ chứng minh của IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, và nhiều hơn nữa
+- **Roteamento inteligente** — Tự động dự phòng trong các phương pháp được chứng minh
+- **Giao dịch định dạng** — OpenAI ↔ Claude ↔ Gemini tự động
+- **Multi-conta** — Nhiều conta được chứng minh bằng cách lựa chọn thông minh
+- **Cache semântico** — Reduz custos và latência
+- **Tự động OAuth** — Tự động đổi mới mã thông báo
+- **Combo cá nhân hóa** — 6 chiến lược roteamento
+- **Hoàn thành bảng điều khiển** — Màn hình, nhật ký, phân tích, cấu hình
+- **Công cụ CLI** — Định cấu hình Mã Claude, Codex, Con trỏ, Cline với một nhóm
+- **100% TypeScript** — Código limbo e tipado
+
+### 📖 Tài liệu
+
+| Tài liệu | Mô tả |
+| ----------------------------------------------- | --------------------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combo, CLI, triển khai |
+| [Referência da API](docs/API_REFERENCE.md) | Tất cả các điểm cuối của hệ điều hành như các ví dụ |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Các vấn đề công cộng và giải pháp |
+| [Arquitetura](docs/ARCHITECTURE.md) | Hệ thống Arquitetura và internos |
+| [Contribuição](CONTRIBUTING.md) | Thiết lập các nguyên tắc phát triển |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Hướng dẫn hoàn chỉnh: VM + nginx + Cloudflare |
+
+### 📧 Hỗ trợ
+
+> 💬 **Entre para a communidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tyre duvidas, compartilhe dicas and fique atualizado.
+
+- **Trang web**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Vấn đề**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Được xây dựng với ❤️ dành cho nhà phát triển viết mã 24/7
+
+ omniroute.online
+
+
+ # 🚀 OmniRoute — darmowa bramka AI
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Nigdy nie przestawaj kodować. Inteligentne przekierowywanie do **BEZPŁATNYCH i tanich modeli AI** z automatycznym powrotem.
+
+_Twój uniwersalny serwer proxy API — jeden punkt końcowy, ponad 36 dostawców, zero przestojów._
+
+**Uzupełnienia czatu • Osadzania • Generowanie obrazu • Dźwięk • Zmiana rankingu • 100% TypeScript**
+
+---
+
+### 🤖 Bezpłatny dostawca AI dla Twoich ulubionych agentów kodujących
+
+_Połącz dowolne narzędzie IDE lub CLI oparte na sztucznej inteligencji poprzez OmniRoute — bezpłatną bramę API dla nieograniczonego kodowania._
+
+ 
Limit subskrypcji wygasa niewykorzystany co miesiąc
+-