OmniRoute/README.id.md

🚀 OmniRoute — Gerbang AI Gratis

🌐 English | Português (BR)

Jangan pernah berhenti membuat kode. Perutean cerdas ke model AI GRATIS & berbiaya rendah dengan fallback otomatis.

Proksi API universal Anda — satu titik akhir, 36+ penyedia, tanpa waktu henti.

Penyelesaian Obrolan • Penyematan • Pembuatan Gambar • Audio • Pemeringkatan Ulang • 100% TypeScript

---

🤖 Penyedia AI gratis untuk agen coding favorit Anda

Hubungkan alat IDE atau CLI apa pun yang didukung AI melalui OmniRoute — gerbang API gratis untuk pengkodean tanpa batas.

OpenClaw ⭐ 205K	NanoBot ⭐ 20.9K	PicoClaw ⭐ 14.6K	ZeroClaw ⭐ 9.9K	IronClaw ⭐ 2.1K
OpenCode ⭐ 106K	Codex CLI ⭐ 60.8K	Claude Code ⭐ 67.3K	Gemini CLI ⭐ 94.7K	Kilo Code ⭐ 15.5K

_{📡 Semua agen terhubung melalui http://localhost:20128/v1 atau http://cloud.omniroute.online/v1 — satu konfigurasi, model tak terbatas, dan kuota}

---

🌐 Website • 🚀 Quick Start • 💡 Features • 📖 Docs • 💰 Pricing • 💬 WhatsApp

🌐 Available in: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino

---

🤔 Mengapa OmniRoute?

Berhenti membuang-buang uang dan mencapai batas:

• Kuota berlangganan habis tanpa terpakai setiap bulannya
• Batas kecepatan menghentikan Anda di tengah coding
• API mahal ($20-50/bulan per penyedia)
• Peralihan antar penyedia secara manual

OmniRoute memecahkan masalah ini:

• ✅ Maksimalkan langganan - Lacak kuota, gunakan setiap bit sebelum menyetel ulang
• ✅ Pengembalian otomatis - Berlangganan → Kunci API → Murah → Gratis, tanpa downtime
• ✅ Multi-akun - Round-robin antar akun per penyedia
• ✅ Universal - Bekerja dengan Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, alat CLI apa pun

---

🔄 Cara Kerjanya

┌─────────────┐
│  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

---

⚡ Mulai Cepat

1. Instal secara global:

npm install -g omniroute
omniroute

🎉 Dasbor terbuka di http://localhost:20128

Perintah	Deskripsi
omniroute	Mulai server (port default 20128)
omniroute --port 3000	Gunakan port khusus
omniroute --no-open	Jangan buka otomatis browser
omniroute --help	Tampilkan bantuan

2. Hubungkan penyedia GRATIS:

Dasbor → Penyedia → Hubungkan Kode Claude atau Antigravitasi → Login OAuth → Selesai!

3. Gunakan di alat CLI Anda:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: if/kimi-k2-thinking

Selesai! Mulai coding dengan model AI GRATIS.

Alternatif — dijalankan dari sumber:

cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

---

🐳 buruh pelabuhan

OmniRoute tersedia sebagai image Docker publik di Docker Hub.

Lari cepat:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Dengan file lingkungan:

# 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

Menggunakan Docker Tulis:

# 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

Gambar	Tandai	Ukuran	Deskripsi
diegosouzapw/omniroute	latest	~250 MB	Rilis stabil terbaru
diegosouzapw/omniroute	1.0.3	~250 MB	Versi saat ini

---

💰 Sekilas tentang Harga

Tingkat	Penyedia	Biaya	Reset Kuota	Terbaik Untuk
💳 BERLANGGANAN	Kode Claude (Pro)	$20/bln	5 jam + mingguan	Sudah berlangganan
	Kodeks (Plus/Pro)	$20-200/bln	5 jam + mingguan	Pengguna OpenAI
	CLI Gemini	GRATIS	180K/bln + 1K/hari	Setiap orang!
	Kopilot GitHub	$10-19/bln	Bulanan	Pengguna GitHub
🔑 KUNCI API	NVIDIA NIM	GRATIS (1000 sks)	Satu kali	Pengujian tingkat gratis
	Pencarian Dalam	Bayar per penggunaan	Tidak ada	Harga/kualitas terbaik
	Bagus	Tingkat gratis + berbayar	Tarif terbatas	Inferensi ultra-cepat
	xAI (Grok)	Bayar per penggunaan	Tidak ada	Model Grok
	Mistral	Tingkat gratis + berbayar	Tarif terbatas	AI Eropa
	BukaRouter	Bayar per penggunaan	Tidak ada	100+ model
💰 MURAH	GLM-4.7	$0,6/1 juta	Setiap hari pukul 10 pagi	Cadangan anggaran
	MiniMax M2.1	$0,2/1 juta	5 jam bergulir	Pilihan termurah
	Kimi K2	$9/bln tetap	10 juta token/bln	Biaya yang dapat diprediksi
🆓 GRATIS	iFlow	$0	Tidak terbatas	8 model gratis
	Qwen	$0	Tidak terbatas	3 model gratis
	Kiro	$0	Tidak terbatas	Claude gratis

💡 Kiat Pro: Mulai dengan Gemini CLI (gratis 180 ribu/bulan) + kombo iFlow (gratis tanpa batas) = ​​biaya $0!

---

🎯 Kasus Penggunaan

Kasus 1: "Saya berlangganan Claude Pro"

Masalah: Kuota habis tanpa terpakai, batas kecepatan selama coding berat

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

Kasus 2: "Saya ingin tanpa biaya"

Masalah: Tidak mampu berlangganan, memerlukan pengkodean AI yang andal

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

Kasus 3: "Saya memerlukan pengkodean 24/7, tanpa gangguan"

Masalah: Tenggat waktu, tidak mampu membayar downtime

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

Kasus 4: "Saya ingin AI GRATIS di OpenClaw"

Masalah: Membutuhkan asisten AI dalam aplikasi perpesanan, sepenuhnya gratis

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...

---

💡 Fitur Utama

🧠 Perutean & Kecerdasan Inti

Fitur	Apa Fungsinya
🎯 Pengembalian 4 Tingkat Cerdas	Rute otomatis: Berlangganan → Kunci API → Murah → Gratis
📊 Pelacakan Kuota Waktu Nyata	Jumlah token langsung + setel ulang hitungan mundur per penyedia
🔄 Terjemahan Format	OpenAI ↔ Claude ↔ Gemini ↔ Kursor ↔ Kiro mulus + sanitasi respons
👥 Dukungan Multi-Akun	Banyak akun per penyedia dengan pilihan cerdas
🔄 Penyegaran Token Otomatis	Token OAuth disegarkan secara otomatis dengan coba lagi
🎨 Kombo Khusus	6 strategi: isi dulu, round-robin, p2c, acak, paling jarang digunakan, hemat biaya
🧩 Model Khusus	Tambahkan ID model apa pun ke penyedia mana pun
🌐 Router Wildcard	Rutekan pola provider/* ke penyedia mana pun secara dinamis
🧠 Memikirkan Anggaran	Mode passthrough, otomatis, kustom, dan adaptif untuk model penalaran
💬 Injeksi Perintah Sistem	Perintah sistem global diterapkan di semua permintaan
📄 API Respons	Dukungan penuh OpenAI Responses API (/v1/responses) untuk Codex

🎵 API Multi-Modal

Fitur	Apa Fungsinya
🖼️ Pembuatan Gambar	/v1/images/generations — 4 penyedia, 9+ model
📐 Sematan	/v1/embeddings — 6 penyedia, 9+ model
🎤 Transkripsi Audio	/v1/audio/transcriptions — Kompatibel dengan bisikan
🔊 Teks-ke-Ucapan	/v1/audio/speech — Sintesis audio multi-penyedia
🛡️ Moderasi	/v1/moderations — Pemeriksaan keamanan konten
🔀 Pemeringkatan Ulang	/v1/rerank — Pemeringkatan ulang relevansi dokumen

🛡️ Ketahanan & Keamanan

Fitur	Apa Fungsinya
🔌 Pemutus Arus	Buka/tutup otomatis per penyedia dengan ambang batas yang dapat dikonfigurasi
🛡️ Kawanan Anti Guntur	Batas kecepatan mutex + semaphore untuk penyedia kunci API
🧠 Cache Semantik	Cache dua tingkat (tanda tangan + semantik) mengurangi biaya & latensi
⚡ Minta Idempotensi	Jendela dedup 5 detik untuk permintaan duplikat
🔒 Spoofing Sidik Jari TLS	Lewati deteksi bot berbasis TLS melalui wreq-js
🌐 Pemfilteran IP	Daftar yang diizinkan/daftar blokir untuk kontrol akses API
📊 Batas Tarif yang Dapat Diedit	RPM yang dapat dikonfigurasi, celah minimum, dan maks secara bersamaan pada tingkat sistem
🛡 Perlindungan Titik Akhir API	Gerbang autentikasi + pemblokiran penyedia untuk titik akhir /models
🔒 Visibilitas Proksi	Lencana berkode warna: 🟢 global, 🟡 penyedia, 🔵 per koneksi dengan tampilan IP
🌐 Konfigurasi Proksi 3 Tingkat	Konfigurasikan proxy di tingkat global, per penyedia, atau per koneksi

📊 Observabilitas & Analisis

Fitur	Apa Fungsinya
📝 Permintaan Pencatatan	Mode debug dengan log permintaan/respons lengkap
💾 Log Proksi SQLite	Log proksi persisten bertahan saat server dimulai ulang
📊 Dasbor Analitik	Didukung grafik ulang: kartu stat, bagan penggunaan model, tabel penyedia
📈 Pelacakan Kemajuan	Ikut serta dalam acara kemajuan SSE untuk streaming
🧪 Evaluasi LLM	Pengujian set emas dengan 4 strategi pertandingan
🔍 Permintaan Telemetri	agregasi latensi p50/p95/p99 + penelusuran X-Request-Id
📋 Dasbor Log	Halaman 4 tab terpadu: Log Permintaan, Log Proksi, Log Audit, Konsol
🖥️ Penampil Log Konsol	Penampil gaya terminal real-time dengan filter level, pencarian, gulir otomatis
📑 Logging Berbasis File	Pencegat konsol menangkap semua output ke file log JSON dengan rotasi
🏥 Dasbor Kesehatan	Waktu aktif sistem, status pemutus sirkuit, penguncian, statistik cache
💰 Pelacakan Biaya	Manajemen anggaran + konfigurasi harga per model

☁️ Penerapan & Sinkronisasi

Fitur	Apa Fungsinya
💾 Sinkronisasi Cloud	Sinkronkan konfigurasi antar perangkat melalui Cloudflare Workers
🌐 Terapkan Di Mana Saja	Localhost, VPS, Docker, Pekerja Cloudflare
🔑 Manajemen Kunci API	Menghasilkan, memutar, dan mencakup kunci API per penyedia
🧙 Wizard Orientasi	Penyiapan terpandu 4 langkah untuk pengguna pertama kali
🔧 Dasbor Alat CLI	Konfigurasikan sekali klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 Cadangan DB	Pencadangan, pemulihan, ekspor & impor otomatis untuk semua pengaturan
🌐 Internasionalisasi	I18n lengkap dengan next-intl — Dukungan Inggris + Portugis (Brasil)
🌍 Pemilih Bahasa	Ikon bola dunia di header untuk peralihan bahasa secara real-time (🇮🇩/🇧🇷)
📂 Direktori Data Khusus	DATA_DIR env var untuk mengganti jalur penyimpanan ~/.omniroute default

📖 Detail Fitur

🎯 Penggantian 4 Tingkat yang Cerdas

Buat kombo dengan fallback otomatis:

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

📊 Pelacakan Kuota Waktu Nyata

• Konsumsi token per penyedia
• Atur ulang hitungan mundur (5 jam, harian, mingguan)
• Estimasi biaya untuk tingkatan berbayar
• Laporan pengeluaran bulanan

🔄 Format Terjemahan

Terjemahan mulus antar format:

• OpenAI ↔ Claude ↔ Gemini ↔ Respon OpenAI
• Alat CLI Anda mengirimkan format OpenAI → OmniRoute menerjemahkan → Penyedia menerima format asli
• Bekerja dengan alat apa pun yang mendukung titik akhir OpenAI khusus
• Sanitasi respons — Menghapus kolom non-standar untuk kompatibilitas OpenAI SDK yang ketat
• Normalisasi peran — developer → system untuk non-OpenAI; system → user untuk model GLM/ERNIE
• Think tag ekstraksi — <think> blok → reasoning_content untuk model berpikir
• Keluaran terstruktur — json_schema → responseMimeType/responseSchema Gemini

👥 Dukungan Multi-Akun

• Tambahkan beberapa akun per penyedia
• Perutean otomatis round-robin atau berbasis prioritas
• Penggantian ke akun berikutnya ketika ada yang mencapai kuota

🔄 Penyegaran Token Otomatis

• Token OAuth secara otomatis disegarkan sebelum masa berlakunya habis
• Tidak diperlukan otentikasi ulang manual
• Pengalaman mulus di semua penyedia

🎨 Kombo Khusus

• Buat kombinasi model tanpa batas
• 6 strategi: isi pertama, round-robin, kekuatan dua pilihan, acak, paling jarang digunakan, hemat biaya
• Bagikan kombo di seluruh perangkat dengan Cloud Sync

🏥 Dasbor Kesehatan

• Status sistem (waktu aktif, versi, penggunaan memori)
• Status pemutus sirkuit per penyedia (Tertutup/Terbuka/Setengah Terbuka)
• Status batas tarif dan penguncian aktif
• Statistik cache tanda tangan
• Telemetri latensi (p50/p95/p99) + cache cepat
• Atur ulang status kesehatan dengan satu klik

🔧 Taman Bermain Penerjemah

OmniRoute menyertakan Taman Bermain Penerjemah bawaan yang canggih dengan 4 mode untuk melakukan debug, menguji, dan memantau terjemahan API:

Modus	Deskripsi
💻 Taman bermain	Terjemahan format langsung — tempelkan isi permintaan API apa pun dan langsung lihat bagaimana OmniRoute menerjemahkannya antar format penyedia (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Termasuk contoh templat dan deteksi otomatis format.
💬 Penguji Obrolan	Kirim permintaan obrolan nyata melalui OmniRoute dan lihat perjalanan pulang pergi selengkapnya: masukan Anda, permintaan yang diterjemahkan, respons penyedia, dan respons yang diterjemahkan kembali. Sangat berharga untuk memvalidasi perutean kombo.
🧪 Bangku Tes	Mode pengujian batch — tentukan beberapa kasus pengujian dengan masukan berbeda dan keluaran yang diharapkan, jalankan semuanya sekaligus, dan bandingkan hasilnya di seluruh penyedia dan model.
📱 Monitor Langsung	Pemantauan permintaan waktu nyata — perhatikan permintaan masuk saat mengalir melalui OmniRoute, lihat terjemahan format yang terjadi secara langsung, dan identifikasi masalah secara instan.

Akses: Dasbor → Penerjemah (bilah samping)

💾 Sinkronisasi Awan

• Sinkronisasi penyedia, kombo, dan pengaturan di seluruh perangkat
• Sinkronisasi latar belakang otomatis
• Penyimpanan terenkripsi yang aman

---

📖 Panduan Pengaturan

💳 Penyedia Langganan

Kode Claude (Pro/Maks)

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

Kiat Pro: Gunakan Opus untuk tugas kompleks, Soneta untuk kecepatan. OmniRoute melacak kuota per model!

Kodeks OpenAI (Plus/Pro)

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 (GRATIS 180K/bulan!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

Nilai Terbaik: Tingkat gratis yang sangat besar! Gunakan ini sebelum tingkatan berbayar.

Kopilot GitHub

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

🔑 Penyedia Kunci API

NVIDIA NIM (GRATIS 1000 kredit!)

1. Daftar: build.nvidia.com
2. Dapatkan kunci API gratis (termasuk 1000 kredit inferensi)
3. Dasbor → Tambah Penyedia → NVIDIA NIM:
   • Kunci API: nvapi-your-key

Model: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct, dan 50+ lainnya

Kiat Pro: API yang kompatibel dengan OpenAI — bekerja secara lancar dengan terjemahan format OmniRoute!

Pencarian Dalam

1. Daftar: platform.deepseek.com
2. Dapatkan kunci API
3. Dasbor → Tambah Penyedia → DeepSeek

Model: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (Tersedia Tingkat Gratis!)

1. Daftar: console.groq.com
2. Dapatkan kunci API (termasuk tingkat gratis)
3. Dasbor → Tambah Penyedia → Groq

Model: groq/llama-3.3-70b, groq/mixtral-8x7b

Kiat Pro: Inferensi ultra-cepat — terbaik untuk pengkodean waktu nyata!

OpenRouter (100+ Model)

1. Daftar: openrouter.ai
2. Dapatkan kunci API
3. Dasbor → Tambah Penyedia → OpenRouter

Model: Akses 100+ model dari semua penyedia utama melalui satu kunci API.

💰 Penyedia Murah (Cadangan)

GLM-4.7 (Reset harian, $0,6/1 juta)

1. Daftar: Zhipu AI
2. Dapatkan kunci API dari Coding Plan
3. Dasbor → Tambahkan Kunci API:
   • Penyedia: glm
   • Kunci API: your-key

Gunakan: glm/glm-4.7

Tips Pro: Paket Coding menawarkan 3× kuota dengan biaya 1/7! Reset setiap hari pukul 10.00.

MiniMax M2.1 (reset 5 jam, $0,20/1 juta)

1. Daftar: MiniMax
2. Dapatkan kunci API
3. Dasbor → Tambahkan Kunci API

Gunakan: minimax/MiniMax-M2.1

Kiat Pro: Opsi termurah untuk konteks panjang (1 juta token)!

Kimi K2 ($9/bulan tetap)

1. Berlangganan: Moonshot AI
2. Dapatkan kunci API
3. Dasbor → Tambahkan Kunci API

Gunakan: kimi/kimi-latest

Kiat Pro: Memperbaiki $9/bulan untuk 10 juta token = biaya efektif $0,90/1 juta!

🆓 Penyedia GRATIS (Cadangan Darurat)

iFlow (8 model GRATIS)

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 model GRATIS)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude GRATIS)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 Buat Kombo

Contoh 1: Maksimalkan Langganan → Cadangan Murah

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

Contoh 2: Gratis Saja (Tanpa Biaya)

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!

🔧 Integrasi CLI

IDE Kursor

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Kode Claude

Gunakan halaman Alat CLI di dasbor untuk konfigurasi sekali klik, atau edit ~/.claude/settings.json secara manual.

Kodeks CLI

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

codex "your prompt"

Buka Cakar

Opsi 1 — Dasbor (disarankan):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Opsi 2 — Panduan: Sunting ~/.openclaw/openclaw.json:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

Catatan: OpenClaw hanya berfungsi dengan OmniRoute lokal. Gunakan 127.0.0.1 alih-alih localhost untuk menghindari masalah resolusi IPv6.

Cline / Lanjutkan / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

---

📊 Model yang Tersedia

Lihat semua model yang tersedia

Kode Claude (cc/) - Pro/Maks:

• cc/claude-opus-4-6
• cc/claude-sonnet-4-5-20250929
• cc/claude-haiku-4-5-20251001

Kodeks (cx/) - Plus/Pro:

• cx/gpt-5.2-codex
• cx/gpt-5.1-codex-max

Gemini CLI (gc/) - GRATIS:

• gc/gemini-3-flash-preview
• gc/gemini-2.5-pro

Copilot GitHub (gh/):

• gh/gpt-5
• gh/claude-4.5-sonnet

NVIDIA NIM (nvidia/) - Kredit GRATIS:

• nvidia/llama-3.3-70b-instruct
• nvidia/mistral-7b-instruct
• 50+ model lainnya di build.nvidia.com

GLM (glm/) - $0,6/1 juta:

• glm/glm-4.7

MiniMax (minimax/) - $0,2/1 juta:

• minimax/MiniMax-M2.1

iFlow (if/) - GRATIS:

• if/kimi-k2-thinking
• if/qwen3-coder-plus
• if/deepseek-r1
• if/glm-4.7
• if/minimax-m2

Qwen (qw/) - GRATIS:

• qw/qwen3-coder-plus
• qw/qwen3-coder-flash

Kiro (kr/) - GRATIS:

• kr/claude-sonnet-4.5
• kr/claude-haiku-4.5

OpenRouter (or/) - 100+ model:

• or/anthropic/claude-4-sonnet
• or/google/gemini-2.5-pro
• Model apa pun dari openrouter.ai/models

---

🧪 Evaluasi (Eval)

OmniRoute menyertakan kerangka evaluasi bawaan untuk menguji kualitas respons LLM terhadap rangkaian emas. Akses melalui Analytics → Evals di dasbor.

Set Emas Bawaan

"OmniRoute Golden Set" yang dimuat sebelumnya berisi 10 kasus uji yang meliputi:

• Salam, matematika, geografi, pembuatan kode
• Kepatuhan format JSON, terjemahan, penurunan harga
• Penolakan keamanan (konten berbahaya), penghitungan, logika boolean

Strategi Evaluasi

Strategi	Deskripsi	Contoh
exact	Output harus sama persis	"4"
contains	Output harus berisi substring (tidak peka huruf besar-kecil)	"Paris"
regex	Output harus sesuai dengan pola regex	"1.*2.*3"
custom	Fungsi JS khusus mengembalikan benar/salah	(output) => output.length > 10

---

🔐 OAuth em Servidor Remoto (Pengaturan OAuth Jarak Jauh)

⚠️ PENTING bagi pengguna dengan OmniRoute pada VPS/Docker/server jarak jauh

Mengapa OAuth melakukan Antigravity / Gemini CLI gagal dalam layanan jarak jauh?

Pembuktiannya Antigravitasi dan Gemini CLI digunakan Google OAuth 2.0 untuk autentikasi. Google meminta agar redirect_uri menggunakan OAuth yang terus berubah, jadi exatamente adalah URI yang sudah ada sebelumnya di Google Cloud Console yang dapat diterapkan.

Karena kredensial OAuth yang diberikan pada OmniRoute adalah kadastrada apenas untuk localhost. Ketika Anda mengakses OmniRoute dari server jarak jauh (misal: https://omniroute.meuservidor.com), atau Google meminta autenticação com:

Error 400: redirect_uri_mismatch

Solusi: Konfigurasikan akun OAuth Anda

Anda perlu membuat ID Klien OAuth 2.0 di Google Cloud Console dengan URI di server Anda.

Lewati dulu

1. Mengakses Google Cloud Console

Abra: https://console.cloud.google.com/apis/credentials

2. Inilah ID Klien OAuth 2.0 yang baru

• Klik pada "+ Buat Kredensial" → "ID klien OAuth"
• Tip aplikasi: "Aplikasi web"
• Nama: nama escolha qualquer (misal: OmniRoute Remote)

3. Tambahan sebagai URI Pengalihan Resmi

Selain itu "URI pengalihan resmi", tambahan:

https://seu-servidor.com/callback

Pengganti seu-servidor.com pelo domínio atau IP ke server Anda (termasuk port yang diperlukan, misal: http://45.33.32.156:20128/callback).

4. Salep dan salin sebagai kredensial

Kemudian, Google menampilkan ID Klien dan Rahasia Klien.

5. Konfigurasikan sebagai variáveis de ambiente

Di .env (atau berbagai lingkungan di Docker):

# 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. Memulai kembali OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Mari kita sambungkan lagi

Dasbor → Penyedia → Antigravitasi (atau Gemini CLI) → OAuth

Sekarang o Google dialihkan langsung ke https://seu-servidor.com/callback dan autentikasi berfungsi.

---

Solusi sementara (sem configurar credenciais próprias)

Jika Anda tidak ingin membuat kredensial pribadi sekarang, Anda mungkin dapat menggunakan fluks panduan URL:

1. O OmniRoute membuka URL autoriza dari Google
2. Setelah Anda autorizar, Google mengarahkan pengalihan ke localhost (yang gagal pada server jarak jauh)
3. Salin URL lengkap dari bilah akhir browser Anda (meskipun halaman tidak dimuat)
4. Gunakan URL ini karena tidak ada modal koneksi ke OmniRoute
5. Klik pada "Hubungkan"

Solusi ini berfungsi karena kode otorisasi pada URL valid secara independen untuk mengarahkan ulang ke akun atau tidak.

---

🐛 Pemecahan masalah

Klik untuk memperluas panduan pemecahan masalah

"Model bahasa tidak memberikan pesan"

• Kuota penyedia habis → Periksa dashboard pelacak kuota
• Solusi: Gunakan combo fallback atau beralih ke tier yang lebih murah

Pembatasan tarif

• Kuota berlangganan habis → Penggantian ke GLM/MiniMax
• Tambahkan kombo: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

Token OAuth kedaluwarsa

• Disegarkan secara otomatis oleh OmniRoute
• Jika masalah terus berlanjut: Dasbor → Penyedia → Sambungkan kembali

Biaya tinggi

• Periksa statistik penggunaan di Dashboard → Biaya
• Ganti model utama ke GLM/MiniMax
• Gunakan tingkat gratis (Gemini CLI, iFlow) untuk tugas-tugas yang tidak penting

Dasbor terbuka pada port yang salah

• Tetapkan PORT=20128 dan NEXT_PUBLIC_BASE_URL=http://localhost:20128

Kesalahan sinkronisasi cloud

• Verifikasi BASE_URL poin ke instance Anda yang sedang berjalan
• Verifikasi CLOUD_URL poin ke titik akhir cloud yang Anda harapkan
• Jaga agar nilai NEXT_PUBLIC_* selaras dengan nilai sisi server

Login pertama tidak berfungsi

• Periksa INITIAL_PASSWORD di .env
• Jika tidak disetel, kata sandi cadangan adalah 123456

Tidak ada log permintaan

• Tetapkan ENABLE_REQUEST_LOGS=true di .env

Tes koneksi menunjukkan "Tidak Valid" untuk penyedia yang kompatibel dengan OpenAI

• Banyak penyedia tidak mengekspos titik akhir /models
• OmniRoute v1.0.6+ menyertakan validasi fallback melalui penyelesaian obrolan
• Pastikan URL dasar menyertakan akhiran /v1

---

🛠️ Tumpukan Teknologi

• Runtime: Node.js 18–22 LTS (⚠️ Node.js 24+ tidak didukung — better-sqlite3 biner asli tidak kompatibel)
• Bahasa: TypeScript 5.9 — 100% TypeScript di src/ dan open-sse/ (v1.0.6)
• Kerangka Kerja: Next.js 16 + React 19 + Tailwind CSS 4
• Database: LowDB (JSON) + SQLite (status domain + log proksi)
• Streaming: Peristiwa Terkirim Server (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + Kunci API
• Pengujian: pelari pengujian Node.js (368+ pengujian unit)
• CI/CD: Tindakan GitHub (publikasi npm otomatis + Docker Hub saat dirilis)
• Situs Web: omniroute.online
• Paket: npmjs.com/package/omniroute
• Pekerja Pelabuhan: hub.docker.com/r/diegosouzapw/omniroute
• Ketahanan: Pemutus sirkuit, kemunduran eksponensial, kawanan anti-guntur, spoofing TLS

---

📖 Dokumentasi

Dokumen	Deskripsi
User Guide	Penyedia, kombo, integrasi CLI, penerapan
API Reference	Semua titik akhir dengan contoh
Troubleshooting	Masalah umum dan solusinya
Architecture	Arsitektur sistem dan internal
Contributing	Pengaturan dan pedoman pengembangan
OpenAPI Spec	Spesifikasi OpenAPI 3.0
Security Policy	Pelaporan kerentanan dan praktik keamanan
VM Deployment	Panduan lengkap: VM + nginx + Pengaturan Cloudflare
Features Gallery	Tur dasbor visual dengan tangkapan layar

📸 Pratinjau Dasbor

Klik untuk melihat tangkapan layar dasbor

Halaman	Tangkapan layar
Penyedia
Kombo
Analitik
Kesehatan
Penerjemah
Pengaturan
Alat CLI
Log Penggunaan
Titik Akhir

---

🗺️ Peta Jalan

OmniRoute memiliki 210+ fitur yang direncanakan di berbagai fase pengembangan. Berikut adalah bidang-bidang utamanya:

Kategori	Fitur yang Direncanakan	Sorotan
🧠 Perutean & Kecerdasan	25+	Perutean latensi terendah, perutean berbasis tag, preflight kuota, pemilihan akun P2C
🔒 Keamanan & Kepatuhan	20+	Pengerasan SSRF, penyelubungan kredensial, batas tarif per titik akhir, pelingkupan kunci manajemen
📊 Kemampuan Observasi	15+	Integrasi OpenTelemetry, pemantauan kuota waktu nyata, pelacakan biaya per model
🔄 Integrasi Penyedia	20+	Registri model dinamis, cooldown penyedia, Codex multi-akun, penguraian kuota Salinan
⚡ Kinerja	15+	Lapisan cache ganda, cache cepat, cache respons, streaming keepalive, API batch
🌐 Ekosistem	10+	WebSocket API, konfigurasi hot-reload, penyimpanan konfigurasi terdistribusi, mode komersial

🔜 Segera Hadir

• 🔗 Integrasi OpenCode — Dukungan penyedia asli untuk IDE pengkodean AI OpenCode
• 🔗 Integrasi TRAE — Dukungan penuh untuk kerangka pengembangan AI TRAE
• 📦 Batch API — Pemrosesan batch asinkron untuk permintaan massal
• 🎯 Perutean Berbasis Tag — Merutekan permintaan berdasarkan tag dan metadata khusus
• 💰 Strategi Biaya Terendah — Secara otomatis memilih penyedia termurah yang tersedia

📝 Spesifikasi fitur lengkap tersedia di OMNI_TOKEN_147 (217 spesifikasi detail)

---

📧 Dukungan

💬 Bergabunglah dengan komunitas kami! WhatsApp Group — Dapatkan bantuan, berbagi kiat, dan dapatkan informasi terbaru.

• Situs Web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Masalah: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Proyek Asli: 9router by decolua

---

👥 Kontributor

Cara Berkontribusi

1. Cabangkan repositori
2. Buat cabang fitur Anda (git checkout -b feature/amazing-feature)
3. Komit perubahan Anda (git commit -m 'Add amazing feature')
4. Dorong ke cabang (git push origin feature/amazing-feature)
5. Buka Permintaan Tarik

Lihat CONTRIBUTING.md untuk panduan detailnya.

Merilis Versi Baru

# Create a release — npm publish happens automatically
gh release create v1.0.6 --title "v1.0.6" --generate-notes

---

📊 Sejarah Bintang

---

🙏 Ucapan Terima Kasih

Terima kasih khusus kepada 9router oleh decolua — proyek asli yang menginspirasi fork ini. OmniRoute dibangun di atas fondasi luar biasa tersebut dengan fitur tambahan, API multi-modal, dan penulisan ulang TypeScript lengkap.

Terima kasih khusus kepada CLIProxyAPI — implementasi Go asli yang menginspirasi port JavaScript ini.

---

📄 Lisensi

Lisensi MIT - lihat LICENSE untuk detailnya.

---

---

🇧🇷 OmniRoute — Gerbang IA Gratis

Tidak ada kode apa pun. Roteamento cerdas untuk model IA GRATIS dan hak istimewa dengan fallback otomatis.

Proksi universal API — um titik akhir, 36+ bukti, tanpa waktu henti.

🌐 Internasionalisasi (i18n)

Pada dasbor, lakukan OmniRoute mendukung beberapa idiom. Saat ini kami telah membagikannya:

Idiom	Kode	Status
🇮🇩 Bahasa Inggris	en	✅ Lengkap
🇧🇷 Português (Brasil)	pt-BR	✅ Lengkap

Untuk trocar o idioma: Klik no selector de idioma (🇮🇩 EN) no header do dashboard → pilih idioma yang diinginkan.

Untuk menambahkan idiom baru:

1. Teriak src/i18n/messages/{codigo}.json berdasarkan en.json
2. Tambahan kode pada src/i18n/config.ts → LOCALES dan LANGUAGES
3. Memulai kembali server

⚡ Mulai Cepat

# 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

🐳 buruh pelabuhan

docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest

🔑 Prinsip Fungsionalidades

• 36+ bukti IA — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, dan lainnya
• Roteamento inteligente — Penggantian otomatis ke seluruh bukti
• Penulisan format — OpenAI ↔ Claude ↔ Gemini secara otomatis
• Multi-konta — Multi-konta berdasarkan pilihan yang cerdas
• Cache semântico — Memulihkan biaya dan latensi
• OAuth otomatis — Token diperbarui secara otomatis
• Kombo yang dipersonalisasi — 6 strategi roteamento
• Dasbor lengkap — Monitor, log, analisis, konfigurasi
• Alat CLI — Konfigurasikan Kode Claude, Codex, Kursor, Cline com um klik
• 100% TypeScript — Kode limpo dan tipado

📖 Dokumentasi

Dokumen	Deskripsi
Guia do Usuário	Provedores, kombo, CLI, terapkan
Referência da API	Semua titik akhir dengan contoh
Solução de Problemas	Masalah Umum dan Solusi
Arquitetura	Arquitetura dan internal dalam sistem
Contribuição	Menyiapkan pedoman desenvolvimento
Deploy em VM	Panduan lengkap: VM + nginx + Cloudflare

📧 Dukungan

💬 Entre to a comunidade! Grupo WhatsApp — Ban dúvidas, compartilhe dicas dan fique aktualizado.

• Situs Web: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Masalah: github.com/diegosouzapw/OmniRoute/issues

---

_{Dibangun dengan ❤️ untuk pengembang yang membuat kode 24/7
omniroute.online}