返回列表

gpt4free|多提供方 LLM 聚合与 OpenAI 兼容接口

把多个可访问的模型提供方与本地推理后端聚合到一处,提供统一的 Python/JS 客户端、本地网页界面和 OpenAI 兼容接口,适合想在一个入口里调用多种文本与图像模型的开发者和技术爱好者。

通用 LLM 应用图像生成Python库gpt4freeg4f多提供方聚合OpenAI兼容接口LLM客户端Docker部署本地GUIMCP服务器GPL-3.0站长实测状态尚未登记

工具介绍

说明:本文是待审核草稿,内容依据项目 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 份有效分项记录

最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。

分项统计、有效期与样本量
核验项目有效人数成功 / 部分 / 失败 / 无法判断成功率最近核验 / 有效期
官方网站访问00 / 0 / 0 / 0样本不足暂无 / 7 天
GitHub 仓库访问00 / 0 / 0 / 0样本不足暂无 / 7 天
安装与运行00 / 0 / 0 / 0样本不足暂无 / 30 天
官方服务国内连接 / MCP 连接00 / 0 / 0 / 0样本不足暂无 / 30 天
国内网络情况00 / 0 / 0 / 0样本不足暂无 / 7 天
国内模型兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
自定义 API00 / 0 / 0 / 0样本不足暂无 / 30 天
海外服务依赖
00 / 0 / 0 / 0样本不足暂无 / 30 天
海外账号要求
00 / 0 / 0 / 0样本不足暂无 / 30 天
中文界面
00 / 0 / 0 / 0样本不足暂无 / 30 天
客户端兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
账号及费用信息
00 / 0 / 0 / 0样本不足暂无 / 30 天

成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。

最近有效核验

暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。

查看全部有效核验 →

反馈此内容的问题