Dokumentasi

Quickstart

Buat akun LokaRouter dan isi saldo prepaid Anda. Lalu buat API key dari dashboard.

Gunakan key tersebut dengan SDK OpenAI apa pun. Yang Anda ubah hanya dua hal: base URL dan API key.

from openai import OpenAI client = OpenAI(    base_url="https://api.lokarouter.id/v1",    api_key="sk-lkr-your-key",) response = client.chat.completions.create(    model="openai/gpt-5-mini",    messages=[{"role": "user", "content": "Hello, LokaRouter"}],)print(response.choices[0].message.content)

Demo gateway

API key yang Anda buat di dashboard berlaku terhadap demo gateway di situs ini. Endpoint-nya memakai format kawat OpenAI, memvalidasi key Anda, menerapkan batas 60 request per menit per key, dan mencatat waktu terakhir dipakai.

Ketika provider upstream belum dikonfigurasi, balasan asisten dibuat oleh demo gateway sendiri dan ditandai lokarouter.demo = true di respons. Dengan key upstream terkonfigurasi (UPSTREAM_API_KEY), request diteruskan sungguhan dan pemakaiannya dicatat dari respons provider.

Setiap request tercatat di dashboard dengan model, token, biaya, latensi, dan provider yang melayani. Dashboard juga menyediakan chat playground, batas budget per key, guardrails (daftar model/tool yang diizinkan), dan budget bulanan per workspace.

• POST /api/v1/chat/completions — chat completions kompatibel OpenAI
• GET /api/v1/models — daftar model yang bisa diakses
• Kirim "stream": true untuk menerima chunk Server-Sent Events

curl https://api.lokarouter.id/v1/chat/completions \  -H "Authorization: Bearer sk-lkr-your-key" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-5-mini",    "messages": [{ "role": "user", "content": "Hello" }]  }'

Di produksi endpoint berpindah ke https://api.lokarouter.id/v1.

Kompatibilitas OpenAI

LokaRouter mengimplementasikan REST surface OpenAI. Endpoint berikut didukung saat ini:

Arahkan SDK resmi atau klien komunitas mana pun ke https://api.lokarouter.id/v1 dan langsung bekerja. Streaming, function calling, dan JSON mode diteruskan ke provider di balik layar. Lihat API reference untuk bentuk request dan respons lengkap, metadata header, serta tabel error.

• POST /chat/completions
• POST /completions
• POST /embeddings
• GET /models
• GET /models/{id}

Files API (beta) juga tersedia — lihat API reference.

Memilih model

Identifier model memakai konvensi author/model, misalnya openai/gpt-5.2, anthropic/claude-opus-5, atau deepseek/deepseek-v4. Katalog hanya mengikuti rilis generasi terkini, dengan peluncuran baru ditambahkan begitu tersedia.

Berganti model adalah perubahan satu string — bentuk request tetap identik. Di halaman models Anda bisa memfilter berdasarkan provider, modalitas, kategori use-case, dan dukungan tool calling, atau mengurutkan berdasarkan harga, latensi, throughput, dan rilis terbaru.

Tidak mau memilih sendiri? Set model ke lokarouter/auto dan gateway mengarahkan setiap request ke yang paling cocok secara otomatis.

Fallback routing

Setiap model di LokaRouter di-host oleh beberapa provider infrastruktur. Ketika provider utama tidak tersedia atau kena rate limit, request dialihkan secara otomatis.

Anda bisa mengatur prioritasnya lewat objek provider preferences: prioritaskan harga, throughput, atau uptime. Jika perlu mengunci provider tertentu, kirim slug-nya dan set allow_fallbacks ke false.

response = client.chat.completions.create(  model="openai/gpt-5.2",  messages=[{"role": "user", "content": "Hello"}],  extra_body={    "provider": {      "sort": "throughput",   # price | throughput | uptime      "allow_fallbacks": True    }  },)

Provider preferences bersifat opsional — default mengoptimalkan uptime.

Integrasi alat

Alat apa pun yang mengizinkan base URL kompatibel OpenAI bisa memakai LokaRouter. Isi kolom seperti di bawah dan pilih model id.

• Cursor: Settings > Models > OpenAI API Key, override base URL.
• Continue.dev: config.yaml > provider
• Replit: set OPENAI_BASE_URL di Secrets.
• Kilo Code: provider settings > Base URL.
• MCP Server: kirim base URL dan key di konfigurasi model server.