项目介绍
Telegram AI 生图机器人是一套面向 Telegram 用户的 AI 图片生成与图片编辑服务系统。项目以 Telegram 机器人作为主要交互入口，用户可以直接在聊天窗口中完成文生图、参考图生成、图片修改、多图组图编辑、继续修改、余额查询、USDT 充值和邀请返现等操作。相比传统网页工具，这套系统把 AI 生图能力放进了用户日常使用的聊天场景里，降低了使用门槛，也让付费、生成、修改和交付形成一条完整闭环。
演示机器人：
整个项目由三个核心服务组成：Python 编写的 Telegram Bot 负责用户交互和业务流程编排，Node.js Express 编写的计费服务负责用户余额、订单、流水和链上充值检测，gpt-api 作为本地图片能力代理服务，向上提供 OpenAI 兼容的图片生成与图片编辑接口。三者通过 HTTP 接口协作，既能保持模块边界清晰，又方便后续按业务规模进行拆分、替换或独立部署。
在实际使用中，用户不需要理解复杂的模型接口，只需要发送提示词或上传图片并附带修改说明，机器人就会自动完成余额校验、调用图片生成服务、扣除积分、返回图片结果，并在生成完成后支持继续基于当前图片进行多轮修改。系统同时支持简体中文、英文和俄文界面，适合面向多语言用户群体提供 AI 图片创作服务。
需要特别说明的是，项目中的 gpt-api 模块包含对 ChatGPT 官网相关图片能力的封装与代理逻辑，适合个人学习、技术研究和自托管测试场景。部署和使用时应遵守相关平台服务条款、当地法律法规以及内容安全要求，不应将系统用于违法违规、批量滥用或侵害第三方权益的用途。
项目优点
这个项目最大的优点是业务闭环完整。它不是一个只能调用图片接口的演示程序，而是围绕真实用户使用流程做了比较完整的产品化封装：用户可以通过 Telegram 完成注册入口、语言选择、图片生成、图片编辑、充值支付、余额消费、交易记录查看和推荐返现。对于运营者来说，这意味着项目可以直接承载一个小型 AI 生图服务的核心流程，减少从技术接口到可运营产品之间的二次开发成本。
项目的交互入口选择 Telegram，也带来了非常明显的使用便利性。用户不需要安装额外 App，也不需要打开复杂后台，只要进入 Bot 对话就能使用 AI 生图功能。对图片创作类服务来说，聊天式交互天然适合“描述需求、上传参考、等待结果、继续修改”的工作流，用户可以像和设计助手沟通一样逐步调整图片效果。
项目在计费设计上也比较实用。系统采用积分余额模式，将 USDT 充值金额转换为平台积分，再按图片生成或修改次数扣费。充值订单会自动添加随机小数金额，用于区分不同用户和不同订单的链上转账；计费服务会定时轮询 Trongrid API，检测 TRC20 转账到账后自动发放积分，并通知用户和管理员。这种设计减少了人工确认订单的工作量，也降低了用户错充、漏记和重复确认的概率。
图片生成链路采用本地 gpt-api 代理服务后，机器人可以优先读取本机保存的生成图片，避免每次都依赖外部图片 URL 下载。这对 Telegram 发送图片的稳定性和速度都有帮助，尤其是在图片生成结果较大、网络环境不稳定或代理服务与机器人部署在同一台机器上时，直接读本地文件会更加可靠。
项目还保留了较好的扩展空间。Telegram Bot、计费服务和图片代理服务是相对独立的模块，后续可以替换图片模型、增加新的计费规则、接入更多支付方式、扩展后台管理能力，或者把 JSON 文件存储升级为 SQLite、PostgreSQL、Git 私有仓库等持久化方案。对于想快速启动业务、同时又保留后续演进空间的团队来说，这种模块化结构比较友好。
营销卖点
这套 Telegram AI 生图机器人可以包装为一个“即开即用的 AI 图片创作助手”。用户只需要在 Telegram 中发送一句描述，就能快速生成高质量图片；如果对结果不满意，还可以继续发送修改要求，让系统基于上一张图继续调整。它把传统设计工具中复杂的参数、接口和操作步骤，压缩成了自然语言对话，适合面向普通用户、社群用户、跨境用户和轻量内容创作者推广。
对于运营者来说，项目的商业化链路非常直接。系统内置积分计费、USDT TRC20 充值、自动到账、交易流水、管理员加减积分和推荐返现能力，可以围绕“充值即用、按次消费、邀请赚钱”快速形成增长机制。用户每次生成或修改图片都会消耗积分，推荐人可以通过分享链接获得返现奖励，这让产品不仅能卖功能，也能通过社交传播扩大用户来源。
在功能卖点上，项目不只支持简单文生图，还支持参考图片生成、单图编辑、多图编辑和连续修改。用户可以上传一张或多张图片作为参考，再用文字描述想要的风格、构图、背景、文案或细节变化。这个能力非常适合头像设计、海报草图、商品图改造、社媒配图、设计灵感探索和轻量广告素材制作等场景。
多语言支持也是项目面向海外用户的重要卖点。系统已经内置简体中文、英文和俄文欢迎语与语言选择流程，新用户或长期未活跃用户进入时可以重新选择语言。这使得项目不仅适合中文社群，也可以面向更广泛的 Telegram 国际用户做分发和运营。
从部署角度看，项目提供一键启动、停止和健康检查脚本，降低了运维门槛。运营者可以通过 start.sh 同时拉起计费服务和 Telegram Bot，并通过 health-check.sh 检查 Telegram Bot、Billing Service、GPT API Proxy 和 TRON API 的状态。这种“能跑、能查、能停”的基础运维体验，有利于小团队或个人开发者快速上线验证。
架构介绍
项目采用三层协作架构：用户交互层、业务计费层和图片能力层。用户交互层由 Telegram Bot 承担，它负责接收用户命令、按钮点击、文本提示词和图片消息，并根据当前会话状态判断用户是在充值、生成图片、修改图片还是继续编辑。Bot 会在执行图片任务前向计费服务查询余额，余额充足后再调用图片服务，任务成功后完成扣费和结果返回。
业务计费层由 billing-service 提供，它是一个基于 Node.js Express 的轻量服务。该服务维护用户余额、充值订单、待检测转账、交易流水和推荐关系，并提供 /health、/balance/:userId、/deduct、/recharge、/order/:orderId、/transactions/:userId、/referral/:userId 等接口。充值时，服务会生成带随机小数的订单金额，并将订单加入待检测队列；后台定时任务会轮询 Trongrid TRC20 转账记录，匹配到账金额后自动完成订单、增加积分、写入流水并发送 Telegram 通知。
图片能力层由 gpt-api 提供，它以 Docker 服务方式运行在本地，向 Telegram Bot 暴露 OpenAI 兼容风格的 /v1/images/generations 和 /v1/images/edits 接口。Bot 的图片服务会根据配置把内部模型 gpt-m2 映射到本地的 gpt-image-2，并通过 GPT_API_BASE_URL 和 GPT_API_AUTH_KEY 调用代理接口。生成结果可以以 Base64 或 URL 形式返回，当代理服务与 Bot 同机部署时，Bot 会优先尝试读取 gpt-api/data/images 下的本地图片文件，从而减少网络下载带来的不稳定性。
在整体调用链路上，用户从 Telegram 发起请求后，Bot 会先检查用户状态和余额；如果是图片任务，Bot 会调用本地 gpt-api 生成或编辑图片；图片生成成功后，Bot 将结果发送回 Telegram，并在需要时保存最后一张图的数据，用于后续继续修改。充值链路则由 Bot 创建订单，计费服务记录订单并等待链上到账，到账后系统自动更新用户余额。这样的架构将用户体验、商业计费和模型能力解耦，既便于维护，也便于未来扩展。
结构说明
gpt-huatu/
├── README.md # 项目基础说明
├── PROJECT_ARTICLE.md # 完整项目介绍文章
├── start.sh # 一键启动脚本
├── stop.sh # 停止脚本
├── health-check.sh # 健康检查脚本
├── billing-service/ # Node.js 计费服务
│ ├── server.js # 计费 API、订单、TRON 轮询和通知逻辑
│ ├── check-limits.js # 限额检查相关脚本
│ ├── gen-openclaw-style.js # 图片生成辅助脚本
│ ├── package.json # Node.js 依赖声明
│ └── data/ # 用户、订单、流水和待检测转账数据
├── telegram-bot/ # Python Telegram Bot
│ ├── bot.py # Bot 启动入口
│ ├── config.py # 环境变量、模型、费用和语言配置
│ ├── handlers/commands.py # 命令、按钮、图片和充值流程处理
│ ├── services/billing.py # 计费服务客户端
│ ├── services/image.py # 图片生成与编辑服务封装
│ ├── services/language.py # 多语言偏好管理
│ └── data/ # 语言偏好等本地数据
└── gpt-api/ # 本地图片 API 代理服务
├── docker-compose.yml # Docker 部署配置
├── Dockerfile # 镜像构建文件
├── main.py # FastAPI 应用入口
├── api/ # API 路由
├── services/ # 账号、图片、代理、存储等服务逻辑
├── web/ # Next.js 管理与图片工作台前端
└── data/ # 账号、配置、日志和图片数据| 模块 | 技术栈 | 默认端口 | 主要职责 |
|---|---|---|---|
| Telegram Bot | Python、python-telegram-bot | 无固定端口 | 用户交互、会话状态、图片任务编排、充值入口 |
| Billing Service | Node.js、Express | 4313 | 余额、订单、扣费、充值检测、交易流水、推荐返现 |
| GPT API Proxy | FastAPI、Docker、Next.js | 3000 | OpenAI 兼容图片接口、本地图片保存、账号与代理管理 |
部署方式
部署前需要准备 Telegram Bot Token、图片能力代理所需的认证配置、TRC20 收款地址、Trongrid API Key、管理员 Telegram ID，以及基础运行环境。项目依赖 Node.js、Python 3.10 或更高版本，以及 Docker。推荐在服务器上创建项目根目录下的 .env 文件，把 TELEGRAM_BOT_TOKEN、OPENAI_API_KEY、BILLING_URL、GPT_API_BASE_URL、GPT_API_AUTH_KEY、TRONGRID_API_KEY、ADMIN_IDS、TRC20_ADDRESS、BILLING_PORT 等配置写入其中。
gpt-api 建议使用 Docker Compose 部署。进入 gpt-api 目录后，可以根据实际情况编辑 config.json、.env 和 docker-compose.yml，确认认证密钥、账号池、存储后端和端口映射。默认配置会将容器的 80 端口映射到宿主机 3000，并把 gpt-api/data 挂载到容器内用于保存账号、日志和图片文件。启动后，Telegram Bot 可以通过 GPT_API_BASE_URL=http://127.0.0.1:3000 调用本地图片代理服务。
计费服务和 Telegram Bot 可以通过项目根目录的 start.sh 一键启动。脚本会读取 .env 文件，检查 Node.js 和 Python 环境，初始化必要的数据目录和 JSON 文件，安装缺失依赖，然后启动 billing-service/server.js 与 telegram-bot/bot.py。启动完成后，脚本会检查计费服务健康接口、Telegram Bot 进程、chatgpt2api Docker 容器以及 Trongrid API 连通性，并把运行中的进程 ID 写入 .pids 文件，方便后续停止。
停止服务时可以执行 ./stop.sh，脚本会读取 .pids 并结束对应的计费服务和 Bot 进程。日常运维中可以执行 ./health-check.sh 查看系统状态，该脚本会检查 Telegram Bot 是否运行、计费服务 API 是否正常、GPT API Docker 容器是否运行、图片代理接口是否可响应、TRON API 是否可达，并输出当前用户和待处理订单等基础统计信息。
如果需要更稳定的生产部署，可以在现有脚本基础上接入 systemd、PM2、Supervisor、Docker Compose 或云服务器进程守护方案。对于数据持久化要求更高的场景，也可以将 gpt-api 的存储后端从默认 JSON 切换为 SQLite、PostgreSQL 或 Git 私有仓库，并为 billing-service/data 做定期备份，避免订单和用户余额数据丢失。
使用方式
用户进入 Telegram Bot 后，可以发送 /start 开始使用。系统会根据用户是否为新用户或长期未活跃用户，展示语言选择按钮，当前支持简体中文、英文和俄文。用户选择语言后，机器人会展示主菜单，包含 AI 生图、充值余额、个人中心、分享赚钱和帮助等入口。日常使用时，用户可以通过菜单按钮操作，也可以直接使用 /sc、/gt、/recharge、/me、/pdd 等命令。
进行文生图时，用户点击“AI 生图”，选择生成图片，然后输入完整的图片描述。系统会先检查用户积分余额，余额不足时提示充值，余额充足时调用图片代理服务生成图片，并把生成结果发送回 Telegram。生成成功后，用户可以点击“继续修改图片”，直接基于当前图片输入新的修改指令，例如更换背景、调整文字、增加装饰或改变风格。继续修改会按配置消耗较低积分，适合用户在同一张图上反复打磨。
进行图片编辑时，用户可以选择修改图片，然后上传需要修改的图片并在图片说明中写明修改要求。系统支持单张图片编辑，也支持多张图片作为参考图或组合编辑输入。对于多图消息，Bot 会短暂等待同一组相册图片收集完成，再统一提交给图片服务处理。这个流程适合用户上传商品图、设计稿、参考风格图或多张素材图，让 AI 根据文字要求生成新的结果。
充值时，用户可以发送 /recharge 或点击“充值余额”。机器人会提示用户输入 USDT 金额，计费服务随后创建 TRC20 充值订单，并返回收款地址、精确转账金额、到账积分和订单有效期。用户需要在有效期内向指定地址转入精确金额，系统会通过 Trongrid API 自动检测链上到账，匹配成功后自动增加积分并发送到账通知。由于订单金额会自动带随机小数，用户必须按机器人提示的完整金额转账，才能被系统准确识别。
用户可以通过 /me 查看个人中心，包括当前余额和最近交易记录；通过 /pdd 查看自己的邀请链接、推荐人数和返现收益。被邀请用户通过推荐链接进入 Bot 并完成满足条件的充值后，推荐人会获得积分返现。管理员还可以使用隐藏命令 /zs 对指定用户进行积分增减，便于处理补偿、活动赠送、测试账号或人工售后场景。
整体来看，用户侧只需要记住三件事：发送描述可以生成图片，发送图片加说明可以修改图片，余额不足时通过 USDT TRC20 充值即可继续使用。运营侧则可以通过配置积分价格、充值比例、推荐奖励、管理员账号和图片代理服务，快速搭建一套可收费、可推广、可持续运营的 AI 生图机器人服务。
暂无评论内容