Panduan Lengkap OpenRouter: Satu Kunci API untuk 364 Model Sekaligus, Panduan Isi Saldo, Perutean, dan Penghematan

OpenRouter menggabungkan ratusan model AI dalam satu endpoint tanpa biaya tambahan untuk inferensi. Artikel ini membahas cara mendaftar, mengisi saldo, membuat kunci API, panggilan API pertama, pemilihan model otomatis auto-beta, perutean penyedia, hingga trik lanjutan BYOK, lengkap dengan jebakan yang sering dialami oleh pengembang.

Pukul 1 dini hari, seorang developer independen di Taipei menghela napas menatap layar: side project-nya harus terhubung ke tiga model sekaligus—Claude untuk menulis kode, DeepSeek untuk tugas batch murah, dan sesekali ingin mencoba model open-source baru yang rilis. Tiga API key, tiga dasbor penagihan, tiga dokumentasi SDK, mengelola kunci-kunci ini saja sudah hampir menguras semangatnya. Belakangan, ia mengubah seluruh proyeknya agar terhubung ke OpenRouter, kodenya hanya perlu mengubah satu baris base_url, dan tiga layanan berubah menjadi satu. Artikel ini akan membahas langkah demi langkah bagaimana cara melalui jalur ini.

Apa itu OpenRouter

OpenRouter adalah sebuah "gateway agregasi model": Anda hanya butuh satu set API key dan satu endpoint (openrouter.ai/api/v1) untuk memanggil ratusan model di dalamnya. Pada akhir Juli 2026, saya sempat menguji API model miliknya, dan sistem mengembalikan 364 model dari 57 kreator model—70 model OpenAI, 48 model Qwen, 39 model Google, 26 model Anthropic, bahkan pabrikan model asal Tiongkok seperti MiniMax dan Moonshot pun ada di dalam daftarnya.

Poin paling krusial: penetapan harga inferensinya adalah "penjualan kembali harga asli", tidak ada kenaikan harga pada tarif model, keuntungan mereka berasal dari biaya penanganan pengisian ulang (5,5% untuk kartu kredit, 5% untuk mata uang kripto). Jadi Anda tidak perlu khawatir "memanggil lewat sini jadi lebih mahal", satu-satunya hal yang perlu dikhawatirkan adalah biaya penanganan saat melakukan top-up.

Apa yang Bisa Dilakukan

Bagi para developer, layanan ini menyelesaikan tiga hal: pertama, menghilangkan kerumitan mengelola banyak akun, cukup satu kunci untuk semuanya; kedua, failover otomatis, jika salah satu penyedia layanan down, sistem akan otomatis beralih ke cadangan; ketiga, biaya yang transparan, setiap respons langsung menyertakan berapa token dan berapa biaya yang dihabiskan kali ini, tanpa perlu melakukan rekonsiliasi setelahnya.

Karena API-nya sepenuhnya kompatibel dengan format OpenAI, program apa pun yang Anda tulis menggunakan SDK OpenAI dapat langsung digunakan hanya dengan mengubah base_url ke endpoint OpenRouter, dan model dari seri Claude maupun ChatGPT dapat langsung dipanggil.

Cara Menggunakan: 5 Langkah Mudah

  1. Registrasi dan Top-up: Kunjungi openrouter.ai untuk mendaftar, lalu lakukan top-up saldo terlebih dahulu. Ada ambang batas praktis di sini—jika total top-up mencapai 10 USD, kuota harian untuk model gratis akan melonjak dari 50 kali menjadi 1.000 kali. Disarankan untuk langsung mengisi 10 USD sejak awal.
  2. Membuat API Key: Buka halaman Keys untuk membuat kunci, Anda dapat menetapkan "batas kuota" untuk setiap kunci, sehingga side project Anda akan terputus otomatis jika melebihi anggaran. Saya sangat merekomendasikan fitur ini.
  3. Memilih Model: Kode model menggunakan format "kreator/nama-model", contohnya openai/gpt-5.1. Jika ingin menguji coba secara gratis, cari model yang berakhiran :free, saat ini ada 14 model.
  4. Mengirim Permintaan Pertama: Lakukan POST ke openrouter.ai/api/v1/chat/completions dengan menyertakan Bearer token; jika menggunakan Python, Anda bisa langsung mengambil SDK OpenAI dan mengganti base_url-nya.
  5. Melihat Penggunaan: Objek respons secara otomatis menyertakan objek penggunaan (usage), yang berisi jumlah token dan biaya aktual; dasbor situs web juga memungkinkan Anda melihat pengeluaran berdasarkan kunci atau model.

Keahlian Tingkat Lanjut

  • Pemilihan Model Otomatis: Gunakan openrouter/auto-beta agar sistem membantu Anda memilih model berdasarkan jenis tugas, dan Anda juga dapat menggunakan parameter cost_quality_tradeoff untuk menyesuaikan keseimbangan antara kualitas dan biaya (0 untuk prioritas kualitas, 10 untuk penghematan maksimal). Model openrouter/auto yang lama sudah tidak digunakan lagi (deprecated), jadi jangan ikuti tutorial lama.
  • Routing Penyedia Layanan: Tambahkan objek provider di dalam request Anda untuk menentukan urutan penyedia layanan, atau mengurutkannya berdasarkan harga maupun latensi; versi praktisnya adalah cukup menambahkan :nitro (untuk kecepatan) atau :floor (untuk harga termurah) di belakang kode model.
  • Kontrol Privasi: Atur data_collection: "deny" atau zdr: true untuk merutekan hanya ke endpoint yang tidak menyimpan data, yang sangat penting saat menangani data sensitif.
  • BYOK (Bring Your Own Key): Memiliki kuota korporat OpenAI atau Anthropic sendiri? Anda dapat memasukkan kunci Anda sendiri, di mana 1 juta permintaan pertama setiap bulannya bebas biaya penanganan, dan dikenakan 5% untuk seterusnya. Detail selengkapnya dapat dibaca bersama Panduan Manajemen Kunci API BYOK kami.

Hal yang Perlu Diperhatikan

Biaya penanganan top-up adalah satu-satunya "biaya tersembunyi", mulai dari 5%, dengan minimum 0,8 USD untuk kartu kredit. Sering melakukan top-up dalam jumlah kecil sangatlah merugikan, jadi disarankan untuk mengisi dalam jumlah cukup sekaligus. Selain itu, ketika saldo menjadi negatif, sistem akan memunculkan error 402 secara menyeluruh—bahkan model gratis pun tidak dapat digunakan, dan ini adalah kesalahan yang sering dialami banyak orang. Selain itu, presisi kuantisasi untuk model yang sama pada endpoint penyedia yang berbeda mungkin berbeda, yang dapat menyebabkan perbedaan kualitas output. Jika Anda peduli akan hal ini, gunakan parameter quantizations untuk menguncinya. Jika Anda lebih menyukai solusi gateway yang di-host sendiri (self-hosted), LiteLLM dan Portkey adalah alternatif lain, namun Anda harus menanggung sendiri biaya operasionalnya.

Kesimpulan dan Ulasan TheAI學院

Ulasan: Bagi para developer independen dan tim kecil di Taiwan, OpenRouter adalah pilihan dengan hambatan terendah saat ini untuk "integrasi multi-model"—hanya dengan mengubah satu baris base_url, Anda mendapatkan akses ke 364 model dan failover otomatis, anggap saja biaya penanganan top-up sebagai biaya perlindungan.

Saran saya pribadi: Isi saldo 10 USD terlebih dahulu untuk membuka kuota model gratis, gunakan model :free untuk menjalankan alur kerja hingga lancar, baru kemudian beralih ke model resmi. Tetapkan batas kuota untuk setiap kunci; kebiasaan ini cepat atau lambat akan menyelamatkan Anda dari masalah besar.

Pertanyaan yang Sering Diajukan

Apakah OpenRouter lebih mahal daripada menggunakan API resmi secara langsung?

Tarif inferensi dijual sesuai harga asli tanpa markup. Perbedaan biaya hanya terletak pada biaya pemrosesan pembayaran (kartu kredit 5,5%, minimum 0,8 USD; mata uang kripto 5%). Mengisi saldo dalam jumlah lebih besar sekaligus dapat mengurangi proporsi biaya tersebut.

Apakah OpenRouter memiliki model gratis?

Ya, model dengan akhiran :free semuanya gratis, saat ini tersedia sekitar 14 model. Batasannya adalah 20 permintaan per menit; setelah akumulasi pengisian saldo mencapai 10 USD, batas harian akan ditingkatkan dari 50 menjadi 1.000 kali.

Apakah program yang saya tulis menggunakan OpenAI SDK sebelumnya harus banyak diubah?

Hampir tidak perlu diubah. API OpenRouter sepenuhnya kompatibel dengan format OpenAI. Anda hanya perlu mengubah base_url menjadi https://openrouter.ai/api/v1 dan kunci API menjadi kunci OpenRouter.

Data perusahaan saya sensitif, apakah aman menggunakan OpenRouter?

Secara default, OpenRouter hanya mencatat metadata dan tidak merekam isi prompt. Anda dapat menyetel zdr:true dalam permintaan untuk merutekan hanya ke endpoint zero data retention (tanpa retensi data), atau menggunakan data_collection:'deny' untuk mengecualikan penyedia yang mengumpulkan data.

繁體中文版 →