GPT4Free：多模型聚合调用工具

项目简介

GPT4Free（g4f）是一个社区驱动的开源项目，把多个可访问的模型服务提供方和接口聚合在一起，方便开发者用统一方式调用现代大语言模型与媒体生成模型。项目提供 Python 客户端、可选的本地 Web GUI、基于 FastAPI 的 OpenAI 兼容接口，以及 Docker 镜像等使用形态。官网与文档：https://g4f.dev

主要功能

• 多 provider 适配：统一接入多家 LLM、媒体生成 provider 和本地推理后端。
• Python 客户端：同步与异步客户端，支持文本与图像生成等调用方式。
• 本地 Web GUI：可在浏览器中使用的聊天/操作界面。
• OpenAI 兼容 API：基于 FastAPI 的 Inference API，可按 OpenAI 接口形式调用。
• 浏览器 JS 客户端：官方 g4f.dev 分发版本。
• 媒体能力：支持图像、音频、视频生成与媒体持久化相关工具。
• 部署方式：提供完整版与 slim 版 Docker 镜像，以及带桌面的 sandbox 镜像。
• 其他发布物：Android APK、Chrome/Edge 浏览器扩展、g4f-go 自包含启动器、独立 sandbox 启动器等。

安装与使用

Python 安装（推荐）：

pip install -U g4f[all]

需要 Python 3.10+；部分 provider 需要 Chrome/Chromium。

Docker 方式：

docker pull hlohaus789/g4f

容器端口 8080 用于 GUI/API，7900 可用于类似 VNC 的桌面登录（可选）。完整命令见 README。slim 镜像同样支持 x64 与 arm64，并可在启动时更新 g4f 包。

安装后项目提供 GUI（Web 客户端）、FastAPI/Inference API 和 CLI 等入口；README 中给出了同步文本、图像生成和异步客户端的示例。

注意事项

• 项目以 GPL-3.0 许可证发布。
• 不同 provider 的可用性、登录要求和依赖可能不同；使用浏览器自动化的 provider 需要 Chrome/Chromium。
• Docker 部署时可通过挂载 har_and_cookies 与 generated_media 保存登录状态和生成媒体；浏览器自动化任务可适当增大 --shm-size。
• sandbox desktop 镜像默认只绑定 127.0.0.1，并带有出口防火墙；需要访问局域网时可调整绑定地址或相关环境变量。
• 请遵守各服务提供方的使用条款和项目的安全、隐私与下架政策。

本作品整理自 GitHub 开源项目 xtekky/gpt4free，原作者 @xtekky，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。