# AIPainting

**Repository Path**: BidingCC/aipainting

## Basic Information

- **Project Name**: AIPainting
- **Description**: AI绘画是一个基于即梦AI绘画的快速绘图的工具，它能够通过简单提示词快速生成高质量图像，其风格覆盖广泛，写实、卡通、插画等皆可驾驭，充分释放您的创作潜能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-04
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
   <br />
   <br />
   <img src="./images/1.png" width="90%" />
 </p>
 
 <h1 align="center">🎨 AI 绘画应用</h1>
 
 <p align="center">
   <img src="https://img.shields.io/badge/version-1.0.1-blue.svg" alt="Version">
   <img src="https://img.shields.io/badge/license-BuildingAI-green.svg" alt="License">
   <img src="https://img.shields.io/badge/Nuxt-3-00DC82.svg?logo=nuxt.js&logoColor=white" alt="Nuxt 3">
   <img src="https://img.shields.io/badge/NestJS-E0234E.svg?logo=nestjs&logoColor=white" alt="NestJS">
   <img src="https://img.shields.io/badge/AI-%E5%8D%B3%E6%A2%A6%E5%BC%95%E6%93%8E-FF6B35.svg" alt="Jimeng AI">
 </p>
 
 <p align="center">
   <a href="https://www.buildingai.cc/plugin" target="_blank"><strong>👉 立即体验应用市场</strong></a>
 </p>
 
 <p align="center">
   <strong>🚀 一款集成于 BuildingAI 平台的 AI 绘画插件，支持文生图与图生图，多尺寸、多张生成，让每个人都能轻松创作高质量 AI 图片。</strong>
 </p>
 
 <p align="center">
   <em>输入提示词或上传参考图，即可在短时间内生成 1-4 张图片，支持保存记录、再次生成与灵感广场。</em>
 </p>
 
 <p align="center">
   <img src="./images/2.png" width="19%" />
   <img src="./images/3.png" width="19%" />
   <img src="./images/4.png" width="19%" />
   <img src="./images/5.png" width="19%" />
 </p>
 
 ---
 
 ## 📖 目录
 - [界面预览](#-界面预览)
 - [产品介绍](#-产品介绍)
   - [什么是 AI 绘画插件？](#什么是-ai-绘画插件)
   - [核心价值](#核心价值)
   - [适用场景](#适用场景)
 - [功能特性](#-功能特性)
 - [技术架构](#-技术架构)
   - [技术栈](#技术栈)
   - [核心流程](#核心流程)
 - [操作手册](#-操作手册)
   - [用户端使用指南](#用户端使用指南)
   - [管理后台配置](#管理后台配置)
 - [积分体系](#-积分体系)
 - [常见问题](#-常见问题)
 
 ---
 
 ## 🖼️ 界面预览
 
 ### 灵感广场
 
 浏览精选灵感图片与提示词，快速获得创作方向。
 
 <p align="center">
   <img src="./images/8.png" width="90%" />
 </p>
 
 ### 我的作品（生成记录）
 
 自动保存生成记录，支持查看、再次生成与删除。
 
 <p align="center">
   <img src="./images/7.png" width="90%" />
 </p>

  ### 后台灵感管理
 
 支持添加、编辑、删除灵感内容。
 
 <p align="center">
   <img src="./images/6.png" width="90%" />
 </p>
 
 ---
 
 ## 🎯 产品介绍
 
 ### 什么是 AI 绘画插件？
 
 **BuildingAI Paint** 是一款集成于 BuildingAI 平台的 AI 绘画生成插件。用户只需输入文字描述（Prompt），或上传参考图片，即可快速生成高质量的 AI 图片，并自动沉淀到「生成记录」，便于二次创作与管理。
 
 插件后端对接即梦 AI（火山引擎）相关能力，并通过 BuildingAI 的密钥池与积分体系实现**可控成本**与**可运营配置**。
 
 ### 核心价值
 
 | 价值点 | 说明 |
 |--------|------|
 | 🎨 **低门槛创作** | 不需要专业绘画技能，描述想法即可产出图片 |
 | ⚡ **快速生成** | 支持一次生成 1-4 张图，提升试错效率 |
 | 🖼️ **文生图/图生图** | 支持参考图片输入，风格与构图更可控 |
 | 📚 **灵感驱动** | 内置灵感广场与随机示例，减少「不会写提示词」的阻碍 |
 | 💰 **成本可控** | 基于积分（算力）扣费，可在后台灵活配置 |
 
 ### 适用场景
 
 - 📱 **自媒体配图** - 公众号/小红书/短视频封面快速产出
 - 🛒 **电商营销** - 产品氛围图、场景图、活动海报元素生成
 - 🎮 **游戏/小说设定** - 角色、场景、道具概念图生成
 - 🎨 **设计灵感** - UI/插画/海报风格探索与变体生成
 - 🧑‍🏫 **教育培训** - 教学插图、案例示意图快速制作
 
 ---
 
 ## ✨ 功能特性
 
 ### 核心功能
 
 | 功能 | 描述 | 备注 |
 |------|------|------|
 | **文生图 (Text-to-Image)** | 输入提示词生成图片 | `prompt` 必填 |
 | **图生图 (Image-to-Image)** | 上传参考图辅助生成 | `referenceImage` 可选 |
 | **自定义尺寸** | 支持设置 `width`/`height` | 默认 512（服务端兜底） |
 | **多张生成** | 单次生成 1-4 张 | `numImages` 超出会自动兜底 |
 | **生成记录** | 自动保存每次生成结果 | 支持查看/删除/再次生成 |
 | **随机示例** | 一键获取随机提示词示例 | 来自后台「绘画示例管理」 |
 
 ### 后台运营能力
 
 | 功能 | 描述 |
 |------|------|
 | 🔑 **密钥池绑定** | 后台选择密钥池（即梦AI），由平台统一管理密钥 |
 | ⚙️ **计费配置** | 配置标清/高清的单张算力消耗（`sdPower`/`hdPower`） |
 | 🧾 **生成记录管理** | 查询所有用户生成记录，支持筛选与批量删除 |
 | 🌟 **灵感管理** | 新增/编辑/启用/禁用/删除灵感内容 |
 | 📝 **示例管理** | 批量维护随机示例提示词库 |
 
 ---
 
 ## 🛠 技术架构
 
 ### 技术栈
 
 - **前端框架**: Nuxt 3 + Vue 3 + TypeScript
 - **UI 组件**: BuildingAI UI 组件库
 - **后端框架**: NestJS
 - **数据库**: PostgreSQL + TypeORM（扩展实体）
 - **AI 引擎**: 即梦 AI（火山引擎）
 - **存储服务**: BuildingAI FileStorage（用于生成图与参考图存储）
 
 ### 核心流程
 
 #### 绘画生成流程图
 
 ```mermaid
 sequenceDiagram
     participant User as 用户
     participant Frontend as 前端
     participant Backend as 后端
     participant JimengAPI as 即梦API
     participant Storage as 存储
 
     User->>Frontend: 1.输入提示词/上传参考图/选择参数
     Frontend->>Backend: 2.提交生成请求（含算力消耗）
     Backend->>Backend: 3.校验用户积分（算力）余额
     Backend->>Backend: 4.写入生成记录（状态=生成中）
     Backend->>JimengAPI: 5.多次调用生成
     JimengAPI-->>Backend: 6.返回图片URL
     Backend->>Storage: 7.保存图片/构建可访问URL
     Backend->>Backend: 8.更新记录（成功/失败），扣除积分
     Backend-->>Frontend: 9.返回结果
     Frontend-->>User: 10.展示生成图片/记录
 ```
 
 ## 📱 操作手册
 
 ### 用户端使用指南
 
 #### 第一步：进入 AI 绘画页面
 
 在 BuildingAI 前台进入「AI 绘画」页面，主要包含：
 
 - **灵感广场**: 浏览灵感内容
 - **生成与作品**: 输入画面描述并查看历史生成记录
 
 #### 第二步：输入画面描述
 
 在输入框中尽量详细地描述你想生成的画面内容（越具体，越容易生成出符合预期的结果）。
 
 好的描述示例：
 一只可爱的橘猫坐在窗台上，阳光洒在毛发上，写实风格，浅景深，温暖色调
 
 描述要素建议：
 - 主体：人物/动物/物体
 - 风格：写实/动漫/油画/赛博朋克等
 - 光照：日光/夜景/霓虹/逆光等
 - 镜头：特写/广角/俯拍/景深
 - 细节：服装/材质/背景元素
 
 #### 第三步：可选上传参考图片（图生图）
 
 如果你希望画面构图或风格更接近目标图，可以上传一张参考图片来辅助生成。
 
 #### 第四步：选择生成设置
 
 你可以根据用途进行选择：
 
 - **图片尺寸/比例**：用于控制最终图片是横图、竖图还是方图
 - **生成数量**：一次生成几张图（通常 1-4 张）
 - **预计消耗**：页面会显示预计消耗的积分（算力），确认无误后再开始生成
 
 #### 第五步：生成、查看与再次生成
 
 点击「生成」后，系统会开始处理（通常需要几十秒到几分钟，具体取决于排队与图片数量）。生成完成后你可以：
 
 - **查看生成结果**（多张图）
 - **再次生成**（用相同描述快速再出一组）
 - **删除记录**（同时清理存储中的图片文件）
 
 ### 管理后台配置
 
 管理员可在控制台对插件进行运营与配置：
 
 #### 1. 密钥池绑定（必配）
 
 路径：控制台 → AI绘画 → 配置管理
 
 - **选择密钥池**：选择“即梦AI”对应的密钥池
 - **确保密钥可用**：在密钥池中按平台提示完成密钥信息配置，并确保存在可用密钥
 
 #### 2. 计费配置
 
 路径：控制台 → AI绘画 → 配置管理
 
 你可以设置不同清晰度下的**单张图片**消耗。
 
 - **生成多张图片时**：系统会按生成张数累计消耗
 - **建议**：先用较小消耗进行测试，确认运行稳定后再逐步调整
 
 #### 3. 生成记录管理
 
 路径：控制台 → AI绘画 → 生成记录
 
 支持：
 
 - 按关键词/用户/状态/时间范围筛选
 - 查看参考图与多张生成结果
 - 单条删除与批量删除
 
 #### 4. 灵感管理
 
 路径：控制台 → AI绘画 → 灵感管理
 
 支持：新增/编辑/启用/禁用/删除，并支持批量操作。
 
 #### 5. 随机示例管理
 
 路径：控制台 → AI绘画 → 示例管理
 
 支持批量维护示例提示词，用于前台「随机示例」能力。
 
 ---
 
 ## 💰 积分体系
 
 插件使用 BuildingAI 平台的积分（算力）体系扣费。默认消耗由后台配置控制：
 
 | 规格 | 默认单张积分 | 总消耗计算 |
 |------|--------------|------------|
 | 标清 | `100` | `100 × 数量` |
 | 高清 | `100` | `100 × 数量` |
 
 ---
 
 ## ❓ 常见问题
 
 ### Q1: 生成失败怎么办？
 
 - ✅ 检查用户积分（算力）余额是否充足
 - ✅ 检查后台是否已绑定正确的密钥池（即梦AI）
 - ✅ 检查密钥字段是否齐全：`AccessKeyID` / `SecretAccessKey` / `apiUrl`
 - ✅ 尝试减少生成张数或简化提示词
 
 ### Q2: 为什么要传 `useComputingPower`？
 
 这是插件当前的计费口径：前端根据后台配置计算本次预计扣费并传入，后端会再次校验余额并在生成成功后扣除。
 
 ### Q3: 支持生成几张图片？
 
 当前支持 `1-4` 张，超出范围会在后端自动兜底为 `1` 张。
 
 ### Q4: 删除记录会不会把图片也删掉？
 
 会。删除记录时会同时删除生成图片与参考图片的存储文件（如果存在）。
 
 ---
 
 ## 📄 许可证
 
 本项目基于 BuildingAI 许可证发布。
 
 ---
 
 ## 🤝 联系我们
 
 - **应用市场官网**: [https://www.buildingai.cc/plugin](https://www.buildingai.cc/plugin)
 - **作者**: buildingaiTeam
 ---
 
 <p align="center">
   <strong>🎨 让 AI 把你的灵感变成作品！</strong>
 </p>