FreeAI Hub

USE 直接用

把 base_url 换成 …/gw/v1，不需要 api_key（随便填非空即可）。

from openai import OpenAI

client = OpenAI(
    base_url="…",
    api_key="free",          # 随便填，网关不校验
)
r = client.chat.completions.create(
    model="openai-fast",
    messages=[{"role":"user","content":"你好"}],
)
print(r.choices[0].message.content)

CURL 命令行

也支持 stream: true 流式输出。

curl … \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai-fast",
    "messages": [
      {"role":"user","content":"你好"}
    ]
  }'

查额度：/gw/quota · 状态：/gw/status

📊 网关状态

🔑 Key 池（仅站长）

Key 只存在服务器端，任何接口都不会下发明文。管理需要服务器上的令牌 data/gateway_admin.token。

GET 全量数据

一次性拿到平台清单、免费模型清单与采集元信息（含各平台在线状态与延迟）。

# 命令行直接取
curl -s registry.json | jq '.meta.stats'

GET 只看平台

只要平台级导航数据：接口地址、免费政策、文档链接、存活状态。

// 前端可直接消费
const r = await fetch('registry.json');
const { platforms } = await r.json();

// 筛出「免密钥」的公益接口
const free = platforms.filter(p => !p.requires_key);

GET 只看免费模型

模型级清单：ID、提供方、上下文长度、模态、是否支持工具调用。

// 找上下文最长的免费模型
const { models } = await r.json();
models.sort((a,b) =>
  (b.context_length||0) - (a.context_length||0));

GET Key 注册信息

平台数据里已包含每个平台的注册门槛与分步教程，可直接用于二次开发或做成自己的教程页。

// 字段说明
p.key_apply_url   // 申请 Key 的直达链接
p.key_requires    // 需要的材料，如 ["手机号注册","需实名认证"]
p.key_steps       // 分步注册教程（字符串数组）
p.key_difficulty  // none / easy / medium

// 例：筛出「不用绑卡」的平台
const ok = platforms.filter(p =>
  (p.key_requires||[]).some(r => r.includes('无需绑卡')));

RUN 本地起 API 服务

附带零依赖的 Python 服务，启动后即拥有带 CORS 的 REST 接口，可自建镜像站。

python server.py --port 8787

# 然后
GET http://localhost:8787/api/v1/platforms
GET http://localhost:8787/api/v1/models
GET http://localhost:8787/api/v1/free
GET http://localhost:8787/api/v1/health

USE 统一调用示例

绝大多数平台都是 OpenAI 兼容接口，换 base_url 与 model 即可无缝切换。

from openai import OpenAI

client = OpenAI(
    base_url="https://api.groq.com/openai/v1",
    api_key="你的免费Key",
)
print(client.chat.completions.create(
    model="llama-3.3-70b-versatile",
    messages=[{"role":"user","content":"你好"}],
).choices[0].message.content)

NOTE 使用须知

本站只做索引与聚合，不代理、不转售任何模型能力。请遵守各平台服务条款与所在地区法律法规，合理使用免费额度。

数据许可：CC0-1.0（自由使用、修改、再分发，无需署名）。免费额度与限速政策以各平台官方页面为准。

🕕 采集机制

定时任务每天 06:00（UTC+8） 自动执行，流程为：

1. 载入人工校验的免费平台清单 → 2. 并发探测各平台接口存活与延迟 → 3. 从公开模型列表接口抓取实时免费模型 → 4. 与前一交易日快照做 diff → 5. 重新生成 registry.json 并刷新本站。

📊 本次采集

🔀 模型变更

🧭 怎么选平台

· 想零成本先跑通：选免密钥平台（Pollinations）或本地部署（Ollama）。
· 想要一个 Key 通吃：OpenRouter / Hugging Face 这类聚合网关。
· 追求速度：Groq、Cerebras、SambaNova。
· 追求大额度：Google AI Studio、NVIDIA NIM、魔搭、阿里云百炼。
· 数据不能出内网：vLLM / llama.cpp 自托管。
· 不知道怎么申请 Key：切到「Key 申请指南」标签页，有逐步教程。