GPT4Free (g4f)

项目概览

GPT4Free（简称 g4f）是一个社区驱动的多模型聚合项目。它把各类可访问的模型提供方封装成统一接口，让开发者用同一套代码调用 GPT、DeepSeek、Gemini、Kimi 等不同来源的语言模型，并支持图像、音频等媒体生成。

项目由 @xtekky 创建、@hlohaus 维护，提供 Python 客户端、浏览器 JS 客户端、本地 Web GUI 以及 OpenAI 兼容的 REST API。

主要能力

• 多提供方适配：内置大量提供方适配器，覆盖云端 LLM 与本地推理后端。
• OpenAI 兼容 API：基于 FastAPI 的 Inference API，可直接替换现有 OpenAI SDK 的 base_url。
• 本地 GUI：自带 Web 客户端，便于交互式试用与调试。
• 多语言客户端：Python 同步/异步客户端，以及官方浏览器 JS 客户端。
• 媒体生成：支持图像等生成任务与媒体文件持久化。

快速上手

推荐使用 Docker 部署，镜像同时暴露 GUI/API 端口：

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

也可通过 pip 安装 g4f 包，在 Python 中直接调用客户端发起对话或图像生成请求。

使用建议

• 部分提供方依赖浏览器自动化，需要 Chrome/Chromium 环境，容器中可适当调大 --shm-size。
• 需要登录态的提供方可在容器桌面中完成登录，凭证会持久化到挂载目录。
• 生产环境建议在 g4f 前加一层自己的网关，做好超时、重试与降级。

注意事项

项目通过逆向等方式访问第三方服务，接口随时可能失效，且可能涉及服务条款与合规问题。用于正式产品前，请评估稳定性与法律风险，并遵守 GPL-3.0 许可要求。