OpenRouter 模型与路由

OpenRouter 模型与路由

免费模型路由器

2 分钟阅读

Free Models Router

通过路由到可用的免费模型，获得免费 AI 推理

Free Models Router（openrouter/free）会从 OpenRouter 上当前可用的免费模型中随机选择一个。路由器会智能筛选出支持你请求所需能力的模型，例如图像理解、工具调用和结构化输出。

概述

不必手动挑选某个具体的免费模型，可以把模型选择交给 Free Models Router。这适合实验、学习和低用量场景：你希望零成本推理，又不想操心具体用哪一个模型。

若想不写代码就试用 Free Models Router，见 Chat Playground 指南。

用法

将模型设为 openrouter/free：

import { OpenRouter } from '@openrouter/sdk';

const openRouter = new OpenRouter({
  apiKey: '<OPENROUTER_API_KEY>',
});

const completion = await openRouter.chat.send({
  model: 'openrouter/free',
  messages: [
    {
      role: 'user',
      content: '你好！今天我可以请你帮什么忙？',
    },
  ],
});

console.log(completion.choices[0].message.content);
// 查看实际选中了哪个模型
console.log('Model used:', completion.model);

响应

响应中的 model 字段会标明实际使用的免费模型：

{
  "id": "gen-...",
  "model": "upstage/solar-pro-3:free",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 85,
    "total_tokens": 97
  }
}

工作原理

  1. 请求分析：分析你的请求，确定所需能力（例如视觉、工具调用、结构化输出）
  2. 模型筛选：路由器从可用免费模型中筛出支持你请求要求的模型
  3. 随机选择：从筛选后的池中随机选择一个模型
  4. 请求转发：将你的请求转发到所选的免费模型
  5. 响应追踪：响应包含元数据，标明使用了哪个模型

可用的免费模型

Free Models Router 会从 OpenRouter 上当前所有可用的免费模型中选择。一些常见选项包括：

免费模型的可用性变化很快。请查看 模型页面 获取当前免费模型列表。

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

定价

Free Models Router 完全免费。以下均不收费：

  • 使用路由器本身
  • 路由到免费模型的请求

使用场景

  • 学习与实验：零成本试用 AI 能力
  • 原型开发：在承诺使用付费模型之前构建和测试应用
  • 低用量应用：适合个人项目或演示
  • 教育：非常适合学生和教育者探索 AI

限制

  • 速率限制：经 openrouter/free 路由的请求，与 :free 变体 计入同一套账户级免费模型速率限制。每日上限取决于你是否曾经购买过额度——确切数字及如何随额度变化见 速率限制。
  • 可用性：免费模型的可用性可能变化；有些可能暂时不可用
  • 性能：高峰时段免费模型的延迟可能更高
  • 模型选择：你无法控制具体选中哪一个模型（如果需要特定的免费模型，请在该模型上使用 :free 变体后缀）

选择特定的免费模型

如果你更希望使用某个具体的免费模型，而不是随机选择，可以：

  1. 使用 :free 变体：在任何有免费变体的模型后追加 :free：

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

  2. 浏览免费模型：访问 模型页面，查看所有可用免费模型并直接选择。

上一页Body Builder下一页 最新模型解析