OpenRouter 免费模型:限制、额度与 API 设置
OpenRouter 免费模型:限制、额度与 API 设置
时间 5 分钟 你需要 一个 OpenRouter 账户;免费模型不需要信用卡 · 可选:一次性购买 10 个额度,将每日上限从 50 次提高到 1,000 次请求 · curl 或任意 OpenAI 兼容 SDK 最后检查于 2026 年 10 月 21 日
OpenRouter 用一个 API 接入数百个模型。其中一些有 ID 以 :free 结尾的免费变体:使用普通密钥调用,每 token 支付 $0,但受共享每日上限约束。以下每个数字均于 2026-10-21 在 OpenRouter 的文档、定价页面和实时模型 API 上核对。
当前哪些免费
有两个计数,且都正确。2026-10-21,免费模型筛选器 和带 ?output_modalities=all 的模型 API 列出了 24 个 :free 模型 ID。普通模型 API 列出了 17 个,因为默认只返回输出文本的模型。当天按类型:
| 类型(输出) | :free ID 数 | 默认 API 列表中 |
|---|---|---|
| 文本聊天 | 17 | 是 |
| 嵌入 | 3 | 否 |
| 重排 | 1 | 否 |
| 决策(分类器) | 2 | 否 |
| 语音(文本转语音) | 1 | 否 |
| 总计 | 24 | 17 |
当天的文本聊天示例:
| 模型 ID | 上下文 | 图像输入 |
|---|---|---|
| google/gemma-4-31b-it:free | 262,144 | 是 |
| minimax/minimax-m3.1-flash:free | 1,000,000 | 是 |
| nvidia/nemotron-3-ultra-550b-a55b:free | 1,000,000 | 否 |
| poolside/laguna-s-2.1:free | 262,144 | 否 |
| cohere/north-mini-code:free | 256,000 | 否 |
免费嵌入模型为 nvidia/nemotron-3-embed-1b:free(32,768 token 上下文)、nvidia/llama-nemotron-embed-vl-1b-v2:free(文本和图像输入,131,072)和 liquid/lfm-2.5-embedding-350m:free(512)。重排模型为 nvidia/llama-nemotron-rerank-vl-1b-v2:free,文本转语音模型为 fish-audio/s2.1-pro-free:free。
阵容经常变化,因此不要硬编码:当前列表在免费模型筛选器 或模型 API 中(筛选以 :free 结尾的 ID;加上 ?output_modalities=all 以包括嵌入、重排和语音模型)。两点说明:
- openrouter/free,即免费模型路由器,“会从可用免费模型中随机自动选择一个免费模型”,并按你的请求所需功能(图像、工具调用、结构化输出)进行筛选。响应的 model 字段会说明是哪个模型回答;你无法选择。
- 并非所有 $0 价格都免费:Lyria 音乐模型显示 token 价格为 0,但收取“每首歌 $0.08”。检查当天没有 DeepSeek、Llama 或 Qwen 模型有 :free 变体,尽管一个较旧的 OpenRouter 页面仍将它们列为示例。想在其他地方使用免费 DeepSeek,请参阅[免费 DeepSeek API 指南](/learn/free-deepseek-api/)。
限制:每天 50 或 1,000 次请求
根据 OpenRouter 的限制页面,对于任何以 :free 结尾的模型 ID(该页面未对嵌入或重排模型作例外,因此它们也计入同一上限):
| 已购买额度(历史累计) | 每分钟请求数 | 每日请求数 |
|---|---|---|
| 少于 10 | 20 | 50 |
| 至少 10 | 20 | 1,000 |
- 每日计数每个 UTC 日重置。“创建更多账户或 API 密钥不会影响你的速率限制。”
- “失败尝试会计入该每日上限,负余额会阻止使用免费模型,直到你添加额度”(定价)。负余额即使在 :free 模型上也会返回 HTTP 402。
- 使用 GET https://openrouter.ai/api/v1/key 查看剩余额度:is_free_tier 和 free_model_daily_requests(已用、上限、剩余)。每分钟限制未在那里报告。
- 429 可能来自 OpenRouter(你的上限)或上游提供商(免费端点繁忙)。只有 OpenRouter 自己的 429 带有 X-RateLimit-* 标头。要了解每天 50 或 1,000 次请求对你的工作负载能支撑多少,请把数字输入[速率限制计算器](/tools/rate-limit-calculator)。
何时购买额度
购买额度是提高每日上限的唯一方式,而且只需做一次:阈值按“历史累计”购买额度计算。当每天 50 次请求不够用(一个智能体一项任务就可能用完),或你还想通过同一密钥使用付费模型时,就值得购买。
- 支持银行卡、支付宝或加密货币(USDC)支付。银行卡手续费为 5.5%(最低 $0.80),加密货币为 5%(FAQ);Standard 计划没有最低消费。
- OpenRouter“保留在购买一年后使未使用额度过期的权利”。
- 免费请求不消耗额度;保持余额大于零,以便免费模型继续可用。
调用免费模型
- 在 openrouter.ai 注册,并在账户设置中创建 API 密钥。
- 调用 OpenAI 兼容端点:curl https://openrouter.ai/api/v1/chat/completions -H "Authorization: Bearer $OPENROUTER_API_KEY" -H "Content-Type: application/json" -d '{"model": "google/gemma-4-31b-it:free", "messages": [{"role": "user", "content": "Hello"}]}'
- 对于嵌入,调用 curl https://openrouter.ai/api/v1/embeddings -H "Authorization: Bearer $OPENROUTER_API_KEY" -H "Content-Type: application/json" -d '{"model": "nvidia/nemotron-3-embed-1b:free", "input": "Hello"}'。将数组作为 input 传入,可在一次请求中嵌入多个文本,这也能节省每日上限中的请求数。
- 使用 OpenAI SDK 时,将 base URL 设为 https://openrouter.ai/api/v1,并将模型设为任意 :free ID 或 openrouter/free。可选的 HTTP-Referer 和 X-OpenRouter-Title 标头会在 OpenRouter 排名中标注你的应用。如果设置 models 回退列表,请确保每一项都免费:回退到付费模型会“产生费用,即使第一个模型是”。