零成本调用GPT-4、DeepSeek与GeminiGPT4Free手把手搭建免费AI工作台全指南【免费下载链接】gpt4freeThe official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4free如果你最近想做个AI小工具却卡在API充值这一步——OpenAI按token计价、DeepSeek刚降价还是贵、Gemini还要绑卡——那这篇指南就是为你准备的。GPT4Free简称g4f是一个社区驱动的开源项目它把几十个可访问的大模型提供商聚合到一起让你不花一分钱就能调用GPT-4、GPT-4o、DeepSeek、Gemini还顺带提供图像、音频、视频生成能力。本文不打算给你罗列功能清单而是带着你从0到1亲手搭起一个免费AI工作台把最容易踩的坑提前告诉你。先搞明白它到底是个什么东西一句话概括g4f 是一个聚合层。它自己不训练模型而是把各家免费/可访问的模型接口统一封装成一套 OpenAI 风格的标准接口。这样做的价值在于——你只需要学会一种调用方式就能随时切换背后的模型对比维度传统 API 直连使用 g4f花费按 token 计费越用越贵免费聚合免费/可访问渠道换模型换一家就要重读一套文档改一个model参数即可接口风格各家不同统一 OpenAI 兼容格式部署方式基本是远程调用Python 库 / Docker / 本地 GUI 均可风险封号、限额个别渠道有使用限制需按需切换它的模块化设计很清晰认识这几个目录就能少走弯路g4f/Provider/—— 各家 AI 服务提供商的适配层想换渠道就找这里g4f/client/—— 同步/异步客户端日常开发的主入口g4f/gui/—— 本地 Web 图形界面不写代码也能用g4f/mcp/—— MCP 服务器让 Claude 等助手获得联网能力记住这张地图后面每一步都离不开它。第一条线5 分钟先把服务跑起来我们先用最省事的方式启动完整服务跑通再谈原理。这里提供两条路任选其一。路线 ADocker 部署推荐环境隔离最省心如果你装好了 Docker四步走# 1. 创建数据持久化目录保存 cookie 和生成的媒体文件 mkdir -p har_and_cookies generated_media # 2. 拉取镜像 docker pull hlohaus789/g4f # 3. 运行容器 docker run -p 8080:8080 -p 7900:7900 \ --shm-size2g \ -v $(pwd)/har_and_cookies:/app/har_and_cookies \ -v $(pwd)/generated_media:/app/generated_media \ hlohaus789/g4f:latest启动后浏览器打开http://localhost:8080/chat/一个可以直接对话的 Web 界面就在眼前了。8080 端口服务 GUI 和 API7900 端口是容器内桌面用于登录某些网页版提供商日常用不到。路线 Bpip 安装适合要写代码的开发者pip install -U g4f[all]装完就拥有完整的 Python 库这也是后面所有示例的基础。注意要求 Python 3.10个别提供商还依赖 Chrome/Chromium建议先备好。两条路怎么选给个直白的建议表你的情况建议只想快速体验、不想碰环境Docker跑起来就完事要写脚本、做集成、二次开发pip 安装 代码调用服务器部署、给团队用Docker映射1337端口可直接获得 OpenAI 兼容 API第一个里程碑跑通人生第一次免费对话服务起来了接下来写你的第一段代码。用 g4f 客户端调用和 OpenAI SDK 的手感几乎一样from g4f.client import Client client Client() response client.chat.completions.create( modelgpt-4o-mini, messages[{role: user, content: 你好请用三句话介绍你自己}] ) print(response.choices[0].message.content)保存成hello.py跑一下python hello.py看到回复的瞬间你的免费AI工作台就正式点亮了第一个灯泡。这个接口的核心参数model、messages、stream全部兼容 OpenAI 格式意味着你过去写过的 OpenAI 调用代码改个 import 就能迁移过来。让它真正好用流式输出、图像、音频、视频单次问答只是热身。一个趁手的工作台得能打字机式输出、能画画、能开口说话。流式输出长回答逐字显示体验立刻上一个档次from g4f.client import Client client Client() stream client.chat.completions.create( modelgpt-4, messages[{role: user, content: 用递归方式列出目录下所有文件给出Python代码}], streamTrue, ) for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content or , end)图像生成换flux模型一句话出图response client.images.generate( modelflux, prompta white siamese cat, response_formaturl ) print(fGenerated image URL: {response.data[0].url})音频与视频也都有现成入口。参考项目自带的示例文件etc/examples/audio.py和etc/examples/video.py前者演示了用openai-audio模型生成语音并用message.save(alloy.mp3)保存后者通过HuggingFaceMedia调用client.media.generate生成视频。etc/examples/目录里还躺着视觉问答vision_images.py、异步调用等十几个可直接运行的样例抄作业就完事。任务不同模型也要换着用任务类型推荐模型为什么日常问答gpt-4o-mini快、省够用代码编程deepseek 系列代码专项强响应快创意写作gpt-4o逻辑与文采平衡图像生成flux出图质量高音频生成openai-audio支持声音合成与保存避坑清单新手最容易卡住的 5 个问题跑通之后你大概率会陆续碰到下面这些坎提前排掉能省一天时间。Q1为什么有的模型报错/无响应因为 g4f 聚合的是可访问渠道而非官方付费通道个别渠道有地区限制或使用量限额。应对办法换model参数换渠道或者用RetryProvider自动重试比如from g4f.client import Client from g4f.Provider import OpenaiChat, RetryProvider client Client(providerRetryProvider([OpenaiChat], max_retries3))Q2Docker 容器跑不起来 / 浏览器自动化崩溃多半是共享内存不足。把--shm-size从默认值调大到2g上面的命令已写并确认挂载目录权限正确。Q3想用网页版 OpenAI 渠道却一直失败网页版渠道对地区敏感参考etc/examples/openaichat.py给客户端配置一个可用地区的代理并把stream打开。Q4依赖装了一大堆g4f 支持按需安装partial installs。只需要聊天功能就不必装全量依赖按docs/里的 requirements 说明挑选即可。Q5数据存哪了har_and_cookies登录凭据和generated_media生成的图片音频就是持久化目录Docker 挂载时务必保留。定期清理生成媒体能避免磁盘爆掉。进阶玩法一用 MCP 服务器给 Claude 装上网线想让 Claude 这类助手联网搜索、抓网页、生图g4f 内置的 MCP 服务器就能办到。启动 HTTP 模式g4f mcp --http --port 8765它提供三个核心工具web_searchDuckDuckGo 搜索、web_scrape抓取网页正文、image_generation文生图。以 HTTP 模式启动后POST http://localhost:8765/mcp就是 JSON-RPC 端点。把它写进 Claude Desktop 的配置里你的 AI 助手立刻多出联网这个技能。进阶玩法二用 config.yaml 造一条模型路由这是很多人忽略的宝藏功能。在 cookie 目录放一个config.yaml就能定义命名路由客户端请求my-gpt4g4f 会按顺序尝试你列出的提供商并用条件表达式决定谁可用——比如余额大于0优先用 OpenaiAccount否则降级到 PollinationsAI。# ./har_and_cookies/config.yaml models: - name: my-gpt4 providers: - provider: OpenaiAccount model: gpt-4o condition: balance 0 or error_count 3 - provider: PollinationsAI model: openai-large然后客户端直接modelmy-gpt4即可。条件表达式支持quota.balance、error_count等变量和and/or/not逻辑等于把自动故障转移 余额感知写进了配置里。完整语法见 docs/config-yaml-routing.md里面还有 QuotaCache 和 ErrorCounter 的 Python API 说明。最后一步现在就去动手免费的蛋糕已经摆在你面前别光看着。按这个顺序行动先跑通用 Docker 或 pip 任一方式启动浏览器里先聊上几句感受一下速度再写码跑通etc/examples/text_completions_demo_sync.py改成你自己的对话场景加功能给项目加上流式输出和图像生成一个多模态小助手初具雏形上生产部署到服务器时用 Docker把1337端口暴露成 OpenAI 兼容 API现有代码无缝对接。遇到问题别硬扛——先翻docs/README.md和etc/examples/里的样例绝大多数坑在示例里都有对应解法实在搞不定去项目的 Issues 区搜关键词或提 issue社区很活跃。代码仓库地址git clone https://gitcode.com/GitHub_Trending/gp/gpt4freeclone 下来对照着g4f/Provider/和etc/examples/看理解会深很多。最后提醒一句免费资源请合理使用别拿它做违规刷量也别在对话里提交敏感信息。工具是免费的但好习惯是无价的。【免费下载链接】gpt4freeThe official gpt4free repository | various collection of powerful language models | opus 4.6 gpt 5.3 kimi 2.5 deepseek v3.2 gemini 3项目地址: https://gitcode.com/GitHub_Trending/gp/gpt4free创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考