wrouter

简体中文

English

简体中文

English

主题

快速上手 ​

只需 5 分钟，即可完成从注册到第一次成功调用。

1. 注册账号 ​

打开 https://wrouter.io/register，使用邮箱、GitHub、Google 任一方式注册并登录。

新用户首次注册会赠送少量体验额度，可直接试用。

2. 创建 API Token ​

  1. 登录 https://wrouter.io/console
  2. 左侧菜单进入 令牌 → 新建令牌
  3. 填写：
    • 名称：例如 dev-test
    • 额度：留空表示不限额；建议生产环境设置上限
    • 过期时间：可选
    • 可用分组：默认即可
  4. 点击 保存，复制生成的 sk-... 字符串妥善保存（页面关闭后无法再查看完整明文）

详见 API Token 管理。

3. 充值（可选） ​

新用户体验额度耗尽前可跳过本步。

进入 钱包 → 充值，支持：

  • 微信 / 支付宝
  • USDT (TRC20 / ERC20)
  • Stripe (信用卡)
  • 兑换码

详见 账户与计费。

4. 发起第一次调用 ​

将 OpenAI SDK 的 base_url 替换为 wrouter 即可：

curl ​

bash
curl https://api.wrouter.io/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://api.wrouter.io/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://api.wrouter.io/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://api.wrouter.io/v1/messages — 参见 Messages API
  • Gemini 原生：POST https://api.wrouter.io/v1beta/models/{model}:generateContent

6. 接入开发工具 ​

常见问题 ​

401 Unauthorized — Token 错误或未在请求头中携带 Authorization: Bearer sk-...。

404 Model not found — 该模型未在当前分组中启用，或模型 ID 写错。访问 https://wrouter.io/models 查询可用模型 ID。

余额不足 — 前往控制台充值或申请赠送额度。