使用 openrouter/free 作为模型 ID，OpenRouter 会自动从当前可用的免费模型中随机选择一个，同时过滤出满足你请求功能需求（视觉、工具调用、结构化输出等）的模型。完全免费，适合学习、原型开发和低频个人项目。响应中 model 字段会显示实际使用的模型。

用法

将模型设置为 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: 'Hello! What can you help me with today?' },
  ],
});

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

响应 model 字段会显示实际选中的免费模型（如 upstage/solar-pro-3:free）。

工作原理

1. 请求分析：检测你的请求需要哪些能力（图片理解、工具调用、结构化输出等）
2. 模型过滤：从所有可用免费模型中过滤出支持所需能力的模型
3. 随机选择：从过滤后的候选模型中随机选一个
4. 请求转发：发送给选中的免费模型
5. 结果追踪：响应中记录实际使用的模型

当前可用的免费模型

免费模型列表会频繁变化，常见包括：

• DeepSeek R1（free）
• 各种 Meta Llama 模型（free）
• 阿里 Qwen 系列（free）
• 社区贡献的其他免费模型

实时列表在 Models 页面查看。

使用特定免费模型

如果需要使用特定免费模型而不是随机选择，有两种方式：

1. :free 后缀：在支持免费版本的模型 ID 后加 :free

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

2. 直接指定：在 Models 页面找到具体免费模型后直接使用其 ID

无代码体验

想先在 Chat Playground 中免费试用，无需写代码：Free Models Router 使用指南

限制

• 速率限制：免费模型速率限制通常比付费模型更严格
• 可用性：部分免费模型在高峰时段可能不可用
• 性能：高峰期延迟可能较高
• 模型不可控：无法指定具体模型（如需指定，用 :free 后缀）

常见问题

Q: 完全免费吗？有隐藏费用吗？

A: 完全免费，路由本身和免费模型请求均不计费。唯一的"成本"是速率限制比付费模型更严格。

Q: 免费模型的质量怎么样？

A: 免费模型通常是付费模型的社区贡献版本，质量参差不齐。适合实验和学习，不建议用于生产环境关键任务。

Q: 一直返回同一个模型吗？

A: 不是，每次请求会从当前可用的免费模型中随机选择，不保证每次相同。