gpt4free-ts

免费用上 GPT-4，TypeScript 开发者快速集成

gpt4free-ts 是 xtekky/gpt4free 的 TypeScript 移植版，旨在免费提供 OpenAI GPT-4 的 API 访问。它通过逆向工程和聚合多个第三方渠道，绕开官方付费限制，让开发者无需 API Key 即可调用 GPT-4、GPT-3.5 等模型。项目核心能力包括：支持多种模型（gpt-4、gpt-3.5-turbo）、提供简洁的 API 接口、兼容 Node.js 环境，并具备流式响应和对话管理功能。它解决了个人开发者或小团队在无预算情况下体验和集成 GPT-4 能力的问题，但依赖第三方渠道的稳定性，存在被屏蔽或失效的风险。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7672

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队xiangsx

所属国家

官网地址

GitHubhttps://github.com/xiangsx/gpt4free-ts

定价模式free

价格说明完全免费，开源项目，需自行部署，无官方在线服务。

访问状态

是否开源是

开源协议GPL-3.0

主要语言TypeScript

技术栈/模型chatbot,chatbots,chatgpt,chatgpt-free,chatgpt4,free-gpt,gpt,gpt-3,gpt-35-turbo,gpt-4,gpt4,gpt4-api,gpt4free,nodejs,openai,typescript

GitHub 星标★ 7672

30天Star增速

HF 下载量

上线时间2023-05-04 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

Node.js 环境（本地运行需使用 yarn 安装依赖）
Docker 环境（推荐用 docker run 方式运行）
Docker Compose（使用 docker-compose 部署时需要）
必须先在项目根目录创建 .env 文件，所有运行方式都依赖它
若本机无法直连目标站点，需要准备可用的 http 代理

安装与启动步骤

1获取项目代码

把仓库克隆到本地，README 建议先 fork 一份，因为部分逆向目标站点随时可能下线。
```
git clone https://github.com/xiangsx/gpt4free-ts.git
```
2创建 .env 文件

在项目根目录新建 .env，填入代理、RapidAPI Key、并发数等配置；不需要代理时删除 http_proxy 这一行。
3本地安装依赖

在项目目录下用 yarn 安装 Node 依赖，README 本地运行部分只给出了这一条安装命令。
```
yarn
```
4Docker 方式运行

README 推荐的方式，用 --env-file 加载 .env，并把容器 3000 端口映射到本机 3000 端口。
```
docker run -p 3000:3000 --env-file .env xiangsx/gpt4free-ts:latest
```
5docker-compose 部署

同样需要先创建好 .env，然后在项目目录执行后台构建并启动。
```
docker-compose up --build -d
```
6使用免费 API Key

README 提供一个免费的 OpenAI 兼容渠道，Base URL 为 https://api.gptgod.online，Key 为 sk-OsMMq65tXdfOIlTUYtocSL7NCsmA7CerN77OkEv29dODg1E

关键配置

配置项	必填	说明	示例
`http_proxy`	否	无法直连目标网站时配置的 HTTP 代理；不需要代理则删除该行	`http://host:port`
`rapid_api_key`	否	使用 forefront 相关功能时用于接收注册邮件的 RapidAPI Key	`xxxxxxxxxx`
`EMAIL_TYPE`	否	临时邮箱类型，可选 temp-email、temp-email44、tempmail-lol	`temp-email44`
`DEBUG`	否	使用 forefront 时设为 1 可显示逆向过程，便于本地排查	`0`
`POOL_SIZE`	否	forefront 并发数，运行成功前保持为 1，越大越占内存	`0`
`PHIND_POOL_SIZE`	否	phind 渠道的并发会话数量，越大可同时进行的对话越多	`0`

如何确认成功

docker run 启动后容器监听的 3000 端口映射到本机，用浏览器访问 http://localhost:3000 或发起请求有响应即算启动成功。

常见问题

Q：必须创建 .env 文件吗？

A：是的，README 明确说明所有运行方式都需要先创建 .env 文件，否则容器和本地服务缺少必要配置。

Q：没有代理能不能跑？

A：可以。如果你能直接访问目标网站，就把 .env 里的 http_proxy 那一行删掉即可。

Q：POOL_SIZE 应该设多大？

A：README 建议在第一次运行成功之前保持为 1，之后可再按内存情况调大以支持更多并发对话。

Q：rapid_api_key 是必须的吗？

A：不是。它只在你要使用 forefront 相关接口时才需要配置，用于接收注册邮件获取 API Key。

Q：服务打不开或请求失败怎么办？

A：先检查 .env 是否创建、代理是否可用；该项目依赖第三方渠道，站点可能随时被屏蔽或下线。

注意事项

先 fork 一份仓库，因为部分被逆向的站点可能随时下线。
免费 API Key 由第三方站点 gptgod.online 提供，并非官方 OpenAI 渠道，随时可能失效。
模型输出依赖第三方渠道稳定性，存在被屏蔽的风险，请勿用于生产关键业务。
并发数配置越大占用内存越多，本地调试建议先用默认值。

核心亮点

零成本接入 GPT-4，无需 OpenAI API Key
TypeScript 原生支持，类型安全，易于集成到 Node.js 项目
支持流式输出，交互体验流畅

不足之处

依赖逆向工程，第三方渠道可能随时失效，稳定性无保障
文档和社区支持相对薄弱，需自行摸索

适用场景

个人开发者快速原型验证，体验 GPT-4 能力
教学演示或研究用途，无需付费即可调用大模型
在资源受限环境中临时替代官方 API 进行功能测试

替代项目

gpt4free、free-chatgpt-api、chatgpt-api

项目介绍

gpt4free-ts 是对话助手领域的开源项目，由 xiangsx 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（7,672）位列前 7%，在对话助手分类的 907 个项目里位列前 4%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。完全免费，开源项目，需自行部署，无官方在线服务。

它主要面向的使用场景是：个人开发者快速原型验证，体验GPT-4能力。同类可对比的替代方案包括 gpt4free、free-chatgpt-api、chatgpt-api。

上一篇：BetterChatGPT

下一篇：HuLa