OpenRouter API Key 教學

OpenRouter API 金鑰怎麼取得?免費模型怎麼用?

建立 OpenRouter API 金鑰(API key),看懂免費模型的限額,解決 401、402、429 錯誤,並在 iPhone、Android 或網頁上使用 OpenRouter。

更新於
  • 取得 OpenRouter API 金鑰:登入 openrouter.ai,打開 openrouter.ai/keys 建立金鑰,金鑰以「sk-or-v1-」開頭。建立金鑰免費;模型 ID 以「:free」結尾的模型可以在每日限額內免費使用,其他模型都從預付的 credits 扣款。
  • OpenRouter 讓你用一個帳戶、一把金鑰,使用多家 AI 公司的模型。它沒有推出自己的 iPhone 或 Android 聊天 App,所以在手機上要用一個接受 OpenRouter 金鑰的聊天 App,例如 Oriveo。
  • 截至 2026 年 11 月 18 日,免費模型每分鐘可發 20 次請求、每天 50 次;累計購買至少 10 credits 後,每天可達 1,000 次。錯誤 402 代表 credits 用完了。
iPhone 上的 Oriveo:供應商頁面,列出你已連接的供應商和本月花費。

OpenRouter 是什麼?API 金鑰又是什麼?

OpenRouter 是一項服務,讓你用一個帳戶使用多家 AI 公司的模型。不必一家一家註冊,只要在 OpenRouter 儲值一次 credits(預付點數),就能從它的清單裡挑模型。

API 金鑰(API key)是 App 用你的帳戶發出請求時使用的祕密代碼。OpenRouter 會檢查金鑰,把訊息送到你選的模型,再從你的 OpenRouter credits 扣除費用。

OpenRouter 是為 App 和開發者打造的,沒有推出自己的 iPhone 或 Android 聊天 App,這也是很多人搜尋「OpenRouter App」的原因。他們真正需要的,是一個接受 OpenRouter 金鑰的聊天 App。

OpenRouter API 金鑰怎麼申請?

在 OpenRouter 網站上,兩三分鐘就能完成。

  • 前往 openrouter.ai 註冊帳戶,或直接登入。
  • 打開金鑰頁面 openrouter.ai/keys,建立一把新金鑰,用你要使用它的 App 或裝置來命名。
  • 複製金鑰。OpenRouter 的金鑰以「sk-or-v1-」開頭,長度是 73 個字元,請確認整串都有複製到。
  • 想用非免費的模型,就到 Credits 頁面儲值 credits。
  • 把金鑰存在安全的地方,例如密碼管理器。萬一外洩,就到金鑰頁面刪除,再建一把新的。

OpenRouter API 免費嗎?

部分免費。註冊帳戶和建立金鑰都不用錢,OpenRouter 也提供模型 ID 以「:free」結尾的免費模型;其他模型都要從預付的 credits 扣款。OpenRouter 也表示新使用者會拿到少量免費 credits,但沒有說是多少。

免費模型有使用限制。以下是截至 2026 年 11 月 18 日 OpenRouter 公布的限額:

  • OpenRouter 表示,如果餘額變成負數,連免費模型都可能回傳錯誤。
  • 目前哪些模型有「:free」版本,以 OpenRouter 網站上顯示的為準;要依賴某個模型之前,先去確認一下。
OpenRouter API 免費嗎?
你的帳戶免費模型每分鐘請求數免費模型每日請求數
累計購買不到 10 credits2050
累計購買至少 10 credits201,000

OpenRouter 的 credits 怎麼運作?

OpenRouter 採預付制。你在 Credits 頁面用信用卡或頁面上列出的其他付款方式購買 credits,每次請求都從中扣除。截至 2026 年 11 月 18 日,OpenRouter 的服務條款規定每次購買至少 $5、另收付款手續費,並註明未使用的 credits 可能在購買 365 天後到期。最新細節請見 openrouter.ai/terms。

每個模型都有自己的 token 單價,標在 OpenRouter 上該模型的頁面。價格會變動,所以這裡不抄錄。Oriveo 會在每則回覆上顯示預估費用;最終以 OpenRouter 的 Activity 與帳單頁面為準。

怎麼在 iPhone、Android 或網頁上使用 OpenRouter?

OpenRouter 沒有官方手機 App,所以你要選一個用戶端 App。在 Oriveo 裡,OpenRouter 是 15 家內建供應商之一,列在「聚合平台」底下,不用輸入任何網址。

  • 打開「供應商」:iPhone 和 Android 上是一個分頁,網頁版在側欄。
  • 點「+」按鈕(新增供應商),選擇 OpenRouter。點「聚合平台」標籤可以縮小清單範圍。
  • 在「連接 OpenRouter」下方貼上金鑰,點「繼續」。
  • 等待「正在驗證連接和同步模型...」(Android 顯示「正在驗證連線並同步模型…」),Oriveo 會載入 OpenRouter 的模型清單。
  • 選一個模型開始聊天。還沒儲值 credits 的話,就選模型 ID 以「:free」結尾的模型。
Oriveo 首頁,有訊息輸入框,下方顯示目前選用的模型,以及今天的對話與各自的費用
連接金鑰後,在訊息輸入框下方選擇模型。清單裡每段對話都會顯示預估費用。

我的 OpenRouter 金鑰存在哪裡?

在 iPhone 和 Android 上,請求從你的裝置直接送到供應商,金鑰存放在手機的安全儲存區(iPhone 是鑰匙圈 Keychain,Android 是 Keystore)。網頁版的請求會經過 Oriveo 伺服器上的即時轉送端點:金鑰只用於該次請求,不會存成帳戶紀錄,BYOK(自備金鑰)對話也不會被存成聊天紀錄。金鑰不會隨雲端同步上傳。想在第二台裝置上使用 OpenRouter,請在那台裝置上也貼上金鑰,或替它另建一把。

你按 OpenRouter 的價格直接付費給 OpenRouter,Oriveo 不加價。

OpenRouter API 金鑰為什麼不能用?

OpenRouter 的錯誤說明頁(openrouter.ai/docs/api-reference/errors)列出了每個代碼的意思。截至 2026 年 11 月 18 日,常見的有這些:

  • 在 Oriveo 裡,402 會顯示為「供應商額度已用完」;429 在網頁版顯示為「頻率限制」,在 iPhone 和 Android 上顯示為「供應商請求頻率受限」。
  • 清單裡少了某個模型:重新同步模型清單,並確認 OpenRouter 目前仍提供這個模型。
OpenRouter API 金鑰為什麼不能用?
錯誤代表什麼怎麼處理
401 Invalid credentials金鑰錯誤、已停用或已刪除重新複製完整金鑰,或建立一把新的
401「this is not an OpenRouter API key」你貼的是別家供應商的金鑰改用在 openrouter.ai/keys 建立的金鑰,它以 sk-or-v1- 開頭
402 insufficient credits帳戶或這把金鑰的 credits 不夠了儲值 credits,或調高這把金鑰的上限;光等沒有用
403 Forbidden被權限、內容審核、防護規則(guardrail)或預算上限擋下檢查金鑰的設定和上限,或修改你的訊息
429 rate limited請求太多,可能是 OpenRouter 或模型背後的供應商在限流等一下再試;用免費模型時,對照上面的限額
502 或 503模型或它背後的供應商暫時無法使用稍後再試,或換一個模型

用 OpenRouter,還是向各家供應商分別申請金鑰?

想用一把金鑰、一份餘額使用很多模型時,OpenRouter 很方便。想要某家供應商自己的帳戶和帳單時,直接向 OpenAI 或 Anthropic 這類供應商申請的金鑰比較適合。Oriveo 兩種都接受,你可以讓 OpenRouter 和直連金鑰並存,在同一段對話裡依序切換模型。

App 常見問題

OpenRouter 可以免費使用嗎?
部分可以。金鑰免費,模型 ID 以「:free」結尾的模型在每日限額內不用錢:截至 2026 年 11 月 18 日,每天 50 次請求,累計購買至少 10 credits 後為每天 1,000 次。其他模型需要預付 credits。
OpenRouter API 金鑰在哪裡申請?
登入後到 openrouter.ai/keys。建立金鑰、取個名字,再把整串複製下來;金鑰以「sk-or-v1-」開頭。
OpenRouter 有 iPhone 或 Android App 嗎?
OpenRouter 沒有推出自己的手機聊天 App。請用一個接受 OpenRouter 金鑰的聊天 App:在 Oriveo 打開「供應商」,點「+」,選 OpenRouter,貼上金鑰再點「繼續」。
OpenRouter 錯誤 402 是什麼意思?
你的帳戶或正在使用的金鑰 credits 不足。到 OpenRouter 儲值 credits;如果你替金鑰設過上限,就調高上限,然後再試一次。它不會自己恢復。
OpenRouter API 金鑰為什麼不能用?
先看錯誤代碼。401 代表金鑰錯誤,或那不是 OpenRouter 的金鑰;402 代表沒有 credits;429 代表請求太多,或碰到免費模型的限額。我們的 API 金鑰錯誤排解指南逐一說明了每個代碼。
OpenRouter API 金鑰長什麼樣子?
以「sk-or-v1-」開頭,後面接 64 個英文字母和數字,總共 73 個字元。如果你的比較短,就是有一部分沒複製到。

延伸閱讀

來自部落格

在手機上使用你的 OpenRouter 金鑰

打開網頁版,或下載 iPhone、Android 版 Oriveo,貼上 OpenRouter 金鑰,在模型之間切換,每則回覆都看得到預估費用。

還沒有 API 金鑰?先用 Oriveo Free 免費開始也可以。