SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台gpt4free

gpt4free

GPT4Free（g4f）是一个社区驱动的开源项目，通过聚合多个可访问的提供者与接口，简化对现代大语言模型及媒体生成模型的使用。项目提供多提供者支持、本地图形界面、兼容 OpenAI 的 REST API，以及 Python 与 JavaScript 客户端，采用社区优先的许可证。由 @xtekky 创建，@hlohaus 维护。

访问官网

工具介绍

GPT4Free（简称 g4f）是一个社区驱动的项目，通过聚合多个可访问的提供者（provider）与接口，让使用现代大语言模型和媒体生成模型更简单、更灵活。项目提供多提供者支持、本地 GUI、兼容 OpenAI 的 REST API，以及便捷的 Python 和 JavaScript 客户端，采用社区优先许可证。由 @xtekky 创建，@hlohaus 维护。

一、主要内容 项目包含：Python 客户端库与异步客户端；可选的本地 Web GUI；基于 FastAPI 的兼容 OpenAI 的 API（Interference API）；官方浏览器 JS 客户端（经 g4f.dev 分发）；Docker 镜像（完整版与精简版）；多提供者适配器（大语言模型、媒体提供者、本地推理后端）；用于图像/音频/视频生成与媒体持久化的工具。

二、环境要求与兼容性 推荐 Python 3.10+；部分使用浏览器自动化的提供者需要 Google Chrome/Chromium；容器化部署需要 Docker；支持 x86_64 与 arm64（精简镜像两者均支持）；部分提供者适配器可能需要特定平台工具（如 Chrome/Chromium），详情需查看提供者文档。

三、安装方式

  1. Docker（推荐）：安装 Docker 后，创建持久化目录（示例：mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media，并执行 sudo chown -R 1200:1201 ${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 可选地暴露类似 VNC 的桌面用于提供者登录；较重的浏览器自动化任务需增大 --shm-size。
  2. 精简 Docker 镜像（x64 与 arm64）：启动时可更新 g4f 包并按需安装额外依赖；文档示例中将 Interference API 映射到 1337。
  3. Windows（.exe）：提供 Windows 启动器 https://github.com/gpt4free/g4f.exe；从 https://github.com/xtekky/gpt4free/releases/latest 下载 g4f.exe.zip，解压并运行 g4f.exe，在 http://localhost:8080/chat/ 打开 GUI；若被 Windows 防火墙阻止需允许该应用。
  4. Python 安装（pip / 源码 / 部分安装）：需 Python 3.10+ 与部分提供者所需的 Chrome/Chromium。推荐从 PyPI 安装；也可仅安装特定功能（使用可选 extras 组，见项目文档 docs/requirements.md）；或从源码安装。部分功能需要 Chrome/Chromium 或其他工具，需遵循提供者专属文档。

四、运行应用 可通过 Python 运行，打开 http://localhost:8080/chat/；可启动 FastAPI 服务器，若使用精简 docker 映射，Interference API 可能位于 http://localhost:1337/v1，Swagger UI 位于 http://localhost:1337/docs；也可启动 GUI 服务器。

项目还包含 Model Context Protocol（MCP）服务器，允许 Claude 等 AI 助手访问网页搜索、抓取与图像生成能力。启动 MCP 服务器（stdio 模式或 HTTP 模式）；HTTP 模式提供 POST http://localhost:8765/mcp（JSON-RPC 端点）与 GET http://localhost:8765/health（健康检查）。可通过 claude_desktop_config.json 配置到 Claude Desktop。可用 MCP 工具包括：web_search（使用 DuckDuckGo 搜索网页）、web_scrape（从网页提取文本内容）、image_generation（根据文本提示生成图像）。详细 MCP 文档见 g4f/mcp/README.md。

可选提供者登录（容器内桌面）可通过 http://localhost:7900/?autoconnect=1&resize=scale&password=secret 访问，用于登录基于网页的提供者以获取 cookies/HAR 文件。

五、客户端使用 Python 客户端支持同步文本示例、图像生成示例与异步客户端示例；完整 API 参考（流式、工具调用模式与高级选项）见 https://g4f.dev/docs/client。官方 JS 客户端可直接在浏览器使用，无需后端，经 g4f.dev CDN 分发，需注意 CORS 与使用限制。

六、提供者与模型 GPT4Free 集成了许多提供者，包括（但不限于）兼容 OpenAI 的端点、PerplexityLabs、Gemini、MetaAI、Pollinations（媒体）以及本地推理后端。模型可用性与行为取决于提供者能力，当前支持的提供者/模型列表见 https://g4f.dev/docs/providers-and-models 。提供者要求可能包括：API 密钥或令牌（认证类提供者）、浏览器 cookies/HAR 文件（通过浏览器自动化抓取的提供者）、Chrome/Chromium 或无头浏览器工具、本地模型二进制与运行时（本地推理）。

七、本地推理与媒体 GPT4Free 支持本地推理后端，支持的运行时与硬件指南见 docs/local.md。图像、音频、视频等媒体生成通过提供者（如 Pollinations）支持，格式、选项与示例见 docs/media.md。

八、配置与自定义 可通过环境变量、CLI 标志或配置文件进行配置，见 docs/config.md。为减小安装体积可使用部分依赖组，见 docs/requirements.md。提供者选择：默认设置与按请求覆盖见 docs/selecting_a_provider.md。持久化：HAR 文件、cookies 与生成的媒体保存在映射目录（如 har_and_cookies、generated_media）。

九、移动端与 API Web GUI 为响应式，可通过手机访问主机 IP:8080 或经隧道访问，见 docs/guides/phone.md。Interference API 支持类似 OpenAI 的工作流并经由 GPT4Free 提供者选择路由，文档见 docs/interference-api.md，默认端点（精简 docker 示例）为 http://localhost:1337/v1。流式补全、停止条件、系统消息与工具调用模式见 docs/client.md、docs/async_client.md、docs/requests.md。集成（LangChain、PydanticAI）见 docs/pydantic_ai.md，旧版示例见 docs/legacy.md。

十、贡献与安全 欢迎贡献新提供者、功能、文档与修复。流程：Fork 仓库、创建分支、运行测试与 linter、提交带清晰描述与测试/示例的 Pull Request。创建提供者指南见 docs/guides/create_provider.md，典型步骤：在 g4f/Provider/ 实现提供者适配器、添加配置与依赖说明、包含测试与用法示例、遵守第三方代码许可证并适当署名。借助 AI 编写代码的工作流见 docs/guides/help_me.md。请勿存储或分享敏感凭据，采用各提供者推荐的安全实践。若网站出现在项目链接中并希望移除，可向 https://g4f.dev/community 发送所有权证明，会及时移除。生产环境应使用 HTTPS、身份认证与防火墙规则保护服务器，限制对提供者凭据与 cookie/HAR 存储的访问。

十一、许可证与归属 本项目采用 GNU General Public License v3.0（GPLv3）许可，可在 GPLv3 条款下再分发和/或修改，程序不提供任何担保。核心创建者：@xtekky（原始作者），由 @hlohaus 维护。代码输入与署名包括：har_file.py（来自 xqdoo00o/ChatGPT-to-API）、PerplexityLabs.py（来自 nathanrchn/perplexityai）、Gemini.py（来自 dsdanielpark/Gemini-API 与 HanaokaYuzu/Gemini-API）、MetaAI.py（灵感来自 Strvm 的 meta-ai-api）、proofofwork.py（来自 missuo/FreeGPT35）。Powered-by 亮点包括 Pollinations AI（生成式媒体）与 MoneyPrinter V2（使用 GPT4Free 的示例项目）。

十二、相关链接 网站与文档：https://g4f.dev 、https://g4f.dev/docs ；PyPI：https://pypi.org/project/g4f ；Docker 镜像：https://hub.docker.com/r/hlohaus789/g4f ；发布：https://github.com/xtekky/gpt4free/releases ；问题反馈：https://github.com/xtekky/gpt4free/issues ；社区：Telegram（https://telegram.me/g4f_channel）、Discord News（https://discord.gg/5E39JUWUFa）、Discord Support（https://discord.gg/qXA4Wf4Fsm）。

同类工具

查看分类