# ecom-ai-image-generator

**Repository Path**: xtmpfc/ecom-ai-image-generator

## Basic Information

- **Project Name**: ecom-ai-image-generator
- **Description**: AI 生成电商主图与营销详情页的视觉生成 SaaS：双生图(T2I/I2I)、统一图像 Provider 抽象、预留 MiniMax 接入，文档驱动、开放核心。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ecom-ai-image-generator

AI 生成电商主图与营销详情页的视觉生成 SaaS。上传商品图或填写商品信息（标题、卖点、类目、规格），系统生成符合主流电商平台规范（淘宝 800×800、Amazon 白底等）的主图，并基于主图 + AI 文案拼装出结构化营销详情页。

> 本仓库当前以**产品 / 技术文档**落地为主（见 `doc/`），业务代码按路线图切片实现。采用 **open-core（开放核心）** 策略：核心引擎与文档开源，云端托管与计费闭源。

## 核心能力

- **双生图**：文生图（T2I）与图生图（I2I）同时支持，不偏废。
- **平台规范出图**：尺寸 / 背景可配置，直接过审上架。
- **详情页拼装**：主图 + AI 文案自动生成头图 / 卖点 / 参数 / 场景 / 保障模块，可视化编辑导出。
- **统一图像 Provider 抽象**：MiniMax 仅是其中一个可替换实现，未来可切自托管 SD / FLUX / ComfyUI 而不改业务代码。
- **Token 计量与额度告警**：按量 / 订阅变现的计费底座。

## 技术栈

- 前端：React + TypeScript + Tailwind CSS；详情页可视化编辑与导出采用 react-konva
- 后端：Python + FastAPI；异步任务默认 ARQ + Redis
- 存储：对象存储（OSS / S3 / 本地 + CDN）+ PostgreSQL 元数据
- 图像生成：统一 `ImageGenerationProvider` 抽象，当前以 MiniMax `image-01` 占位（后续接入 M3）

## 文档导航

详细需求、PRD、架构、API、数据库、路线图等见 [`doc/`](doc/) 目录：

| 阶段 | 文档 | 说明 |
|---|---|---|
| 入口 | [00-README](doc/00-README.md) | 文档集总览 |
| 定图纸 | [01-项目需求与背景](doc/01-项目需求与背景.md) | 需求与非功能清单 |
| 定图纸 | [02-PRD产品需求文档](doc/02-PRD产品需求文档.md) | 产品需求与验收标准 |
| 定图纸 | [10-视觉框架与参考](doc/10-视觉框架与参考.md) | 视觉框架 |
| 打地基 | [03-技术架构方案](doc/03-技术架构方案.md) | 技术栈与架构草案 |
| 打地基 | [04-API设计](doc/04-API设计.md) | 服务端接口 |
| 打地基 | [05-数据库设计](doc/05-数据库设计.md) | 数据模型 |
| 打地基 | [06-URL设计](doc/06-URL设计.md) | 前端路由 |
| 立规矩 | [07-生成范式与最佳实践](doc/07-生成范式与最佳实践.md) | 调研参考实现 |
| 立规矩 | [08-MiniMax接入占位](doc/08-MiniMax接入占位.md) | 接入契约与安全底线 |
| 立规矩 | [11-项目当前状态](doc/11-项目当前状态.md) | 当前状态 |
| 立规矩 | [12-开发规范与参考](doc/12-开发规范与参考.md) | 开发规范 |
| 路线图 | [09-里程碑与路线图](doc/09-里程碑与路线图.md) | 小步可验证 |
| 补充 | [13-待确认风险与行业范式补充建议](doc/13-待确认风险与行业范式补充建议.md) | 风险与范式 |

## 当前状态

本期以产品 / 技术文档落地为主，业务代码按路线图（`doc/09`）切片实现；MiniMax M3 token plan 接入点已预留，具体模型名与单价待接入时补全。

## 开源策略（open-core）

- **开源（本仓库）**：文档集、统一 Provider 抽象、开源模型（SD / FLUX / ComfyUI）接入管线、自部署能力。
- **闭源（未来 `cloud/`，不在此仓库）**：托管 SaaS 本体、token 计量与多租户计费、精选商业提示词模板库、厂商密钥与参数、用户数据与付费模板。

## License

[MIT](LICENSE) —— 个人技术品牌项目，采用最易被采用、最省心的协议。