工具介绍
说明:本文是待审核草稿,内容依据项目 README、LICENSE 和发布页整理;未进行实际安装与功能测试,文中提到的连通性、速度、输出质量和提供方可用性都需要核查。
项目概况
据项目自述,gpt4free(Python 包名 g4f)是由 @xtekky 创建、@hlohaus 维护的开源项目。它通过多个提供方适配器,把可访问的模型提供方和本地推理后端聚合起来,同时提供本地网页界面、OpenAI 兼容的 REST 接口、Python 同步与异步客户端,以及浏览器端 JS 客户端。项目采用 GNU GPL v3.0 许可。
据 README 整理的主要功能
- 多提供方适配:包括 OpenAI 兼容端点、PerplexityLabs、Gemini、MetaAI、Pollinations(媒体生成)以及本地推理后端等;具体清单和当前可用状态以官方 providers 文档为准。
- 本地 Web GUI:浏览器内聊天界面。
- 基于 FastAPI 的 OpenAI 兼容 Inference API,便于把现有工具链指向本服务。
- Python 客户端 Client / AsyncClient,支持对话补全与图像生成调用。
- 浏览器端 JS 客户端,经 g4f.dev CDN 分发。
- MCP 服务器:提供 web_search、web_scrape、image_generation 等工具,可写入 Claude Desktop 配置。
- 多种部署形态:Docker 完整镜像、slim 镜像、sandbox 桌面镜像,以及 g4f-go 独立启动器、Android APK、浏览器扩展(版本与文件名见发布页)。
适用人群
- 需要在同一套接口下试用多家模型、做横向对比或失败回退的开发者。
- 想把自建服务包装成 OpenAI 兼容端点,供其他应用或智能体接入的技术用户。
- 教学、实验与原型验证场景。
不太适合:需要稳定 SLA 与可追责服务承诺的生产业务;对数据来源、合规与审计有严格要求的组织。
环境门槛
- 推荐 Python 3.10 及以上,或改用 Docker。
- 部分提供方依赖 Chrome/Chromium 等浏览器自动化环境。
- 部分提供方需要登录态(cookies、HAR 文件)或 API Key。
- 官方镜像覆盖 x86_64 与 arm64;sandbox 桌面镜像默认把端口绑定在 127.0.0.1,并启用出站防火墙(需要 --cap-add NET_ADMIN)。
安装与使用(命令摘自项目 README,未实测)
- pip 安装:
pip install -U g4f[all] - 源码安装:
git clone https://github.com/xtekky/gpt4free.git→cd gpt4free→pip install -r requirements.txt→pip install -e . - 启动 OpenAI 兼容 API:
python -m g4f --port 8080 --debug - 启动 GUI:
python -m g4f.cli gui --port 8080 --debug,随后访问http://localhost:8080/chat/ - Docker:
docker pull hlohaus789/g4f,再按 README 中的docker run示例映射 8080/7900 端口、挂载 har_and_cookies 与 generated_media 目录 - Python 调用:
client = Client()后调用client.chat.completions.create(model="auto", messages=[...]);图像用client.images.generate(...) - MCP:
g4f mcp或python -m g4f.mcp;HTTP 模式为g4f mcp --http --port 8765
费用与许可
- 代码以 GPLv3 发布,版权声明为 Copyright (C) 2025 xtekky,按 GPLv3 条款可再分发与修改,且不提供任何担保;二次分发或修改后发布需履行 GPLv3 义务(如提供对应源码)。
- 项目源码本身开源,但它所调用的第三方提供方各有服务条款、配额与地区限制,能否长期免费使用需自行核查,项目方不作保证。
- 转载或引用本项目文档时,请保留原始版权与许可信息;未获授权不得默认将其内容用于商业再分发。
国内使用与合规提示(均待核查)
- 各提供方在中国大陆网络环境下的可访问性、是否需要额外网络条件、账号注册与实名要求:待核查。
- 通过浏览器自动化抓取第三方站点或共用 cookies/HAR 的做法,可能违反对方服务条款并带来账号封禁风险;仓库内附有 LEGAL_NOTICE.md,使用前应阅读并自行评估法律与账号风险:待核查。
- 生成内容(文本、图像等)的版权归属与商用许可取决于上游提供方:待核查。
- 项目 topics 中包含 reverse-engineering,涉及第三方接口的使用方式,请自行判断合规边界。
待核查清单
- 各提供方当前可用性、模型清单与配额变化。
- 各部署方式(pip、Docker 完整/slim/sandbox、g4f-go、APK、浏览器扩展)的实际运行结果。
- 生成质量、延迟与稳定性表现。
- 中国大陆网络环境下的实际可用性。
来源与加工说明
来源:https://github.com/xtekky/gpt4free
许可证:GPL-3.0
依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。
来源类型:GitHub;授权范围待核验
运行与适配
如何理解使用难度?
- 直接使用:通常打开网页或登录账号即可使用。
- 简单配置:需要填写密钥、连接服务或导入配置。
- 需要部署:需要安装依赖、配置运行环境或自行部署。
- 技术开发:需要编程、接口集成或开发调试。
格数越多,使用门槛越高;具体要求请看下方说明。
国内可用性待核验
访问来源 ↗国内使用情况与网友核验
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →