WRouter

繁體中文

English

繁體中文

English

主題

快速上手 ​

只需 5 分鐘，即可完成從註冊到第一次成功呼叫。

1. 註冊賬號 ​

開啟 https://wrouter.ai/register，使用郵箱、GitHub、Google 任一方式註冊並登入。

新使用者首次註冊會贈送少量體驗額度，可直接試用。

2. 建立 API 金鑰 ​

  1. 登入 https://wrouter.ai/dashboard/overview
  2. 左側選單進入 API 金鑰 → 建立 API 金鑰
  3. 填寫：
    • 名稱：例如 dev-test
    • 分組：預設即可
    • 過期時間：永不 / 1 個月 / 1 天 / 1 小時
    • 無限配額：預設開啟；生產環境建議關閉並設定上限
  4. 點選 儲存更改，在列表中複製生成的 sk-... 金鑰

詳見 API 金鑰。

3. 充值（可選） ​

新使用者體驗額度耗盡前可跳過本步。

進入 錢包 → 充值，支援：

  • 銀行卡（信用卡 / 簽帳金融卡）
  • 穩定幣支付
  • 兌換碼

詳見 賬戶與計費。

4. 發起第一次呼叫 ​

將 OpenAI SDK 的 base_url 替換為 WRouter 即可：

curl ​

bash
curl https://wrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $WROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好，WRouter！"}]
  }'

Python (openai SDK) ​

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-...",                     # 你的 WRouter Token
    base_url="https://wrouter.ai/v1", # 注意末尾 /v1
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js (openai SDK) ​

js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.WROUTER_API_KEY,
  baseURL: "https://wrouter.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

5. 呼叫 Claude / Gemini ​

同一把 Token，把模型 ID 改一下就行：

python
# Claude（OpenAI 格式呼叫）
client.chat.completions.create(model="claude-sonnet-4-5", messages=[...])

# Gemini
client.chat.completions.create(model="gemini-2.5-pro", messages=[...])

或者使用原生協議：

  • Anthropic 原生：POST https://wrouter.ai/v1/messages — 參見 Messages API
  • Gemini 原生：POST https://wrouter.ai/v1beta/models/{model}:generateContent

6. 接入開發工具 ​

常見問題 ​

401 Unauthorized — Token 錯誤或未在請求頭中攜帶 Authorization: Bearer sk-...。

404 Model not found — 該模型未在當前分組中啟用，或模型 ID 寫錯。訪問 https://wrouter.ai/models 查詢可用模型 ID。

餘額不足 — 前往控制台充值或申請贈送額度。