Cara Membuat & Memakai API Key OpenRouter (Panduan 2026)

tl;dr — API key OpenRouter dibuat di halaman Keys setelah kamu punya akun, lalu dipakai sebagai Bearer token di header Authorization. Endpointnya https://openrouter.ai/api/v1/chat/completions dan mengikuti spesifikasi API OpenAI, jadi kode lama yang sudah memakai OpenAI SDK cukup diganti base URL dan kuncinya. Satu kunci itu membuka akses ke 430 model dari puluhan penyedia, termasuk 18 model bervarian :free yang tidak memotong saldo. Dokumentasi resmi OpenRouter menyebut kunci mereka lebih berkuasa dibanding kunci provider biasa karena bisa diberi batas kredit dan dipakai dalam alur OAuth — alasan kenapa penyimpanannya tidak boleh sembarangan.

Banyak orang berhenti di langkah pertama bukan karena kesulitan teknis, tapi karena bingung membedakan mana kunci untuk memanggil model dan mana kunci untuk mengelola akun. Panduan berikut membereskan urutannya dari membuat akun sampai panggilan pertamamu berhasil, lengkap dengan kesalahan umum yang bikin error 401 dan 402.

Apa Fungsi API Key OpenRouter

OpenRouter berperan sebagai perantara: kamu memanggil satu alamat, mereka meneruskannya ke penyedia model yang sesuai. API key adalah identitas yang dipakai untuk menghitung pemakaian dan memotong saldo kreditmu.

Menurut dokumentasi autentikasi OpenRouter, ada tiga metode autentikasi yang berlaku: cookie untuk antarmuka web dan chatroom, API key sebagai Bearer token untuk memanggil model, serta Management API key khusus untuk mengelola kunci secara programatis. Yang kamu butuhkan untuk menjalankan model adalah tipe kedua.

Keunggulan praktisnya terasa saat kamu ingin berpindah model. Tanpa gateway, mencoba Claude berarti mendaftar ke Anthropic, mengurus penagihan terpisah, dan menulis ulang pemanggilan API. Dengan satu kunci OpenRouter, perpindahan itu cuma soal mengganti satu string. Kami sudah membandingkan perbedaan karakter tiap model dalam ulasan perbedaan model LLM Claude, GPT, dan Gemini kalau kamu masih menimbang mau memakai yang mana.

Cara Membuat API Key OpenRouter

Prosesnya empat langkah dan tidak sampai lima menit:

1. Buat akun

Daftar di openrouter.ai memakai email, akun Google, atau GitHub. Semua pengguna baru mendapat jatah percobaan kecil untuk mencoba layanan.

2. Buka halaman Keys

Masuk ke openrouter.ai/keys. Halaman ini yang disebut dokumentasi resmi sebagai tempat pembuatan kunci, terpisah dari halaman pengaturan kredit.

3. Beri nama dan batas kredit

Isi nama kunci sesuai peruntukannya — misalnya bot-cs-produksi atau eksperimen-lokal. Kolom batas kredit bersifat opsional tapi sangat disarankan diisi: nilai itu menjadi plafon maksimal yang bisa dihabiskan kunci tersebut. Kalau satu aplikasi bermasalah dan memanggil model berulang tanpa henti, kerugianmu berhenti di angka itu.

4. Salin sekali, simpan aman

Kunci ditampilkan sekali saat dibuat. Simpan ke pengelola kata sandi atau environment variable, jangan ke catatan biasa dan jangan langsung ditempel ke dalam kode.

Cara Memakai API Key di Kode

Kunci dikirim sebagai Bearer token pada header Authorization. Berikut bentuk paling dasarnya lewat cURL:

curl https://openrouter.ai/api/v1/chat/completions 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $OPENROUTER_API_KEY" 
  -d '{
  "model": "google/gemma-4-31b-it:free",
  "messages": [
    {"role": "user", "content": "Halo, jelaskan apa itu AI Agent dalam dua kalimat."}
  ]
}'

Versi Python memakai OpenAI SDK yang sudah umum dipakai, cukup diarahkan ulang:

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=os.getenv("OPENROUTER_API_KEY"),
)

response = client.chat.completions.create(
    model="google/gemma-4-31b-it:free",
    messages=[
        {"role": "user", "content": "Halo, jelaskan apa itu AI Agent dalam dua kalimat."}
    ],
)

print(response.choices[0].message.content)

Dua header opsional bisa ditambahkan: HTTP-Referer berisi URL situsmu dan X-OpenRouter-Title berisi nama aplikasi. Keduanya tidak memengaruhi hasil, hanya membuat aplikasimu muncul di papan peringkat OpenRouter.

OpenRouter juga menyediakan SDK resmi sendiri lewat paket @openrouter/sdk untuk TypeScript dan openrouter untuk Python, plus Agent SDK @openrouter/agent yang menangani perulangan percakapan multi-giliran dan eksekusi tool secara otomatis. Untuk kebutuhan sederhana, memanggil endpoint langsung sudah cukup.

Memilih Model: Format Slug dan Varian

Nilai model memakai format penyedia/nama-model, contohnya google/gemma-4-31b-it. Daftar lengkapnya bisa diambil sendiri dari endpoint publik https://openrouter.ai/api/v1/models tanpa perlu autentikasi. Saat pemeriksaan terakhir kami pada September 2026, terdaftar 430 model di sana.

Akhiran khusus mengubah perilaku routing, dan ini yang membedakan pemakaian dasar dari pemakaian cermat:

Varian	Efek	Kapan dipakai
:free	Model gratis, rate limit rendah	Belajar dan prototipe
:nitro	Prioritas penyedia tercepat	Aplikasi interaktif, chat real-time
:floor	Prioritas penyedia termurah	Pekerjaan batch, volume besar
:exacto	Prioritas keandalan pemanggilan tool	Agent yang memanggil banyak fungsi

Varian :online yang dulu dipakai untuk menambahkan hasil pencarian web sudah berstatus usang menurut FAQ resminya, digantikan server tool openrouter:web_search. Kalau kamu menemukan tutorial lama yang masih memakainya, itu tanda tutorial tersebut belum diperbarui.

Pemilihan varian ini berdampak langsung ke ongkos. Menjalankan pekerjaan batch dengan :nitro berarti membayar penyedia termahal demi kecepatan yang tidak dibutuhkan siapa-siapa. Logika penghematan serupa berlaku di platform lain — pembahasan lengkap soal menekan biaya lewat pemilihan fitur ada di ulasan kami tentang fitur Gemini API yang bikin agent lebih murah.

Menyambungkan ke Tool Coding

Cara tercepat merasakan manfaat satu kunci untuk banyak model adalah memasangnya di editor. Pola pengaturannya seragam di hampir semua tool: cari bagian penyedia model, pilih OpenRouter atau opsi “OpenAI Compatible”, isi base URL https://openrouter.ai/api/v1, tempel kunci, lalu tulis slug model.

Pola tersebut berlaku untuk Cline, Roo Code, Cursor, dan tool sejenis yang menerima endpoint kompatibel OpenAI. Kalau kamu ingin melihat langkah pengaturan yang serupa dalam bentuk lebih rinci, kami pernah menuliskannya untuk penyedia berbeda di panduan cara connect Gemini API ke Cline dan Roo Code — struktur pengisiannya sama, hanya nilai base URL dan kuncinya yang berbeda.

Untuk asisten coding yang mendukung MCP, OpenRouter menyediakan server terkelola di https://mcp.openrouter.ai/mcp sehingga asistenmu bisa membaca data langsung soal model yang tersedia, harganya, dan sisa saldomu alih-alih menebak dari data pelatihan lama. Konsep dasar protokolnya sudah kami bahas di artikel MCP Server: apa itu dan kenapa AI Agent membutuhkannya.

Mengamankan Kunci dan Membaca Error

Dokumentasi resmi memberi peringatan tegas: kunci OpenRouter lebih berkuasa dibanding kunci model biasa, dan tidak boleh dikirim ke repositori publik. OpenRouter berstatus mitra pemindaian rahasia GitHub, sehingga kunci yang bocor akan terdeteksi dan pemiliknya diberi tahu lewat surel. Kalau itu terjadi, langkah yang benar adalah menghapus kunci lama di halaman pengaturan lalu membuat yang baru.

Tiga kode error paling sering muncul dan artinya berbeda-beda:

• 401 Unauthorized — kunci salah, kedaluwarsa, atau dinonaktifkan. Sering terjadi karena kata Bearer lupa ditulis sebelum kunci.
• 402 Payment Required — saldo habis atau batas kredit kunci tersebut sudah tersentuh. Cek lewat GET https://openrouter.ai/api/v1/key untuk melihat sisa kuota.
• 429 Too Many Requests — melampaui batas permintaan. Tangani dengan jeda bertingkat dan patuhi header Retry-After jika ada.

Kebiasaan menaruh kunci di environment variable, bukan di dalam berkas kode, menutup sebagian besar risiko ini sejak awal. Di Komunitech, pengelolaan kredensial semacam ini kami ajarkan sebagai bagian dari workshop OpenClaw untuk membangun Karyawan AI, karena agent yang punya akses API tanpa pagar pengaman adalah risiko operasional yang nyata, bukan sekadar urusan teknis.

Pertanyaan yang Sering Ditanya

Apakah API key OpenRouter gratis?

Membuat kuncinya gratis dan tidak perlu kartu kredit. Yang berbayar adalah pemakaian model. Kamu tetap bisa memanggil model berlabel :free tanpa mengisi saldo, dengan batas 50 permintaan per hari.

Kenapa muncul error 401 padahal kunci sudah benar?

Penyebab paling umum adalah format header. Nilainya harus Bearer <kunci>, bukan kuncinya saja. Penyebab kedua adalah spasi atau baris baru yang ikut tersalin saat menempel kunci.

Bisakah satu API key dipakai untuk beberapa aplikasi?

Bisa, tapi risikonya lebih besar dari manfaatnya. Buat kunci terpisah per aplikasi dengan batas kredit masing-masing, supaya pemakaian bisa dilacak per aplikasi dan satu kebocoran tidak memaksamu mengganti kunci di semua tempat sekaligus.

Apakah kode OpenAI lama perlu ditulis ulang?

Tidak. OpenRouter mengimplementasikan spesifikasi API OpenAI untuk endpoint /chat/completions, sehingga cukup mengubah base_url dan api_key. Struktur permintaan dan responsnya tetap sama.

Bagaimana cara mengecek sisa saldo lewat API?

Kirim permintaan GET ke https://openrouter.ai/api/v1/key dengan kunci yang sama. Responsnya memuat limit_remaining, total pemakaian, serta rincian pemakaian harian, mingguan, dan bulanan.

Catatan

Langkah dan angka di atas mengacu pada dokumentasi resmi OpenRouter per September 2026. Antarmuka dan kebijakan platform dapat berubah — periksa dokumentasi resminya bila ada perbedaan. Komunitech tidak berafiliasi dengan OpenRouter dan tidak menerima kompensasi apa pun dari layanan tersebut.

Referensi

• OpenRouter — Authentication (Bearer token, metode autentikasi, kebijakan kunci bocor)
• OpenRouter — Quickstart (contoh kode, SDK resmi, MCP server)
• OpenRouter — FAQ (varian model, dukungan SDK, spesifikasi endpoint)
• OpenRouter — Limits (kode error 401/402/429, pengecekan sisa kredit)
• OpenRouter — Daftar model publik (jumlah model terdaftar)

Artikel telah diupdate pada 07/09/2026 untuk memastikan artikel tetap sesuai kondisi terkini.