Free-GPT4-WEB-API

自托管的 Web API，通过一个简单统一的 HTTP 接口，提供对现代大语言模型提供商的免费、无限访问权限。它包含一个可选的 Web GUI 用于配置，并支持通过 Python 或 Docker 运行。

核心特性

• 免费使用：无需 API 密钥或订阅
• 无限制请求：无速率限制
• 简单的 HTTP 接口：返回纯文本响应
• 可选 Web GUI：可通过浏览器轻松配置
• Docker 支持：提供开箱即用的容器
• 智能超时处理：自动重试并优化超时设置

注意：演示服务器在可用时可能会过载，因此不一定总能响应。

---

目录

• 特性
• 截图
• 快速开始
  • 使用 Docker 运行
  • 从源码运行
• 使用方法
  • 快速示例（浏览器、curl、Python）
  • 文件输入
  • Web GUI
• 命令行选项
• 配置
  • Cookies
  • 代理
  • 模型和提供商
  • 私密模式与密码
• Siri 集成
• 系统要求
• 星标历史
• 贡献指南
• 许可证

---

截图

---

快速开始

选项 A：使用 Docker 运行

拉取镜像并运行，可选择挂载 cookies.json 文件及端口映射。在 Docker 中，建议设置 GUI 密码（某些部署环境则为必填项）。

• 最简版本（无 cookies）：

docker run -p 5500:5500 d0ckmg/free-gpt4-web-api:latest

• 带 cookies（只读挂载）：

docker run \
  -v /path/to/your/cookies.json:/cookies.json:ro \
  -p 5500:5500 \
  d0ckmg/free-gpt4-web-api:latest

• 覆盖容器端口映射：

docker run -p YOUR_PORT:5500 d0ckmg/free-gpt4-web-api:latest

• docker-compose.yml：

version: "3.9"
services:
  api:
    image: "d0ckmg/free-gpt4-web-api:latest"
    ports:
      - "YOUR_PORT:5500"
    #volumes:
    #  - /path/to/your/cookies.json:/cookies.json:ro

注意：

• 如果计划在 Docker 中使用 Web GUI，请务必设置密码（参见“命令行选项”）。
• API 在容器内监听 5500 端口。

选项 B：从源码运行

1. 克隆仓库

git clone https://github.com/aledipa/Free-GPT4-WEB-API.git
cd Free-GPT4-WEB-API

2. 安装依赖

pip install -r requirements.txt

3. 启动服务器（基础版）

python3 src/FreeGPT4_Server.py

安全提示

使用 Web GUI 时，请务必设置安全密码：

python3 src/FreeGPT4_Server.py --enable-gui --password your_secure_password

---

使用方法

API 默认返回纯文本。

• 浏览器快速测试：
  • 启动服务器
  • 打开：http://127.0.0.1:5500/?text=Hello

示例：

• GET http://127.0.0.1:5500/?text=Write%20a%20haiku
• 如果您更改了关键字参数（参见 --keyword），请将 text 替换为您选择的关键字。

curl 示例

• 简单文本提示：

curl "http://127.0.0.1:5500/?text=Explain%20quicksort%20in%20simple%20terms"

• 文件输入（参见选项中的 --file-input）：

fileTMP="$1"
curl -s -F file=@"${fileTMP}" http://127.0.0.1:5500/

Python 示例

import requests

resp = requests.get("http://127.0.0.1:5500/", params={"text": "Give me a limerick"})
print(resp.text)

Web GUI

• 启动时启用 GUI：

python3 FreeGPT4_Server.py --enable-gui

• 打开设置或登录：
  • http://127.0.0.1:5500/settings
  • http://127.0.0.1:5500/login

通过 GUI 可以配置常用选项（如模型、提供商、关键字、历史记录、Cookies 等）。

---

命令行选项

显示帮助：

python3 src/FreeGPT4_Server.py [-h] [--remove-sources] [--enable-gui]
                                [--private-mode] [--enable-history] [--password PASSWORD]
                                [--cookie-file COOKIE_FILE] [--file-input] [--port PORT]
                                [--model MODEL] [--provider PROVIDER] [--keyword KEYWORD]
                                [--system-prompt SYSTEM_PROMPT] [--enable-proxies] [--enable-virtual-users]

选项：

• -h, --help 显示帮助并退出
• --remove-sources 从响应中移除来源信息
• --enable-gui 启用图形化设置界面
• --private-mode 需要私密令牌才能访问 API
• --enable-history 启用消息历史记录
• --password PASSWORD 设置或更改设置页面的密码
  • 注意：在某些 Docker 环境中为必填项
• --cookie-file COOKIE_FILE 使用 Cookie 文件（例如 /cookies.json）
• --file-input 启用文件输入功能（参见 curl 示例）
• --port PORT HTTP 端口（默认：5500）
• --model MODEL 使用的模型（默认：gpt-4）
• --provider PROVIDER 使用的提供商（默认：Bing）
• --keyword KEYWORD 更改输入查询关键字（默认：text）
• --system-prompt SYSTEM_PROMPT 用于引导回答的系统提示
• --enable-proxies 使用一个或多个代理以减少被封禁的风险
• --enable-virtual-users 启用虚拟用户功能，以便将请求分配给多个用户

---

配置

Cookies

部分提供商需要 Cookies 才能正常工作。对于 Bing 模型，仅需 _U Cookie 即可。

• 通过文件传递 Cookies：
  • 从源码运行时使用 --cookie-file /cookies.json
  • 在 Docker 中，以只读方式挂载您的 Cookies 文件：-v /path/to/cookies.json:/cookies.json:ro
• GUI 也提供了与 Cookies 相关的设置选项。

代理

启用代理可以有效缓解被封禁的问题：

• 启动时添加 --enable-proxies
• 如果需要 SOCKS/HTTP 代理，请确保您的环境已正确配置 aiohttp/aiohttp_socks。

模型和提供商

• 模型：gpt-4、gpt-4o、deepseek-r1 等现代大语言模型
• 默认模型：gpt-4
• 默认提供商：DuckDuckGo（可靠的备用方案）
• 提供商回退机制：自动在 Bing、DuckDuckGo 等之间切换
• 健康监测：实时跟踪各提供商的状态

可通过标志或在 GUI 中进行更改：

--model gpt-4o --provider Bing

可靠性特性

• 智能超时处理：优化了30秒超时机制，并支持自动重试
• 提供商回退：当主提供商出现故障时自动切换
• 健康监测：持续监控提供商状态
• 黑名单机制：自动排除存在问题的提供商

私密模式与密码

• --private-mode 需要私密令牌才能访问 API
• --password 用于保护设置页面（在 Docker 部署中为必填项）
• 安全增强：认证系统已加固，防止绕过攻击
• 日志记录：所有认证尝试都会被记录，便于安全监控
• 如果将 API 暴露到本地主机之外，请使用强密码

重要提示：使用 Web GUI 时务必设置密码，以防止未经授权的访问。

---

Siri 集成

使用 GPTMode 的 Apple 快捷指令，即可通过 Siri 向您自托管的 API 提问。

快捷指令：

• https://www.icloud.com/shortcuts/bfeed30555854958bd6165fa4d82e21b

对 Siri 说“GPT Mode”，并在提示时提出您的问题。

---

系统要求

• Python 3.8+
• Flask[async]
• g4f（来自 https://github.com/xtekky/gpt4free）
• aiohttp
• aiohttp_socks
• Werkzeug
• requests（用于增强 HTTP 处理）

开发与测试所需：

• pytest
• pytest-asyncio

故障排除

常见问题

1. 超时错误：系统现已自动重试，并启用回退提供商
2. 提供商被封禁：健康监测功能会自动切换至可用的提供商
3. 认证问题：请确保设置强密码，并检查日志以了解失败尝试
4. Docker 权限问题：对于 cookies.json 等敏感文件，请使用只读挂载

获取帮助

如遇问题：

1. 查看应用日志以获取详细的错误信息
2. 在 Web GUI 中验证您的提供商配置
3. 确保 Cookie 格式正确（如适用）
4. 尝试通过回退系统切换不同的提供商

---

星标历史

---

贡献

欢迎贡献！您可以随时提交问题和拉取请求，以改进功能、文档或可靠性。

---

许可证

GNU 通用公共许可证 v3.0

详情请参阅 LICENSE 文件。

Free-GPT4-WEB-API 快速上手指南

Free-GPT4-WEB-API 是一个自托管的 Web API 工具，可通过简单的 HTTP 接口免费、无限制地访问现代大语言模型（LLM）。它支持 Docker 和 Python 源码运行，并提供可选的 Web 图形界面进行配置。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux, macOS, 或 Windows (需安装 WSL 或 Git Bash)
• Python 版本：Python 3.8 或更高版本
• 前置依赖：
  • 方案 A (Docker)：已安装 Docker 和 Docker Compose。
  • 方案 B (源码)：已安装 pip 包管理器。
  • 网络环境：由于该工具调用海外 LLM 提供商，国内用户建议配置全局代理或在启动时启用 --enable-proxies 参数并配置好环境变量。

安装步骤

您可以选择以下任一方式进行部署：

方案 A：使用 Docker（推荐）

这是最快捷的方式，无需配置本地 Python 环境。

1. 最小化运行（无需 Cookie）：

   docker run -p 5500:5500 d0ckmg/free-gpt4-web-api:latest
   

2. 挂载 Cookie 文件运行（适用于需要特定账号验证的模型）： 将本地的 cookies.json 映射到容器中：

   docker run \
     -v /path/to/your/cookies.json:/cookies.json:ro \
     -p 5500:5500 \
     d0ckmg/free-gpt4-web-api:latest
   

   注意：请将 /path/to/your/cookies.json 替换为您本地的实际文件路径。

3. 自定义端口： 如果 5500 端口被占用，可映射到其他端口（例如 8080）：

   docker run -p 8080:5500 d0ckmg/free-gpt4-web-api:latest
   

安全提示：如果在 Docker 中启用 Web GUI，强烈建议设置密码（见下文“基本使用”中的命令行选项部分）。

方案 B：从源码运行

适合需要二次开发或调试的用户。

1. 克隆仓库：

   git clone https://github.com/aledipa/Free-GPT4-WEB-API.git
   cd Free-GPT4-WEB-API
   

2. 安装依赖：

   pip install -r requirements.txt
   

   (国内用户若下载缓慢，可添加清华源：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple)

3. 启动服务：

   python3 src/FreeGPT4_Server.py
   

基本使用

服务启动后，默认监听在 http://127.0.0.1:5500。API 默认返回纯文本格式。

1. 浏览器快速测试

直接在浏览器地址栏输入以下 URL 即可测试（将 Hello 替换为您的提示词）：

http://127.0.0.1:5500/?text=Hello

或者尝试生成一首俳句：

http://127.0.0.1:5500/?text=Write%20a%20haiku

2. 使用 Curl 命令

在终端中执行：

curl "http://127.0.0.1:5500/?text=Explain%20quicksort%20in%20simple%20terms"

3. Python 代码调用

import requests

resp = requests.get("http://127.0.0.1:5500/", params={"text": "Give me a limerick"})
print(resp.text)

4. 启用 Web 图形界面与高级配置

为了方便配置模型、提供商（Provider）或设置密码，可以启用 GUI 模式。

启动命令示例：

python3 src/FreeGPT4_Server.py --enable-gui --password your_secure_password

• --enable-gui: 开启图形设置界面。
• --password: 设置访问设置页面的密码（Docker 环境下必填）。
• --model: 指定模型，例如 gpt-4o 或 deepseek-r1。
• --provider: 指定提供商，例如 Bing 或 DuckDuckGo。

启动后，访问以下地址进行配置：

• 设置页面：http://127.0.0.1:5500/settings
• 登录页面：http://127.0.0.1:5500/login

在 GUI 中，您可以轻松切换模型、管理 Cookie 文件以及查看历史记录。