Bingo Image Tools

专业的 AI 图片处理工具集，支持抠图、证件照、放大、老照片修复等多种功能。

---

特性

• 🤖 AI 驱动 - 基于智谱 AI CogView 强力驱动
• 🌐 多语言 - 中文/英文双语界面
• ⚡ 极速处理 - 基于 Vite 构建，秒级响应
• 🔒 安全部署 - API Key 通过环境变量管理，不暴露在前端
• 📱 响应式 - 完美支持桌面和移动设备

---

功能列表

功能	描述
📉 压缩图片	极速减小体积并保持清晰
✨ AI 放大	智能填补细节，超清重构
🕰️ 老照片修复	划痕消除、上色、画质重塑
✂️ 去除背景	发丝级抠图，支持复杂背景
🪄 魔术消除	路人、水印、杂物无痕涂抹
👤 证件照	全规格支持，智能排版美颜
📏 调整大小	精确像素控制，支持自由裁剪
🔄 格式转换	支持 JPG/PNG/WebP 互相转换
🎨 文生图	想象力变现，支持多种画风

---

快速开始

本地运行

前置要求： Node.js 18+

1. 安装依赖

   npm install

2. 配置环境变量

   cp .env.example .env.local

   编辑 .env.local，填入你的 API Key：

   # 智谱AI API Key
   VITE_BIGMODEL_API_KEY=你的_智谱API_Key

3. 启动开发服务器

   npm run dev

   访问 http://localhost:3000

---

在线部署

一键部署到 Vercel（推荐）

部署前准备： 在 Vercel 项目设置中配置环境变量：

• BIGMODEL_API_KEY = 你的智谱API Key

详细部署步骤请查看 部署指南

其他平台

本项目基于 Vite 构建，可以部署到任何支持静态网站托管的平台：

• Netlify
• Cloudflare Pages
• GitHub Pages
• 自建服务器

---

项目结构

bingoimagetools/
├── api/                    # Vercel Edge Functions
│   └── ai.ts              # AI API 代理（保护 API Key）
├── public/                # 静态资源
├── src/                   # 源代码
│   ├── App.tsx           # 主应用
│   └── bigmodelService.ts # 智谱AI 服务封装
├── .env.example          # 环境变量模板
├── vercel.json          # Vercel 配置
├── vite.config.ts       # Vite 配置
└── package.json         # 项目配置

---

技术栈

• 框架：React 19 + TypeScript
• 构建：Vite 6
• 样式：Tailwind CSS
• AI：智谱AI CogView
• 部署：Vercel

---

获取 API Key

智谱AI API

1. 访问 智谱AI 开放平台
2. 注册/登录账号
3. 在控制台创建 API Key
4. 复制到 .env.local

---

安全说明

• ✅ .env.local 已在 .gitignore 中，不会被提交到 Git
• ✅ API Key 通过环境变量注入，不会硬编码在代码中
• ✅ 生产环境使用 Vercel Edge Functions 保护 API Key
• ⚠️ 永远不要将 .env.local 或包含真实 API Key 的文件提交到公开仓库

---

构建命令

# 开发
npm run dev

# 构建
npm run build

# 预览构建结果
npm run preview

---

常见问题

Q: 部署后 API 调用失败？

A: 检查：

1. Vercel 环境变量 BIGMODEL_API_KEY 是否正确配置
2. API Key 是否有效且有足够额度
3. 重新部署项目使环境变量生效

Q: 可以使用其他 AI 服务吗？

A: 可以。参考 src/bigmodelService.ts 的接口实现，添加新的服务类。

---

贡献

欢迎提交 Issue 和 Pull Request！

---

许可证

MIT License

---

链接

• 在线演示
• 部署指南

---

Made with ❤️ by Jiangbingo