注册前的环境检查

  • 浏览器能稳定访问 openrouter.ai（建议先测一下，国内不稳就配网络）
  • 准备充值方式：海外信用卡 / Crypto 钱包二选一
  • 已有 OpenAI SDK / Anthropic SDK 项目（OpenRouter 完全兼容前者）

注册 + 充值 + 拿 key

先注册账号。打开 openrouter.ai，用 Google 或 GitHub 登录，完成邮箱验证。

注册后充值。信用卡路径：Dashboard → Credits → Add Credits，输入金额（最低 $5），绑 Visa / MC / Amex。Crypto 路径：Dashboard → Credits → Crypto，选 USDC / USDT / ETH，扫码转账。第一次充 $5-10 测试就够了，跑通后再大额充。

最后创建 API Key。

Dashboard → Keys → Create Key → 设置：

  • Name：标识用途（如 prod-saas-main）
  • Credit Limit：可选月预算上限（建议必填）
  • Models：可选限制只能调哪些模型

复制生成的 sk-or-v1-xxx，立刻存到 1Password / Bitwarden。

SDK 集成（OpenAI 兼容协议）

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-v1-xxx",
)

resp = client.chat.completions.create(
    model="anthropic/claude-3-5-sonnet",
    messages=[{"role": "user", "content": "Hi"}],
    extra_headers={
        "HTTP-Referer": "https://yourapp.com",  # 可选，统计来源
        "X-Title": "Your App Name",
    },
)
print(resp.choices[0].message.content)

Anthropic SDK 用法类似——把 base_url 改成 https://openrouter.ai/api/v1。

多模型路由策略

A. 静态主备

resp = client.chat.completions.create(
    model="anthropic/claude-3-5-sonnet",
    extra_body={
        "models": [
            "anthropic/claude-3-5-sonnet",
            "openai/gpt-4o",
            "google/gemini-2.5-flash",
        ],
    },
    messages=[...],
)

主模型失败 / 限速自动 fallback。

B. 按任务类型动态路由

def pick_model(task):
    if task == "code":
        return "anthropic/claude-3-5-sonnet"
    if task == "summary":
        return "google/gemini-2.5-flash"
    if task == "chinese":
        return "deepseek/deepseek-chat"
    return "openai/gpt-4o-mini"

便宜任务路由到便宜模型，重要任务路由到强模型，月 token 成本下降 30-60%。

C. 自动 Provider 选择

extra_body={"route": "fallback"}

OpenRouter 在多个 provider 间自动选最便宜 + 最快的，适合不挑剔 provider 的场景。

常见失败原因

  • 401：key 错或被禁
  • 402：Credit 用光，去充值
  • 429：被限速，加退避
  • 5xx：上游 provider 抖动，配 fallback 自动切

用量监控

import requests

r = requests.get(
    "https://openrouter.ai/api/v1/key",
    headers={"Authorization": "Bearer sk-or-v1-xxx"},
)
print(r.json())  # 含 limit, usage, label 等

定时跑这个查询 + 写入自己数据库，做用量 dashboard。

上线后安全设置

  1. 关闭 Provider data sharing（Settings → Privacy）
  2. 给每个环境（dev / staging / prod）独立 key
  3. 设置每个 key 的 monthly credit limit
  4. 启用 2FA
  5. webhook 配置：余额低于 X 自动告警

跨地区使用 / 旅行

OpenRouter 域名国内连接不稳——本地开发可能没事，部署到国内云服务器或在国内出差调用就会撞墙。建议把Cursor / Claude Code 国内可用的 API 中转配进 OneAPI 做 OpenRouter 的备线，OpenRouter 抖动时自动 fallback 到中转，应用对外服务不中断。

落地条件

OpenRouter 独立 SaaS最怕把法律主体、收款工具和产品代码混成一个问题。动手前看清税务资料、部署环境和客服成本，金额较大或涉及税务时应交给专业顾问处理。

一个人运营时可以用表格压住复杂度：负责人、后台入口、到期日、费用来源和回滚动作各占一列，避免换服务商时才发现资料缺口。

相关阅读