Panduan Lengkap OpenRouter: Satu Kunci API untuk Akses 364 Model, Panduan Nilai Tambah, Haluan, dan Penjimatan
OpenRouter menggabungkan ratusan model AI dalam satu titik akhir tanpa caj tambahan untuk inferens. Artikel ini merangkumi pendaftaran dan tambah nilai, penciptaan kunci, panggilan API pertama, pemilihan model auto-beta, penghalaan pembekal, dan kaedah lanjutan BYOK, berserta perangkap biasa yang sering dielakkan oleh pembangun.
Pukul 1:00 pagi, seorang pembangun bebas di Taipei mengeluh sambil merenung skrinnya: projek sisinya perlu menyambungkan tiga model sekaligus — Claude untuk pengekodan, DeepSeek untuk tugasan kelompok yang murah, dan kadangkala ingin mencuba model sumber terbuka yang baru dikeluarkan. Tiga set kunci API, tiga papan pemuka pengebilan, tiga dokumentasi SDK; menguruskan kunci sahaja hampir melunturkan semangatnya. Kemudian, beliau menukar keseluruhan projeknya untuk menyambung ke OpenRouter, kod itu hanya menukar satu baris base_url, dan tiga perkhidmatan digabungkan menjadi satu. Artikel ini akan menerangkan langkah demi langkah cara melaluinya.
Apakah itu OpenRouter
OpenRouter ialah "gerbang agregasi model": anda hanya memerlukan satu set kunci API dan satu titik akhir (openrouter.ai/api/v1) untuk memanggil ratusan model di dalamnya. Pada lewat Julai 2026, saya benar-benar memanggil API modelnya sekali, dan ia mengembalikan 364 model daripada 57 pencipta model — 70 daripada OpenAI, 48 daripada Qwen, 39 daripada Google, 26 daripada Anthropic, malah kilang model China seperti MiniMax dan Moonshot turut disenaraikan.
Perkara yang paling penting: Harga inferensnya adalah "jualan semula harga asal", tanpa sebarang caj tambahan pada kadar model. Keuntungannyamemperoleh yuran pengendalian tambahnya (5.5% untuk kad kredit, 5% untuk mata wang kripto). Oleh itu, anda tidak perlu bimbang tentang "kos panggilan yang lebih tinggi melalui perkhidmatan ini", satu-satunya perkara yang perlu bimbang ialah yuran pengendalian semasa tambah nilai.
Apa yang Boleh Dilakukan
Bagi pembangun, ia menyelesaikan tiga perkara: Pertama, menghapuskan pengurusan berbilang akaun, satu kunci untuk semua; kedua, pematuhan ralat automatik, jika satu pembekal down, ia akan bertukar secara automatik kepada sandaran; ketiga, kebolehlihatan kos, setiap respons secara langsung dilampirkan dengan jumlah token yang digunakan dan kosnya, tanpa memerlukan penyelarasan selepas itu.
Oleh kerana API-nya serasi sepenuhnya dengan format OpenAI, sebarang program yang anda tulis menggunakan SDK OpenAI boleh menukar base_url kepada titik akhir OpenRouter untuk digunakan, dan kedua-dua siri model Claude atau ChatGPT boleh dipanggil secara terus.
Cara Penggunaan: Lima Langkah untuk Bermula
- Pendaftaran dan Tambah Nilai: Pergi ke
openrouter.aiuntuk mendaftar dan menambah nilai dahulu. Terdapat ambang praktikal di sini — apabila jumlah kumulatif tambah nilai mencapai 10 USD, kuota harian untuk model percuma akan melonjak daripada 50 kali kepada 1,000 kali. Adalah disyorkan untuk menambah nilai 10 USD pada mulanya. - Cipta Kunci API: Pergi ke halaman Kekunci untuk mencipta kunci, dan anda boleh menetapkan "had kuota" untuk setiap kunci. Projek sisi akan terputus sambungan secara automatik jika ia melebihi bajet, ciri ini amat saya cadangkan.
- Pilih Model: Kod model adalah dalam format "pencipta/nama model", contohnya
openai/gpt-5.1. Jika anda ingin menguji secara percuma, cari model yang diakhiri dengan:free, kini terdapat 14 model. - Hantar Permintaan Pertama: Buat permintaan POST ke
openrouter.ai/api/v1/chat/completions, bawa token Bearer; jika menggunakan Python, anda boleh terus mengambil SDK OpenAI dan menukarbase_url. - Semak Penggunaan: Respons disertakan dengan objek penggunaan secara lalai, termasuk bilangan token dan kos sebenar; papan pemuka tapak web juga boleh menyemak perbelanjaan mengikut kunci dan model.
Teknik Lanjutan
- Pemilihan Model Automatik: Gunakan
openrouter/auto-betauntuk membenarkan sistem membantu anda memilih model mengikut jenis tugasan, dan anda juga boleh menggunakan parametercost_quality_tradeoffuntuk melaraskan antara kualiti dan kos (0 untuk keutamaan kualiti, 10 untuk penjimatan kos maksimum). Modelopenrouter/autoyang lama telah ditamatkan, jadi jangan ikuti tutorial lama untuk menetapkannya. - Penghalaan Pembekal: Tambahkan objek
providerdalam permintaan untuk menentukan urutan pembekal, disusun mengikut harga atau latensi; versi pemalas adalah dengan menambah:nitro(untuk kelajuan) atau:floor(untuk harga rendah) di belakang kod model. - Kawalan Privasi: Tetapkan
data_collection: "deny"atauzdr: trueuntuk menghala hanya ke titik akhir yang tidak menyimpan data, yang sangat penting apabila memproses data sensitif. - BYOK: Adakah anda mempunyai kuota korporat OpenAI atau Anthropic sendiri? Anda boleh menyambungkan kunci anda sendiri, dan 1 juta permintaan pertama setiap bulan adalah percuma daripada yuran pengendalian, selepas itu 5% akan dikenakan. Butiran boleh dirujuk bersama Panduan Pengurusan Kunci API BYOK kami.
Langkah Perhatian
Yuran pengendalian tambah nilai adalah satu-satunya "kos tersembunyi", bermula dari 5%, dan caj minimum untuk kad kredit ialah 0.8 USD. Tambah nilai kecil dan kerap adalah merugikan, jadi adalah disyorkan untuk menambah nilai sepenuhnya sekali gus. Di samping itu, apabila baki menjadi negatif, ia akan mengembalikan ralat 402 sepenuhnya — malah model percuma tidak boleh digunakan, yang merupakan perangkap yang dipijak oleh ramai orang. Di samping itu, ketepatan pengkuantisan model yang sama pada titik akhir pembekal yang berbeza mungkin berbeza, dan kualiti output mungkin berbeza. Jika anda mengambil berat mengenainya, gunakan parameter quantizations untuk menguncinya. Jika anda lebih suka penyelesaian gerbang buatan sendiri, LiteLLM dan Portkey adalah pilihan lain, tetapi kos penyelenggaraan perlu ditanggung sendiri.
Kesimpulan dan Ulasan TheAI學院
Ulasan: Bagi pembangun bebas dan pasukan kecil di Taiwan, OpenRouter ialah pilihan dengan geseran "akses berbilang model" yang paling rendah pada masa ini — satu baris
base_urldigantikan dengan 364 model dan pematuhan ralat automatik, dan yuran pengendalian tambah nilai dianggap sebagai bayaran perlindungan.
Cadangan saya sendiri: Tambah nilai 10 USD terlebih dahulu untuk membuka kunci kuota model percuma, gunakan model :free untuk menjalankan aliran kerja, dan kemudian beralih kepada model rasmi. Tetapkan had kuota untuk setiap kunci, tabiat ini cepat atau lambat akan menyelamatkan anda sekali.
Soalan Lazim
Adakah OpenRouter lebih mahal daripada menggunakan API rasmi secara terus?
Kadar inferens dijual pada harga asal tanpa kenaikan. Perbezaan kos hanya terletak pada yuran pengendalian tambah nilai (kad kredit 5.5%, minimum USD 0.8; mata wang kripto 5%). Tambah nilai dalam jumlah yang lebih besar boleh mengurangkan purata yuran pengendalian.
Adakah OpenRouter menawarkan model percuma?
Ya, model dengan kod akhiran :free adalah percuma, kini sekitar 14 model. Hadnya adalah 20 permintaan seminit; selepas jumlah tambah nilai terkumpul mencapai USD 10, had harian ditingkatkan daripada 50 kepada 1,000 kali.
Adakah saya perlu mengubah banyak kod yang ditulis menggunakan SDK OpenAI asal?
Hampir tiada perubahan diperlukan. API OpenRouter serasi sepenuhnya dengan format OpenAI. Anda hanya perlu menukar base_url kepada https://openrouter.ai/api/v1 dan kunci kepada kunci OpenRouter untuk mula menggunakannya.
Adakah selamat menggunakan OpenRouter untuk data syarikat yang sensitif?
Secara lalai, OpenRouter hanya merekodkan metadata dan tidak merekodkan kandungan gesaan (prompt). Anda boleh menetapkan zdr:true dalam permintaan untuk menghala ke titik akhir pengekalan sifar data sahaja, atau menggunakan data_collection:'deny' untuk mengecualikan pembekal yang mengumpul data.