OpenRouter: Satu API untuk Banyak Model

Apa Itu OpenRouter

Bayangkan kamu mau coba banyak merek mie instan, tapi tiap merek dijual di toko berbeda dengan sistem pembayaran berbeda. Repot. OpenRouter adalah "supermarket"-nya model AI: satu API, satu akun, satu sistem pembayaran, tapi kamu bisa mengakses ratusan model AI dari berbagai pembuat: OpenAI, Anthropic, Google, Meta, Mistral, sampai model terbuka seperti Hermes dan DeepSeek.

Secara teknis, OpenRouter adalah gateway/model router: kamu mengirim request dengan format yang sama (mirip format API OpenAI), lalu OpenRouter meneruskannya ke provider model yang kamu pilih. Kamu bisa ganti model hanya dengan mengganti satu string nama model, tanpa mengubah kode. Ini sangat powerful untuk eksperimen: bandingkan jawaban Claude vs GPT vs Hermes untuk prompt yang sama, lalu pilih yang terbaik untuk kebutuhanmu.

Kenapa Developer Memakainya

Tiga alasan utama. Pertama, fleksibilitas: satu kode bisa jalan dengan model apa pun. Kalau satu provider down atau menaikkan harga, pindah model semudah ganti nama. Kedua, akses model terbuka yang murah: banyak model open-weights (seperti Hermes) tersedia di OpenRouter dengan harga sangat murah, cocok untuk latihan dan proyek kecil. Ketiga, tidak perlu API key banyak: satu key OpenRouter untuk semua model, dan kamu bisa batasi budget per key supaya tidak jebol.

Contoh 1: Request Pertama via OpenRouter (Langkah Bertahap)

Kamu butuh API key dari openrouter.ai (ada kredit gratis untuk mulai). Format request-nya mengikuti standar OpenAI, jadi kalau kamu pernah memakai API OpenAI, rasanya familiar:

curl https://openrouter.ai/api/v1/chat/completions   -H "Authorization: Bearer $OPENROUTER_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "nousresearch/hermes-3-llama-3.1-405b",
    "messages": [
      { "role": "user", "content": "Jelaskan apa itu closure di JavaScript dalam 2 kalimat." }
    ]
  }'

Perhatikan field model: formatnya pembuat/nama-model. Mau coba model lain? Ganti jadi anthropic/claude-3.5-sonnet atau openai/gpt-4o-mini, kode lainnya tetap sama. Inilah keajaiban gateway: satu kode, ratusan model.

Contoh 2: Membandingkan Model untuk Tugas Ngoding

Tugas nyata: kamu mau tahu model mana yang paling bagus menjelaskan error untuk pemula. Buat skrip kecil (atau pakai playground OpenRouter di web) yang mengirim prompt IDENTIK ke 3 model berbeda:

Prompt: "Jelaskan error 'Cannot read properties of undefined' ke pemula. Maksimal 100 kata, bahasa Indonesia santai."

Kirim ke: (1) model gratis/murah seperti meta-llama/llama-3.1-8b-instruct:free, (2) model menengah seperti nousresearch/hermes-3-llama-3.1-405b, (3) model premium seperti anthropic/claude-3.5-sonnet. Bandingkan: kejelasan, ketepatan, dan bahasa. Kamu akan kaget: untuk tugas sederhana, model murah sering cukup bagus. Pelajaran mahal: jangan bayar model premium untuk tugas yang bisa dikerjakan model murah.

Catatan teknis: OpenRouter juga menyediakan endpoint /api/v1/models untuk melihat daftar model, harga per token, dan context window tiap model. Perhatikan dua angka harga: prompt tokens (input) dan completion tokens (output), biasanya output lebih mahal. Model bertanda :free gratis dengan batasan rate. Untuk coding agent, yang penting selain kepintaran adalah tool calling: kemampuan model memanggil "tools" (fungsi) dengan format terstruktur. Tidak semua model mendukungnya dengan baik, cek dokumentasi model sebelum dipakai untuk agent.

Kesalahan Umum

1. Langsung pakai model termahal. Mulai dari yang murah/gratis, naikkan hanya kalau hasilnya kurang. Kebanyakan tugas belajar tidak butuh model premium.
2. Tidak memantau pemakaian. Request ke model besar dengan konteks panjang bisa menghabiskan kredit cepat. Pasang batas budget di dashboard OpenRouter dan cek pemakaian berkala.
3. API key bocor ke kode. Jangan tulis API key langsung di kode atau commit ke Git. Pakai environment variable ($OPENROUTER_API_KEY) dan file .env yang masuk .gitignore. Key yang bocor bisa dipakai orang lain dan menghabiskan saldomu.

Rangkuman

OpenRouter = satu pintu ke ratusan model AI. Satu format API, ganti model semudah ganti nama, cocok untuk eksperimen dan hemat biaya. Mulai dari model gratis/murah, bandingkan untuk kebutuhanmu, dan jaga API key baik-baik. Di modul berikutnya kita bahas salah satu model terbuka paling populer untuk coding agent: Hermes.