【n8n系列|初稿】 06. 申請 OpenRouter 並測試 API Key

OpenRouter 是一個 LLM API 的統一轉發平台。開發者只需申請一組 API Key，就能透過與 OpenAI 相容的介面，呼叫多家供應商的模型（例如 OpenAI、Anthropic、Google、Meta），不必為每一家各申請帳號與金鑰。請求會由 OpenRouter 轉送到對應供應商，用量與費用也集中在同一個帳號管理。

對學習與開發 n8n 特別方便的是，平台提供免費額度，以及一批標記為免費的模型（名稱通常帶有 :free）。若不指定特定免費模型，也可以使用 openrouter/free，讓平台自動挑選目前可用的免費模型。這樣在串接 AI Agent、Chat Model 時，能先用接近零成本的方式驗證流程，確認無誤後再視需求換成付費模型。這是繼 02. 使用 Google Agent Stdio 取得 LLM Keys 之後，另一條取得大語言模型的路徑。

本章會從申請帳號、取得 API Key、搜尋合適模型，到用 cURL 測試金鑰是否可用，完成後續在 n8n 把 OpenRouter 當成 LLM Provider 的準備工作。

1. 連上 OpenRouter 官方頁面申請帳號

第 1/11 步：連上 OpenRouter 網站，進行註冊

OpenRouter 平台頁面

第 2/11 步：點擊 Sign Up

點擊 Sign Up

① 點擊 Sign Up 按鈕，打開註冊對話視窗。

第 3/11 步：輸入基本資訊

輸入基本資訊

② Email address 設定登入帳號。
③ Password 設定登入密碼。
④ 勾選同意使用條款。
⑤ 點擊 Continue。

第 4/11 步：確認登入信箱是否正確

確認信箱

⑥ 確認信箱是否正確，可以在此修改收發啟用信的信箱。

第 5/11 步：到信箱內搜尋啟用信

搜尋啟用信

⑦ 搜尋 OpenRouter 或是主旨為 Your sign up link ... 等資訊。

第 6/11 步：點擊信件內的啟用按鈕

點擊啟用按鈕

⑧ 點擊 Sign up to OpenRouter 進行帳號驗證。

第 7/11 步：驗證完成，設定使用者基本資訊

設定使用者基本資訊

⑨ 選擇 Individual 區塊。
⑩ 點擊 Next 按鈕。

第 8/11 步：記錄 API Key

記錄 API Key

⑪ 使用最右側的複製按鈕，記錄 Your API Key 的值。完整金鑰在關掉視窗後就無法再複製，請立刻另存於自己的電腦上。
⑫ 點擊 Continue 按鈕。

第 9/11 步：跳過綁定信用卡步驟

跳過綁定信用卡步驟

⑬ 點擊 I'll do this later 跳過綁定信用卡步驟。

第 10/11 步：調查表單

完成問卷調查

⑭ 選擇適合的選項。
⑮ 點擊 Continue。

第 11/11 步：完成

完成

⑯ 點擊 Go to Dashboard 完成註冊。

2. 如果忘記 API Key 或者需要新增時

當 API Key 無法連線或是忘記時，完整金鑰無法再查看，只能刪除舊的並新增一把。

API Keys 選單

① 從側欄選擇 API Keys 選項。
② 點擊 + New Key 可以進行新增。
③ 下方列表只能確認有哪些 Key 還在生效（名稱與遮罩），無法再複製完整字串。

3. 若需要尋找特定功能的模型

若需要尋找特定功能的模型，可以透過下述方式進行篩選與查看。

模型選擇畫面

① 標題列選擇 Models。
② 搜尋欄位可以輸入關鍵字進行搜尋。搜尋欄輸入 :free 可篩出免費模型。
③ 符合條件的模型會在下方搜尋結果區域呈現。

4. 透過 cURL 測試 API Key

4.1 Bash 版本

1
2
3
4
5
6
7
8
9
10
11
12

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -d '{
  "model": "openrouter/free",
  "messages": [
    {
      "role": "user",
      "content": "How many times does the letter r appear in strawberry?"
    }
  ]
}'

$OPENROUTER_API_KEY 要替換成自己的 API Key。

4.2 Windows PowerShell 版本

1
2
3
4
5
6
7
8
9
10
11

curl.exe https://openrouter.ai/api/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $env:OPENROUTER_API_KEY" -d @'
{
  "model": "openrouter/free",
  "messages": [
    {
      "role": "user",
      "content": "How many times does the letter r appear in strawberry?"
    }
  ]
}
'@

$env:OPENROUTER_API_KEY 要替換成自己的 API Key。PowerShell 必須使用 curl.exe，直接打 curl 會變成 Invoke-WebRequest，無法沿用上述參數。

4.3 如何判斷測試是否成功

成功時 HTTP 狀態為 200，回應會包含 choices；模型回覆在 choices[0].message.content。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "id": "gen-xxxxxxxx",
  "model": "meta-llama/llama-3.3-70b-instruct:free",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "The letter r appears 3 times in the word strawberry."
      },
      "finish_reason": "stop"
    }
  ]
}

失敗時請看 HTTP 狀態碼與 error.message：

1
2
3
4
5
6

{
  "error": {
    "code": 401,
    "message": "Missing Authentication header"
  }
}

1
2
3
4
5
6

{
  "error": {
    "code": 402,
    "message": "Insufficient credits. Add more using https://openrouter.ai/credits"
  }
}