Telegram +GPT的AI 生图机器人

Telegram AI 生图机器人是一套面向 Telegram 用户的 AI 图片生成与图片编辑服务系统。项目以 Telegram 机器人作为主要交互入口,用户可以直接在聊天窗口中完成文生图、参考图生成、图片修改、多图组图编辑、继续修改、余额查询、USDT 充值和邀请返现等操作。相比传统网页工具,这套系统把 AI 生图能力放进了用户日常使用的聊天场景里,降低了使用门槛,也让付费、生成、修改和交付形成一条完整闭环。

演示机器人: @zpsps_bot

整个项目由三个核心服务组成: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 生图机器人服务。

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容