OpenRouter Buong Gabay: Isang API key para sa 364 na modelo, top-up, routing, at tips sa pagtitipid

Alas kuwento ng madaling-araw, isang independyenteng developer sa Taipei ang napabuntong-hininga habang nakatitig sa kanyang screen: ang kanyang side project ay kailangang kumonekta sa tatlong modelo nang sabay-sabay—Claude para sa pag-code, DeepSeek para sa murang batch tasks, at paminsan-minsang pagsubok sa mga bagong lumabas na open-source model. Mayroon siyang tatlong API keys, tatlong billing dashboards, at tatlong magkakaibang dokumentasyon ng SDK. Ang simpleng pamamahala pa lamang sa mga susi ay halos pumatay na sa kanyang hilig. Nang maglaon, binago niya ang buong proyekto para kumonekta sa OpenRouter, binago lang ang base_url sa isang linya ng code, at naging iisa na ang tatlo. Ipapaliwanag ng artikulong ito ang prosesong ito nang sunud-sunod.

Ano ang OpenRouter

Ang OpenRouter ay isang "model aggregation gateway": kailangan mo lang ng isang set ng API key at isang endpoint (openrouter.ai/api/v1) para ma-call ang daan-daang mga modelo rito. Noong huling bahagi ng Hulyo 2026, sinubukan ko ang kanilang models API at nagbalik ito ng 364 na modelo mula sa 57 na tagalikha ng modelo—70 mula sa OpenAI, 48 mula sa Qwen, 39 mula sa Google, 26 mula sa Anthropic, at maging ang mga kumpanya ng modelong Tsino tulad ng MiniMax at Moonshot ay kasama rin.

Ang pinakamahalagang punto: Ang kanilang pagpepresyo sa inference ay "reselling at original price," walang dagdag-singil sa mga rate ng modelo. Kumikita sila sa pamamagitan ng mga bayarin sa top-up (5.5% para sa mga credit card, 5% para sa cryptocurrency). Kaya hindi mo kailangang mag-alala na "mas mahal kapag dumaan dito," ang tanging dapat mong alalahanin ay ang bayarin sa top-up.

Ano ang Kaya Nitong Gawin

Para sa mga developer, nalulutas nito ang tatlong bagay: Una, inaalis nito ang pamamahala ng maramihang account, isang key lang ay sapat na; ikalawa, awtomatikong failover, kung sakaling bumagsak ang isang supplier, awtomatiko itong lilipat sa backup; ikatlo, nakikitang gastos, ang bawat tugon ay direktang may kasamang impormasyon kung gaano karaming token at magkano ang nagastos sa pagkakataong iyon, nang hindi na kailangang mag-reconcile pagkatapos.

Dahil ang kanilang API ay ganap na katugma sa format ng OpenAI, anumang programa sa iyong mga kamay na isinulat gamit ang OpenAI SDK ay maaaring gumana sa pamamagitan lamang ng pagpapalit ng base_url patungo sa endpoint ng OpenRouter. Ang mga seryeng modelo ng Claude o ChatGPT ay direktang matatawag.

Paano Gamitin: Limang Hakbang para Magsimula

1. Mag-register at mag-top up: Pumunta sa openrouter.ai para mag-register at mag-top up muna. May praktikal na limitasyon dito—kapag naabot ng iyong kabuuang top-up ang $10 USD, ang pang-araw-araw na limitasyon para sa mga libreng modelo ay tataas mula 50 beses hanggang 1,000 beses. Inirerekomenda na mag-top up kaagad ng $10 sa simula.
2. Gumawa ng API key: Pumunta sa pahina ng Keys upang gumawa ng isang key. Maaari kang magtakda ng "spending limit" para sa bawat key. Kung lumagpas sa badyet ang iyong side project, awtomatiko itong mapuputol. Talagangirekomenda ko ang feature na ito.
3. Pumili ng modelo: Ang codename ng modelo ay nasa format na "author/model-name", halimbawa ay openai/gpt-5.1. Kung nais mong subukan nang libre, hanapin ang mga modelong nagtatapos sa :free. Sa kasalukuyan, mayroong 14 na ganito.
4. Ipadala ang iyong unang kahilingan: Magpadala ng POST sa openrouter.ai/api/v1/chat/completions, kasama ang Bearer token. Kung gumagamit ka ng Python, maaari mong direktang kunin ang OpenAI SDK at baguhin ang base_url.
5. Suriin ang paggamit: Ang tugon ay may kasamang usage object, na naglalaman ng bilang ng mga token at aktwal na gastos. Ang website dashboard ay maaari ring magpakita ng mga gastos ayon sa key at ayon sa modelo.

Mga Advanced na Trick

• Awtomatikong pagpili ng modelo: Gamitin ang openrouter/auto-beta upang hayaan ang sistema na tulungan kang pumili ng modelo batay sa uri ng gawain. Maaari mo ring gamitin ang parameter na cost_quality_tradeoff upang ayusin sa pagitan ng kalidad at gastos (0 para sa pinakamataas na kalidad, 10 para sa pinakamipid). Ang lumang openrouter/auto ay luma na (deprecated), huwag nang sundin ang mga lumang tutorial sa pag-set up nito.
• Pagruruta ng supplier: Magdagdag ng provider object sa kahilingan upang tukuyin ang pagkakasunud-sunod ng supplier, pag-uuri ayon sa presyo o latency; ang bersyon para sa mga tamad ay ang pagdaragdag ng :nitro (para sa bilis) o :floor (para sa mababang presyo) pagkatapos ng codename ng modelo.
• Kontrol sa privacy: Magtakda ng data_collection: "deny" o zdr: true upang i-ruta lamang sa mga endpoint na hindi nag-iimbak ng data. Napakahalaga nito kapag humahawak ng sensitibong data.
• BYOK: Mayroon ka bang sariling badyet sa negosyo mula sa OpenAI o Anthropic? Maaari mong i-link ang iyong sariling key, at ang unang 1 milyong kahilingan bawat buwan ay walang bayad sa transaksyon, pagkatapos noon ay sisingilin ito ng 5%. Ang mga detalye ay maaaring isabay sa ating Gabay sa Pamamahala ng BYOK API Key.

Mga Pag-iingat

Ang bayarin sa top-up ay ang tanging "nakatagong gastos," na nagsisimula sa 5% na may pinakamababang bayarin sa credit card na $0.8 USD. Ang madalas at maliit na pag-top up ay lugi, kaya inirerekomenda na i-top up ito nang buo nang sabay-sabay. Bilang karagdagan, kapag ang iyong balanse ay naging negatibo, magbabalik ito ng pangkalahatang error na 402—kahit ang mga libreng modelo ay hindi magagamit. Maraming tao ang nakakaranas ng isyung ito. Bukod dito, ang katumpakan ng quantization ng parehong modelo sa iba't ibang mga endpoint ng supplier ay maaaring mag-iba, na nagiging sanhi ng mga pagkakaiba sa kalidad ng output. Kung mahalaga ito sa iyo, gamitin ang parameter na quantizations upang i-lock ito. Kung mas gusto mo ang isang self-hosted gateway solution, ang LiteLLM at Portkey ay iba pang mga opsyon, ngunit kailangan mong pasanin ang mga gastos sa pagpapatakbo (operations).

Konklusyon at Puna ng TheAI學院

Puna: Para sa mga independyenteng developer at maliliit na koponan sa Taiwan, ang OpenRouter ay kasalukuyang pinakamababang alitan na pagpipilian para sa "multi-model integration"—isang linya ng base_url kapalit ng 364 na modelo at awtomatikong failover. Ituring na lang ang bayarin sa top-up bilang bayad sa proteksyon.

Ang sarili kong payo: Mag-top up muna ng $10 para ma-unlock ang limitasyon ng libreng modelo, gamitin ang :free na modelo para mapatakbo ang proseso, at pagkatapos ay lumipat sa mga opisyal na modelo. Magtakda ng spending limit sa bawat key; ang ugali na ito ay ililigtas ka balang araw.