GPT4Free 使用教程：3 步搭建免费 AI 模型工具，告别 API 订阅费
项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4free 打开 OpenAI 的账单页面，你是不是也倒吸一口凉气？每个月想用 GPT-4、想试试 DeepSeek、想生成几张图，一套组合拳下来订阅费轻松过百。今天要介绍的 GPT4Free（简称 g4f）就是为解决这个痛点而生的开源项目：它是一个聚合了数十个 AI 服务商接口的免费 AI 模型工具，让你用一份 Python 代码或一个 Docker 容器，就能在 GPT-4o、DeepSeek、Gemini 等模型之间自由切换，且无需支付 API 费用。
一个工具，四种玩法：选适合你的那一种
g4f 不像普通的单机软件只有一种打开方式，它把"用 AI"这件事拆成了四套入口。先看一眼全景，再决定从哪儿下手：
| 接入方式 | 适合谁 | 上手难度 | 典型场景 |
|---|---|---|---|
| Python 客户端 | 开发者 | 低 | 写脚本、做应用、批量任务 |
| 浏览器 GUI | 完全零基础 | 极低 | 当 ChatGPT 网页版用 |
| Interference API | 后端工程师 | 中 | 替换 OpenAI 接口，老项目零改造 |
| Docker 容器 | 运维/部署 | 中 | 团队共享、生产环境、手机访问 |
小提示：这四套入口底层共用同一套 Provider 适配层，你在 Python 里能用到的模型，在 GUI 和 API 里同样能用，不用重复配置。
5 分钟跑通第一个对话：从 pip 安装到收到回复
1. 准备环境
项目要求 Python 3.10 以上，装过 Python 的电脑基本都满足。个别依赖浏览器自动化的服务商还需要 Chrome/Chromium，普通对话场景用不到，可以忽略。
2. 安装
在终端执行一行命令即可，推荐安装全量依赖，省得后面缺模块：
pip install -U g4f[all]
3. 写第一个脚本
新建一个 hello.py，粘贴下面这段代码：
from g4f.client import Client
client = Client()
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "你好，用一句话介绍一下你自己"}],
)
print(response.choices[0].message.content)
然后运行：
python hello.py
几秒钟后你就能看到模型的回复。整个过程和调用 OpenAI 官方 SDK 几乎一模一样，messages 的格式、choices[0].message.content 的取值方式都保留了下来，换个底层服务商却不用改业务代码——这正是 g4f 讨喜的地方。
不止聊天：把流式输出、异步和图片能力用起来
让回复"打字"给你看
把 create 里加上 stream=True，再把打印方式换成逐块输出，就能实现边生成边显示的效果，长回答不再干等：
stream = client.chat.completions.create(
model="gpt-4",
messages=[{"role": "user", "content": "递归列出目录下所有文件的 Python 写法"}],
stream=True,
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
异步版本，三行代码切换
g4f 提供了 AsyncClient，接口签名和同步版一致，适合在 FastAPI 等异步框架里使用，不会阻塞事件循环。
让 AI"看"图
视觉模型是 g4f 的隐藏技能。把图片以二进制传给 image 参数，模型就能描述图片内容：
client = Client()
with open("docs/images/cat.jpeg", "rb") as f:
resp = client.chat.completions.create(
model=g4f.models.default_vision,
messages=[{"role": "user", "content": "这张图里有什么？"}],
image=f,
)
print(resp.choices[0].message.content)
用一句话生成图片
写文案、做配图一站搞定，图像生成走的同样是客户端接口：
response = client.images.generate(
model="flux",
prompt="一只白色暹罗猫",
response_format="url",
)
print(response.data[0].url)
不想写代码？两种方式三分钟开一个"网页版 ChatGPT"
方式 A：本地一键启动 GUI
装完 g4f 后，终端执行：
python -m g4f.cli gui --port 8080 --debug
浏览器打开 http://localhost:8080/chat/，一个自带聊天界面的免费 AI 工具就出现在眼前。界面是响应式设计，同一地址在手机上访问也完全可用，出门在外照样用。
方式 B：Docker 部署，一条命令全家共享
如果你想把服务跑在服务器上，或让整个团队共用，Docker 是最省心的路径：
mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media
docker pull hlohaus789/g4f
docker run -p 8080:8080 -p 7900:7900 \
--shm-size="2g" \
-v ${PWD}/har_and_cookies:/app/har_and_cookies \
-v ${PWD}/generated_media:/app/generated_media \
hlohaus789/g4f:latest
8080端口对外提供 GUI 和 API；7900端口是一个内置的桌面环境，用来登录网页版服务商、导出 cookie 和 HAR 文件；har_and_cookies与generated_media两个目录负责持久化登录态和生成产物，容器重启不丢数据。
给 AI 装上"外挂"：用 MCP 打通搜索与抓取
g4f 内置了一个 MCP（模型上下文协议）服务器，把网页搜索、网页抓取、图片生成打包成标准工具，让 Claude 等 AI 助手直接调用。启动方式非常简单：
# 标准输入输出模式，配合 Claude Desktop 使用
g4f mcp
# HTTP 模式，独立端口提供服务
g4f mcp --http --port 8765
HTTP 模式启动后，http://localhost:8765/mcp 是 JSON-RPC 接口，/health 用来做健康检查。想给 Claude Desktop 配置，只需在 claude_desktop_config.json 里声明：
{
"mcpServers": {
"gpt4free": {
"command": "python",
"args": ["-m", "g4f.mcp"]
}
}
}
进阶玩法：用配置文件给模型做"智能路由"
不同服务商的状态时好时坏，手动切换很麻烦。项目支持用 config.yaml 定义模型路由：给同一个逻辑模型挂多个 Provider，并按条件自动选择。比如"OpenaiAccount 有余额就用它，否则退回 PollinationsAI"：
models:
- name: "my-gpt4"
providers:
- provider: "OpenaiAccount"
model: "gpt-4o"
condition: "balance > 0 or error_count < 3"
- provider: "PollinationsAI"
model: "openai-large"
配置里的 condition 支持 balance、quota.credits.remaining、error_count 等字段做布尔判断，逻辑和运算符齐全，相当于给免费 AI 模型工具加了一层自动故障转移。想接入本地模型？项目也对 Ollama 等本地推理后端提供了支持，断网也能玩。
四个常见疑问，一次说清
Q1：真的完全免费吗？ 免费来自聚合公开可访问的服务商接口。大多数场景无需付费，但个别 Provider 需要登录账号（用 cookie/HAR 授权），也可能有频率限制，请遵守各家条款。
Q2：响应快吗？ 取决于你选的服务商、网络和服务器负载。一般 DeepSeek 系响应较快，GPT-4 系偏慢。配置了路由后，坏节点会被自动跳过，整体体验更稳定。
Q3：会不会不安全？ 项目代码完全开源可审查。使用时记住三点：不传敏感信息、不给服务商保存明文凭据、公网部署务必加 HTTPS 和访问鉴权。
Q4：出错了怎么办？ 先看 g4f 的 debug 日志，再对照项目内 docs/ 下的文档（如 docs/README.md），或运行 etc/testing/ 目录里的测试脚本定位问题。
接下来，动手做这三件事
- 安装并跑通：执行
pip install -U g4f[all]，把上面的hello.py跑起来； - 换一种方式体验：启动 GUI（
python -m g4f.cli gui --port 8080）或直接docker run部署一个长期服务； - 深入源码：
g4f/Provider/里躺着几十个服务商适配器，etc/examples/目录准备了对话、流式、图片、视频、视觉等可直接运行的示例，照着抄就能学会各种姿势。
如果你需要用 git 拉取代码，仓库地址是 https://gitcode.com/GitHub_Trending/gp/gpt4free，克隆下来慢慢研究。
免费 AI 的民主化不是一句口号，g4f 把"用得起 GPT-4"这件事变成了可能。从今天的第一行代码开始，把每月那笔订阅费省下来，去做点更有意思的事吧。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
