openrouter的使用

本文最后更新于 2026年2月20日 下午

本文主要根据大模型聚合平台OpenRouter的官方文档摘取了其使用方法。

openrouter

概述

  • OpenRouter 是全球规模最大、最知名的 AI 模型 API 聚合平台之一，在模型数量、用户规模和生态完整性方面处于行业领先地位。
  • OpenRouter 提供统一的 API，让您通过单一接口访问数百个 AI 模型。

使用

  1. 首先，创建一个账户并充值。 积分是您存入 OpenRouter 的资金，用于 LLM 推理。当您使用 API 或聊天界面时，我们会从您的积分中扣除请求费用。每个模型和提供商的每百万代币价格都不同。
  2. 获得积分后，您可以使用聊天室，也可以创建 API 密钥并开始使用 API。您可以阅读我们的快速入门指南或企业指南，其中包含代码示例等更多信息。

充值

您可以通过支付宝或微信为OpenRouter账户充值，具体步骤如下：

  1. 登录账户：首先，访问OpenRouter官方网站并登录您的账户。
  2. 访问余额页面：在页面右上角找到个人头像，悬停后选择“Credits”选项，或者直接访问 余额页面 来查看当前账户余额。
  3. 添加充值金额：点击“Add Credits”按钮。如果您尚未绑定支付方式，系统会提示您添加支付方法。在此界面，勾选“Use checkout page”选项。
  4. 选择支付方式：在生成的支付链接中，您将看到支付宝和微信的支付选项。选择您希望使用的支付方式。
  5. 完成支付：点击“Get Payment Link”按钮，稍等片刻，按钮将变为“Buy Credits”。点击“Buy Credits”后，系统将跳转至支付网关页面，您可以在此完成支付。

注意事项

  • 账户余额: 如果您的账户余额低于10美元，您将无法使用免费的模型调用。
  • 充值金额: 充值金额会在扣除相关交易费用后计入账户，确保您了解费用结构。
  • 积分有效期: 目前OpenRouter没有设置积分过期时限，但保留一年后过期的权利。

指定特定的 Provider（供应商）

OpenRouter Provider 路由机制

OpenRouter 允许通过 API 请求参数来指定特定的 Provider（供应商）。核心参数如下：

参数 说明 示例
provider.order 指定 Provider 优先级列表 ["Anthropic", "OpenAI"]
provider.allow_fallbacks 是否允许回退到其他 Provider true / false
provider.require_parameters 是否要求特定参数 true / false

解决方案

使用模型名称后缀指定（部分有效）

某些情况下，OpenRouter 允许在模型名称中指定 Provider：

1
2
3
4
# 格式：provider/model-name
anthropic/claude-3.5-sonnet
openai/gpt-4o
google/gemini-pro-1.5

在 open-webui 中配置：

  1. 进入 设置 → 连接 → OpenAI API

  2. 填入 OpenRouter 配置：

    1
    2
    API Base URL: https://openrouter.ai/api/v1
    API Key: 您的 OpenRouter API Key

  3. 添加模型时使用完整模型路径：

    1
    anthropic/claude-3.5-sonnet

局限性：这只能指定模型，不能指定同一模型的多个 Provider 中的某一个。

使用 OpenRouter 的模型特定 ID

OpenRouter 上同一模型的不同 Provider 有时会有不同的模型 ID：

  1. 访问 OpenRouter 模型页面
  2. 查找目标模型
    • 搜索您需要的模型（如 claude-3.5-sonnet）
  3. 查看可用 Provider
    • 点击模型，查看不同 Provider 的价格和可用性
  4. 使用特定 Provider 的模型 ID
    • 某些 Provider 会有独特的模型 ID 后缀

示例：

1
2
3
# 同一模型的不同 Provider 可能有不同 ID
anthropic/claude-3.5-sonnet        # 默认路由
anthropic/claude-3.5-sonnet:beta   # 特定版本

通过 OpenRouter 网页设置默认 Provider

OpenRouter 允许在网页端设置某些模型的默认 Provider 偏好：

  1. 登录 OpenRouter 账号
  2. 查找 Provider 偏好设置
    • 部分模型可以设置首选 Provider
  3. 保存设置
    • 这样所有通过您的 API Key 的请求都会优先使用设定的 Provider

相关信息

模型变体

变体是可以添加到模型别名中的后缀，以改变其行为。

静态变体只能与特定模型一起使用，这些模型列在我们的模型 API 中。

  • :free - 该模型始终免费提供，且速率限制低。了解更多。
  • :extended - 该模型具有比通常更长的上下文长度。了解更多。
  • :exacto - 该模型仅使用 OpenRouter 精选的高质量端点。了解更多。
  • :thinking - 该模型默认支持推理。了解更多。

动态变体可用于所有模型，它们会改变请求的路由或使用方式。

  • :online - 所有请求都会运行查询以提取附加到提示符的网页结果。了解更多。
  • :nitro - 服务提供商将按吞吐量排序，而非默认排序方式，从而优化响应速度。了解更多。
  • :floor - 供应商将按价格排序，而非默认排序方式，优先显示最具性价比的选项。了解更多。

使用方法，示例：在任何模型 ID 后添加 :free ：

1
2
3
{
  "model": "meta-llama/llama-3.2-3b-instruct:free"
}

如果某个提供商不可用，模型回退机制是如何运作的？

如果某个路由提供商返回错误，OpenRouter 会自动回退到下一个提供商。此过程对用户透明，并能显著提高生产环境应用的容错能力。OpenRouter 提供了丰富的选项来配置路由提供商的行为。

完整文档请点击此处查看。

如何计算速率限制？

所有新用户都会获得少量免费额度，用于试用 OpenRouter。

对于免费模型，速率限制取决于您购买的积分数量。如果您购买了至少 10 个积分，则您的免费模型每日请求速率限制为 1000 次。否则，您的免费模型 API 请求速率限制为每日 50 次。

一些热门型号包括：

  • DeepSeek R1（免费） - DeepSeek 的推理模型
  • Llama models (free) - 各种 Meta Llama 模型
  • Qwen models (free) - 阿里巴巴的 Qwen 系列
  • 以及其他社区贡献的免费模型

您可以在我们的费率限制文档中了解更多关于付费账户费率限制运作方式的信息。

免费模型使用指南

要检查 API 密钥的速率限制或剩余积分，请向 https://openrouter.ai/api/v1/key 发出 GET 请求。

1
2
3
4
5
6
7
8
9
10
11
import requests
import json

response = requests.get(
  url="https://openrouter.ai/api/v1/key",
  headers={
    "Authorization": f"Bearer <OPENROUTER_API_KEY>"
  }
)

print(json.dumps(response.json(), indent=2))

如果您提交了有效的 API 密钥，您应该会收到如下形式的响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
type Key = {
  data: {
    label: string;
    limit: number | null; // Credit limit for the key, or null if unlimited
    limit_reset: string | null; // Type of limit reset for the key, or null if never resets
    limit_remaining: number | null; // Remaining credits for the key, or null if unlimited
    include_byok_in_limit: boolean;  // Whether to include external BYOK usage in the credit limit

    usage: number; // Number of credits used (all time)
    usage_daily: number; // Number of credits used (current UTC day)
    usage_weekly: number; // ... (current UTC week, starting Monday)
    usage_monthly: number; // ... (current UTC month)

    byok_usage: number; // Same for external BYOK usage
    byok_usage_daily: number;
    byok_usage_weekly: number;
    byok_usage_monthly: number;

    is_free_tier: boolean; // Whether the user has paid for credits before
    // rate_limit: { ... } // A deprecated object in the response, safe to ignore
  };
};

无论账户状态如何，某些类型的请求都会受到一些速率限制：

  • 免费使用限制：如果您使用的是免费型号（ID 以 :free 结尾），则每分钟最多可以发出 20 个请求。每日限制如下：
  • 如果您购买的积分少于 10 个，则每天最多只能进行 50 次 :free 模型请求。
  • 如果您购买至少 10 个积分，您的每日限额将增加到每天 1000 次 :free 模型请求。
  • DDoS 防护 ：Cloudflare 的 DDoS 防护功能将阻止严重超出合理使用量的请求。
  • 如果您的账户余额为负数，您可能会看到 402 错误，包括免费模型。充值使余额大于零后，您就可以再次使用这些模型。

其它链接

  • PDF Inputs
  • Management API Keys
  • Provider Routing
  • Presets：预设功能允许您将 LLM 配置与代码分离。通过 OpenRouter Web 应用程序创建和管理预设，以控制提供商路由、模型选择、系统提示和其他参数，然后在 OpenRouter API 请求中引用它们。
  • Plugins：OpenRouter 插件通过添加实时网页搜索、PDF 处理和自动 JSON 修复等功能，扩展了任何型号的功能。插件可以通过 API 逐个请求启用，也可以通过 “插件设置”页面配置为所有 API 请求的默认插件。
  • Errors and Debugging：详细解释了调用API时的报错的含义。
软件工具库
openrouter的使用
http://zeyulong.com/posts/5f9038bc/
作者
龙泽雨
发布于
2026年2月17日
许可协议