gpt4free 项目遭 OpenAI 起诉

由 @xtekky 创建，由 @hlohaus 维护

在 GitHub Sponsors 上支持该项目 ❤️

在线演示及文档：https://g4f.dev | 文档：https://g4f.dev/docs

GPT4Free (g4f) 是一个社区驱动的项目，它聚合了多个易于访问的提供商和接口，使处理现代 LLM 和媒体生成模型变得更加容易和灵活。GPT4Free 致力于提供多提供商支持、本地 GUI、OpenAI 兼容的 REST API，以及便捷的 Python 和 JavaScript 客户端——全部在社区优先的许可证下。

本 README 是安装、运行和贡献 GPT4Free 的综合、改进和完整指南。

需求和兼容性

• Python 3.10+ 推荐
• Google Chrome/Chromium（某些提供商需要浏览器自动化）
• Docker（用于容器化部署）
• 支持 x86_64 和 arm64（slim 镜像支持两者）
• 某些提供商适配器可能需要特定平台工具（Chrome/Chromium 等）。详见提供商文档

安装

Docker（推荐）

安装 Docker：https://docs.docker.com/get-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

Slim Docker 镜像（x64 & arm64）

mkdir -p ${PWD}/har_and_cookies ${PWD}/generated_media
chown -R 1000:1000 ${PWD}/har_and_cookies ${PWD}/generated_media

docker run \
  -p 1337:8080 -p 8080:8080 \
  -v ${PWD}/har_and_cookies:/app/har_and_cookies \
  -v ${PWD}/generated_media:/app/generated_media \
  hlohaus789/g4f:latest-slim

slim 镜像可在启动时更新 g4f 包，并按需安装额外依赖。

在本例中，Interference API 映射到 1337。

Windows (.exe)

👉 查看 GPT4Free 的 Windows 启动器：🔗 https://github.com/gpt4free/g4f.exe 🚀

从以下地址下载发布版本 g4f.exe.zip：https://github.com/xtekky/gpt4free/releases/latest

解压并运行 g4f.exe。

打开 GUI：http://localhost:8080/chat/

如果 Windows 防火墙阻止访问，请允许该应用程序。

Python（pip / 从源代码 / 部分安装）

需要：

• Python 3.10+（https://www.python.org/downloads/）
• 某些提供商需要 Chrome/Chromium

从 PyPI 安装（推荐）：

pip install -U g4f[all]

要仅安装特定功能，请使用可选的额外功能组。见项目文档中的 docs/requirements.md。

从源代码安装：

git clone https://github.com/xtekky/gpt4free.git
cd gpt4free
pip install -r requirements.txt
pip install -e .

某些功能需要 Chrome/Chromium 或其他工具；请遵循提供商专用文档。

运行应用

GUI（Web 客户端）

from g4f.gui import run_gui
run_gui()

或通过 CLI：

python -m g4f.cli gui --port 8080 --debug

打开：http://localhost:8080/chat/

FastAPI / Interference API

启动 FastAPI 服务器：

python -m g4f --port 8080 --debug

如果使用 slim docker 映射，Interference API 可能在 http://localhost:1337/v1 可用

Swagger UI：http://localhost:1337/docs

CLI

python -m g4f.cli gui --port 8080 --debug

可选的提供商登录（容器中的桌面）

可在以下地址访问：http://localhost:7900/?autoconnect=1&resize=scale&password=secret

用于登录基于网页的提供商以获取 cookie/HAR 文件。

Model Context Protocol (MCP) 服务器

GPT4Free 现包括 Model Context Protocol (MCP) 服务器，允许 Claude 等 AI 助手访问网页搜索、网页抓取和图像生成功能。

启动 MCP 服务器（stdio 模式）

# 使用 g4f 命令
g4f mcp

# 或使用 Python 模块
python -m g4f.mcp

启动 MCP 服务器（HTTP 模式）

# 在端口 8765 启动 HTTP 服务器
g4f mcp --http --port 8765

# 自定义主机和端口
g4f mcp --http --host 127.0.0.1 --port 3000

• POST http://localhost:8765/mcp - JSON-RPC 端点
• GET http://localhost:8765/health - 健康检查

使用 Claude Desktop 配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "gpt4free": {
      "command": "python",
      "args": ["-m", "g4f.mcp"]
    }
  }
}

可用工具

• web_search - 使用 DuckDuckGo 搜索网页
• web_scrape - 从网页提取文本内容
• image_generation - 从文本提示生成图像

详细的 MCP 文档见 g4f/mcp/README.md

使用 Python 客户端

pip install -U g4f[all]

同步文本示例

from g4f.client import Client

client = Client()
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello, how are you?"}],
    web_search=False
)
print(response.choices[0].message.content)

输出：

Hello! How can I assist you today?

图像生成示例

from g4f.client import Client

client = Client()
response = client.images.generate(
    model="flux",
    prompt="a white siamese cat",
    response_format="url"
)
print(f"Generated image URL: {response.data[0].url}")

异步客户端示例

from g4f.client import AsyncClient
import asyncio

async def main():
    client = AsyncClient()
    response = await client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "Explain quantum computing briefly"}],
    )
    print(response.choices[0].message.content)

asyncio.run(main())

详见完整的 API 参考了解流式传输、工具调用模式和高级选项：https://g4f.dev/docs/client

使用 GPT4Free.js（浏览器 JavaScript 客户端）

在浏览器中使用官方 JS 客户端——无需后端。

<script type="module">
  import Client from 'https://g4f.dev/dist/js/client.js';

  const client = new Client();
  const result = await client.chat.completions.create({
      model: 'gpt-4.1',  // 或 "gpt-4o"、"deepseek-v3" 等
      messages: [{ role: 'user', content: 'Explain quantum computing' }]
  });
  console.log(result.choices[0].message.content);
</script>

JS 客户端通过 g4f.dev CDN 分发，便于使用。查看 CORS 考虑和使用限制。

提供商和模型（概览）

GPT4Free 集成了许多提供商，包括（但不限于）OpenAI 兼容端点、PerplexityLabs、Gemini、MetaAI、Pollinations（媒体）和本地推理后端。

模型可用性和行为取决于提供商功能。查看提供商文档了解当前支持的提供商/模型列表：https://g4f.dev/docs/providers-and-models

提供商需求可能包括：

• API 密钥或令牌（用于需要身份验证的提供商）
• 通过浏览器自动化抓取的提供商的浏览器 cookie / HAR 文件
• Chrome/Chromium 或无头浏览器工具
• 用于本地推理的本地模型二进制文件和运行时

本地推理和媒体

GPT4Free 支持本地推理后端。见 docs/local.md 了解支持的运行时和硬件指导。

媒体生成（图像、音频、视频）通过提供商（例如 Pollinations）支持。见 docs/media.md 了解格式、选项和示例用法。

配置和定制

通过环境变量、CLI 标志或配置文件进行配置。见 docs/config.md。

要减少安装大小，使用部分需求组。见 docs/requirements.md。

提供商选择：在 docs/selecting_a_provider.md 了解如何设置默认值和覆盖每个请求。

持久性：HAR 文件、cookie 和生成的媒体持久保存在映射目录中（例如 har_and_cookies、generated_media）。

在智能手机上运行

Web GUI 响应式，可通过访问你的主机 IP:8080 或通过隧道从手机访问。见 docs/guides/phone.md。

Interference API（OpenAI 兼容）

Interference API 启用通过 GPT4Free 提供商选择路由的类似 OpenAI 的工作流。

文档：docs/interference-api.md

默认端点（示例 slim docker）：http://localhost:1337/v1

Swagger UI：http://localhost:1337/docs

示例和常见模式

流式完成、停止条件、系统消息和工具调用模式均记录在：

• docs/client.md
• docs/async_client.md
• docs/requests.md

集成（LangChain、PydanticAI）：docs/pydantic_ai.md

旧版示例：docs/legacy.md

贡献

欢迎贡献——新提供商、功能、文档和修复都受欢迎。

• 为你的更改创建分支
• 运行测试和 linter
• 打开包含清晰描述和测试/示例的 Pull Request（如适用）

仓库：https://github.com/xtekky/gpt4free

如何创建新提供商

阅读指南：docs/guides/create_provider.md

典型步骤：

• 在 g4f/Provider/ 中实现提供商适配器
• 添加配置和依赖注意事项
• 包含测试和使用示例
• 尊重第三方代码许可并适当归属

AI 如何帮助你编写代码

见：docs/guides/help_me.md 了解提示模板和工作流以加速开发。

安全、隐私和删除政策

• 不要存储或共享敏感凭证。使用每个提供商建议的安全实践。
• 如果你的网站出现在项目的链接中，且你想删除它，请向 takedown@g4f.ai 发送所有权证明，它将被立即删除。
• 对于生产环境，使用 HTTPS、身份验证和防火墙规则保护服务器。限制对提供商凭证和 cookie/HAR 存储的访问。

致谢、贡献者和属性

核心创建者：@xtekky（原始者），由 @hlohaus 维护。

完整贡献者图表：https://github.com/xtekky/gpt4free/graphs/contributors

显著的代码输入和归属：

• 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

许多其他贡献者在仓库中得到确认。

由...驱动的亮点

• Pollinations AI — 生成媒体：https://github.com/pollinations/pollinations
• MoneyPrinter V2 — 使用 GPT4Free 的示例项目：https://github.com/FujiwaraChoki/MoneyPrinterV2

完整的使用 GPT4Free 的项目和网站列表，见：docs/powered-by.md

发布和完整更新日志

https://github.com/xtekky/gpt4free/releases

订阅 Discord/Telegram 获取公告。

宣言 / 项目原则

GPT4Free 由社区原则指导：

• 开放访问 AI 工具和模型
• 跨提供商和项目的协作
• 反对限制创意的垄断、封闭系统
• 以社区为中心的开发和广泛访问 AI 技术
• 促进创新、创意和可访问性

https://g4f.dev/manifesto

许可证

本程序在 GNU General Public License v3.0 (GPLv3) 下获得许可。见完整许可证：https://www.gnu.org/licenses/gpl-3.0.txt

你可以在 GPLv3 的条款下重新分发和/或修改。

该程序按"原样"提供，不附带任何保证。

xtekky/gpt4free: Copyright (C) 2025 xtekky

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

联系和赞助

维护者：https://github.com/hlohaus

赞助：https://github.com/sponsors/hlohaus

问题和功能请求：https://github.com/xtekky/gpt4free/issues

删除请求：takedown@g4f.ai

附录：快速命令和示例

安装和运行 GUI

pip install -U g4f[all]

python -m g4f.cli gui --port 8080 --debug
# 或
python -c "from g4f.gui import run_gui; run_gui()"

Docker

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

Docker Slim

docker run -p 1337:8080 -p 8080:8080 \
  -v ${PWD}/har_and_cookies:/app/har_and_cookies \
  -v ${PWD}/generated_media:/app/generated_media \
  hlohaus789/g4f:latest-slim

Python 使用模式

client.chat.completions.create(...)
client.images.generate(...)

通过 AsyncClient 的异步变量

文档和深入阅读

• 完整文档：https://g4f.dev/docs
• 客户端 API 文档：https://g4f.dev/docs/client
• 异步客户端文档：https://g4f.dev/docs/async_client
• 提供商指南：https://g4f.dev/docs/providers
• 本地推理：https://g4f.dev/docs/local

感谢你使用和贡献 GPT4Free——共同我们使强大的 AI 工具变得易于访问、灵活和社区驱动。