GPT4Free

活跃
GitHub Python GPL-3.0

简介

GPT4Free (g4f) 是社区驱动的多模型聚合工具,统一封装数十个 LLM 和媒体生成 API,提供 OpenAI 兼容 REST 接口、Python/JS 客户端。

核心特性

  • 多 Provider 统一接口 — 一套 OpenAI 兼容 API 透明调用数十个 LLM 和媒体生成服务商
  • Python / JS 客户端 — 提供与 openai 库完全一致的 Client API,零学习成本迁移
  • MCP 服务器 — 内置 MCP Server,让 Claude 等 AI 助手直接调用网页搜索、抓取和图像生成能力
  • Docker 一键部署 — 官方提供完整版和轻量版 Docker 镜像,含 VNC 桌面用于 Provider Cookie 登录

适用场景

💡 以 OpenAI SDK 兼容的方式统一调用多个 LLM Provider,消除供应商锁定
💡 在 Docker 容器中运行多模型推理服务,作为内部 API 网关为团队提供统一访问入口
💡 通过 MCP Server 为 Claude Desktop 等工具赋予网页搜索和图像生成能力

快速开始

# pip 安装(全功能)
pip install -U g4f[all]

# 或 Docker 一键启动(推荐)
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

# Python 客户端使用
from g4f.client import Client
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)

相关项目