接入教程

免费 OpenAI 兼容 API Key:4 个正规来源与限额对比(2026)

ROIBest AI

搜「OpenAI 兼容 API Key 免费」的人,到底在找什么

先说结论:OpenAI 官方不发免费 API Key。OpenAI 平台签发的密钥要先充值预付额度才能调用(流程见 OpenAI API Key 怎么获取)。所以搜 openai compatible api key free 的人,真正想问的是另一件事:有哪些说 OpenAI 接口格式的服务商,能让我不花钱拿到 Key,或者干脆不需要 Key?

答案并不复杂:有几家服务商在 OpenAI 兼容 API 后面提供免费层或免费模型,本地推理服务则根本不校验 Key。每一种都有自己的限制,决定了它适不适合你的项目。

本文事实全部来自各家官方文档(2026 年 11 月 20 日读取):Google Gemini OpenAI 兼容说明与定价页、OpenRouter 限额说明、Groq 的 OpenAI 兼容、速率限制与计费 FAQ、Ollama 的 OpenAI 兼容文档,以及 GitHub 的 GitHub Models 说明。免费政策变动频繁,本文与官方文档不一致时,以官方为准。

免费的 OpenAI 兼容方案一览

方案

OpenAI 兼容 base URL

免费的部分

主要限制

Google Gemini API

https://generativelanguage.googleapis.com/v1beta/openai/

多款模型有 Free Tier,如 Gemini 4 Hydrogen、Gemini 3.8 Flash、Gemini 2.5 Pro / Flash

Gemini 4 Carbon、Argon、Neon 不在免费层;免费层数据可能被用于改进 Google 产品

OpenRouter

https://openrouter.ai/api/v1

模型 ID 以 :free 结尾的免费变体

每分钟 20 次;累计购买额度不足 10 时每天 50 次,满 10 后每天 1000 次

Groq

https://api.groq.com/openai/v1

GroqCloud 免费层(Free tier)

按模型限 RPM / RPD / TPM;升级 Developer 层需绑定支付方式

Ollama(本地)

http://localhost:11434/v1/

全部免费,模型跑在你自己的机器上

取决于你的硬件;客户端必须填一个 Key,但 Ollama 不校验

还有一个老清单里常见、但已经不能用的选项:GitHub Models 已于 2026 年 7 月 30 日全面下线,playground、模型目录和推理 API 都已关闭。凡是教你「用 GitHub Token 当免费 OpenAI 兼容 Key」的教程,都已过时。

各方案怎么用

Google Gemini API:真实 Key + 免费层

在 Google AI Studio 创建 Gemini API Key,再把 OpenAI SDK 指向 Google 的兼容端点即可。官方的说法是「改三行代码」:Key、base URL 和模型名。Chat Completions、流式输出、函数调用、models.list() 都能通过这个端点使用,reasoning_effort 会映射到 Gemini 的思考等级。

免费使用时要注意两点。第一,定价页按模型分别标注是否有 Free Tier,旗舰 Gemini 4 Carbon、Argon、Neon 明确不在免费层。第二,定价表写明免费层的使用数据「会用于改进我们的产品」,付费层则不会;不希望被这样使用的数据,不要走免费层。另外 Google 说明 OpenAI 库的兼容支持仍处于 beta。

OpenRouter:一把 Key 调免费模型变体

OpenRouter 用一把 Key 接入多家模型,其中部分模型提供 ID 以 :free 结尾的免费变体。免费变体限每分钟 20 次请求;每日上限取决于你累计买过多少额度:不足 10 个额度时每天 50 次,满 10 个后每天 1000 次。同一模型的付费变体没有平台级的请求次数上限。

可以用 GET https://openrouter.ai/api/v1/key 查看当前用量,返回里的 free_model_daily_requests 含 used、limit、remaining。OpenRouter 也说明了:多开账号或多建 Key 不会提高限额,因为容量是全局统一管控的。

Groq:免费层,兼容 OpenAI SDK

Groq 的 API 与 OpenAI 客户端库「基本兼容」:把 Groq Key 填进 api_key,base_url 设为 https://api.groq.com/openai/v1 即可。GroqCloud 有免费层(Free tier);想要更高限额需升级到 Developer 层,要绑定信用卡、美国银行账户或 SEPA 借记账户。限额按组织、按模型计算(每分钟 / 每天的请求数与 token 数),你账户的具体数值以控制台 Limits 页为准。

Groq 列出了几项会直接返回 400 的不支持字段:logprobs、logit_bias、top_logprobs、messages[].name,且 n 只能为 1。原有 OpenAI 代码里如果带了这些参数,切换前先删掉。

Ollama:不需要真实 Key,跑在自己机器上

Ollama 本地服务在 http://localhost:11434/v1/ 提供 /v1/chat/completions 和 /v1/responses。OpenAI 客户端要求必须填 Key,随便填一个占位字符串即可,官方文档原话是「必填但会被忽略」。软件本身免费,但模型在你的硬件上运行,速度和能跑多大的模型取决于显卡和内存。

Ollama 另有云端 API(https://ollama.com/v1),需要 OLLAMA_API_KEY,属于另一项服务、有自己的条款,不要和本地免费方案混为一谈。

把代码切到免费端点

用官方 OpenAI Python SDK 时,上面每一家的改法都一样:换 Key、换 base URL。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",   # 或换成表中 Gemini / Groq / Ollama 的地址
    api_key=os.environ["PROVIDER_API_KEY"],    # 本地 Ollama 填任意占位值即可
)

resp = client.chat.completions.create(
    model="该服务商的模型ID",
    messages=[{"role": "user", "content": "用一句话打个招呼。"}],
)
print(resp.choices[0].message.content)

模型 ID 不能通用:gpt-... 这类名字在 Gemini、Groq 上不存在,先调 client.models.list(),从返回列表里复制 ID。base URL 的常见错误(漏掉 /v1、把 /chat/completions 拼进 base URL 等)见 OpenAI 兼容 base URL 怎么填。

「免费」的代价

  • 速率限制:超出上限都会返回 429。读响应头里的限额信息(Groq 会返回 x-ratelimit-remaining-requests 等字段),按退避策略重试,不要循环狂发。
  • 模型选择:免费层很少包含最强的模型。Gemini 旗舰 Gemini 4 系列只能付费使用;OpenRouter 只有 :free 变体免费。
  • 数据用途:用之前读清楚各家对免费层数据的条款。Google 明确写了免费层数据可能被用于改进其产品。
  • 兼容不完整:「OpenAI 兼容」覆盖的是核心端点,不是每个参数。常见断点见 OpenAI 兼容性问题。

别用网上的「免费 API Key 清单」

有些网站会贴出所谓「免费 OpenAI API Key 列表」。那些是别人泄露或共享出来的凭据,用它们违反服务商条款;Key 随时会被吊销,你的请求还可能被转发这些 Key 的人记录,基于它们搭的东西也撑不了多久。上面所有正规免费方案,要么给你自己的 Key,要么根本不需要 Key。

免费不够用的时候

学习、做原型、跑个人脚本,免费层足够。当你需要稳定的吞吐、最强的模型,或者一把 Key 打通多家模型时,免费层就不合适了,常规做法是换付费 Key:直接找各家厂商,或者走一个 OpenAI 兼容网关。ROIBest AI 在 https://ai.roibest.com/v1 提供 OpenAI 兼容端点(另有 Anthropic 兼容端点),Key 按协议分组签发,每把 Key 可单独设置额度和有效期。决定前可以先看 用 SDK 和 curl 直接调用、API Key 额度与有效期设置和价格页。

常见问题

有免费的 OpenAI API Key 吗?

没有。OpenAI 平台的 Key 要先充值预付额度才能用。免费方案来自其他提供 OpenAI 兼容 API 的服务商,例如 Gemini API 免费层、OpenRouter 的 :free 模型、Groq 免费层,或者本地 Ollama。

免费的 Gemini API Key 能配合 OpenAI SDK 用吗?

能。把 base_url 设为 https://generativelanguage.googleapis.com/v1beta/openai/,填 Gemini API Key,并选择 Google 定价页上标有 Free Tier 的模型,例如 Gemini 3.8 Flash。Gemini 4 Carbon、Argon、Neon 不在免费层。

OpenRouter 免费模型每天能调多少次?

ID 以 :free 结尾的模型限每分钟 20 次;累计购买额度不足 10 时每天 50 次,满 10 后每天 1000 次。

GitHub Models 还能免费用吗?

不能。GitHub Models 已于 2026 年 7 月 30 日全面下线,推理 API 一并关闭。GitHub 建议改用 Azure AI Foundry 或 GitHub Copilot。

用 Ollama 需要 API Key 吗?

本地服务不需要。OpenAI 客户端要求必须有值,填一个占位符(如 ollama)即可,本地服务不会校验。Ollama 云端 API(ollama.com/v1)则需要 OLLAMA_API_KEY。

一句话总结

OpenAI 官方没有免费 Key,但正规的免费 OpenAI 兼容 Key 是有的:Gemini 免费层、OpenRouter :free 模型、Groq 免费层,以及填占位 Key 的本地 Ollama。换 base URL 和 Key、先列模型、守住速率限制,任何提供「别人的 Key」的网站都别碰。