---

让传播不再需要门槛，让创作从未如此简单

红墨首页

使用红墨生成的各类小红书封面 - AI驱动，风格统一，文字准确

前段时间默子在 Linux.do 发了一个用 Nano banana Pro 做 PPT 的帖子,收获了 600 多个赞。很多人用🍌Nano banana Pro 去做产品宣传图、直接生成漫画等等。我就在想:为什么不拿🍌2来做点更功利、更刺激的事情?

于是就有了这个项目。一句话一张图片生成小红书图文

---

---

• 语言: Python 3.11+
• 框架: Flask
• AI 模型:
  • Gemini 3 (文案生成)
  • 🍌Nano banana Pro (图片生成)
• 包管理: uv

• 框架: Vue 3 + TypeScript
• 构建: Vite
• 状态管理: Pinia

---

最简单的部署方式，一行命令即可启动：

docker run -d -p 12398:12398 -v ./history:/app/history -v ./output:/app/output histonemax/redink:latest

访问 http://localhost:12398，在 Web 界面的设置页面配置你的 API Key 即可使用。

使用 docker-compose（可选）：

下载 docker-compose.yml 后：

docker-compose up -d

Docker 部署说明：

• 容器内不包含任何 API Key，需要在 Web 界面配置
• 使用 -v ./history:/app/history 持久化历史记录
• 使用 -v ./output:/app/output 持久化生成的图片
• 可选：挂载自定义配置文件 -v ./text_providers.yaml:/app/text_providers.yaml

---

前置要求：

• Python 3.11+
• Node.js 18+
• pnpm
• uv

git clone https://github.com/HisMax/RedInk.git
cd RedInk

复制配置模板文件：

cp text_providers.yaml.example text_providers.yaml
cp image_providers.yaml.example image_providers.yaml

编辑配置文件，填入你的 API Key 和服务配置。也可以启动后在 Web 界面的设置页面进行配置。

uv sync

cd frontend
pnpm install

启动后端:

uv run python -m backend.app

访问: http://localhost:12398

启动前端:

cd frontend
pnpm dev

访问: http://localhost:5173

---

1. 输入主题: 在首页输入想要创作的主题,如"如何在家做拿铁"
2. 生成大纲: AI 自动生成 6-9 页的内容大纲
3. 编辑确认: 可以编辑和调整每一页的描述
4. 生成图片: 点击生成,实时查看进度
5. 下载使用: 一键下载所有图片

• 上传参考图片: 适合品牌方,保持品牌视觉风格
• 修改描述词: 精确控制每一页的内容和构图
• 重新生成: 对不满意的页面单独重新生成

---

项目支持两种配置方式：

1. Web 界面配置（推荐）：启动服务后，在设置页面可视化配置
2. YAML 文件配置：直接编辑配置文件

配置文件: text_providers.yaml

# 当前激活的服务商
active_provider: openai

providers:
  # OpenAI 官方或兼容接口
  openai:
    type: openai_compatible
    api_key: sk-xxxxxxxxxxxxxxxxxxxx
    base_url: https://api.openai.com/v1
    model: gpt-4o

  # Google Gemini（原生接口）
  gemini:
    type: google_gemini
    api_key: AIzaxxxxxxxxxxxxxxxxxxxxxxxxx
    model: gemini-2.0-flash

配置文件: image_providers.yaml

# 当前激活的服务商
active_provider: gemini

providers:
  # Google Gemini 图片生成
  gemini:
    type: google_genai
    api_key: AIzaxxxxxxxxxxxxxxxxxxxxxxxxx
    model: gemini-3-pro-image-preview
    high_concurrency: false  # 高并发模式

  # OpenAI 兼容接口
  openai_image:
    type: image_api
    api_key: sk-xxxxxxxxxxxxxxxxxxxx
    base_url: https://your-api-endpoint.com
    model: dall-e-3
    high_concurrency: false

• 关闭（默认）：图片逐张生成，适合 GCP 300$ 试用账号或有速率限制的 API
• 开启：图片并行生成（最多15张同时），速度更快，但需要 API 支持高并发

⚠️ GCP 300$ 试用账号不建议启用高并发，可能会触发速率限制导致生成失败。

---

1. API 配额限制:

   • 注意 Gemini 和图片生成 API 的调用配额
   • GCP 试用账号建议关闭高并发模式

2. 生成时间:

   • 图片生成需要时间,请耐心等待（不要离开页面）

---

欢迎提交 Issue 和 Pull Request!

如果这个项目对你有帮助,欢迎给个 Star ⭐

• 支持更多图片格式，例如一句话生成一套PPT什么的
• 历史记录管理优化
• 导出为各种格式(PDF、长图等)

---

• 🏗️ 后端架构重构：拆分单体路由为模块化蓝图（history、images、generation、outline、config）
• 🏗️ 前端组件重构：提取可复用组件（ImageGalleryModal、OutlineModal、ShowcaseBackground等）
• ✨ 优化首页设计，移除冗余内容区块
• ✨ 背景图片预加载和渐入动画，提升加载体验
• ✨ 历史记录持久化支持（Docker部署）
• 🔧 修复历史记录预览和大纲查看功能
• 🔧 优化Modal组件可见性控制
• 🧪 新增65个后端单元测试

• ✨ 新增 Docker 支持，一键部署
• ✨ 发布官方 Docker 镜像到 Docker Hub: histonemax/redink
• 🔧 Flask 自动检测前端构建产物，支持单容器部署
• 🔧 Docker 镜像内置空白配置模板，保护 API Key 安全
• 📝 更新 README，添加 Docker 部署说明

• ✨ 新增版权信息展示，所有页面显示开源协议和项目链接
• ✨ 优化图片重新生成功能，支持单张图片重绘
• ✨ 重新生成图片时保持风格一致，传递完整上下文（封面图、大纲、用户输入）
• ✨ 修复图片缓存问题，重新生成的图片立即刷新显示
• ✨ 统一文本生成客户端接口，支持 Google Gemini 和 OpenAI 兼容接口自动切换
• ✨ 新增 Web 界面配置功能，可视化管理 API 服务商
• ✨ 新增高并发模式开关，适配不同 API 配额
• ✨ API Key 脱敏显示，保护密钥安全
• ✨ 配置自动保存，修改即时生效
• 🔧 调整默认 max_output_tokens 为 8000，兼容更多模型限制
• 🔧 优化前端路由和页面布局，提升用户体验
• 🔧 简化配置文件结构，移除冗余参数
• 🔧 优化历史记录图片显示，使用缩略图节省带宽
• 🔧 历史记录重新生成时自动从文件系统加载封面图作为参考
• 🐛 修复 store.updateImage 方法缺失导致的重新生成失败问题
• 🐛 修复历史记录加载时图片 URL 拼接错误
• 🐛 修复下载功能中原图参数处理问题
• 🐛 修复图片加载 500 错误问题

---

• GitHub Issues: https://github.com/HisMax/RedInk/issues

• Email: histonemax@gmail.com
• 微信: Histone2024（添加请注明来意）
• GitHub: @HisMax

---

本项目采用 CC BY-NC-SA 4.0 协议进行开源

你可以自由地：

• ✅ 个人使用 - 用于学习、研究、个人项目
• ✅ 分享 - 在任何媒介以任何形式复制、发行本作品
• ✅ 修改 - 修改、转换或以本作品为基础进行创作

但需要遵守以下条款：

• 📝 署名 - 必须给出适当的署名，提供指向本协议的链接，同时标明是否对原始作品作了修改
• 🚫 非商业性使用 - 不得将本作品用于商业目的
• 🔄 相同方式共享 - 如果你修改、转换或以本作品为基础进行创作，你必须以相同的协议分发你的作品

如果你希望将本项目用于商业目的（包括但不限于）：

• 提供付费服务
• 集成到商业产品
• 作为 SaaS 服务运营
• 其他盈利性用途

请联系作者获取商业授权：

• 📧 Email: histonemax@gmail.com
• 💬 微信: Histone2024（请注明"商业授权咨询"）

默子会根据你的具体使用场景提供灵活的商业授权方案。

---

本软件按"原样"提供，不提供任何形式的明示或暗示担保，包括但不限于适销性、特定用途的适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责。

---

• Google Gemini - 强大的文案生成能力
• 图片生成服务提供商 - 惊艳的图片生成效果
• Linux.do - 优秀的开发者社区

---

默子 (Histone) - AI 创业者 | Python & 深度学习

• 🏠 位置: 中国杭州
• 🚀 状态: 创业中
• 💡 专注: Transformers、GANs、多模态AI
• 📧 Email: histonemax@gmail.com
• 💬 微信: Histone2024
• 🐙 GitHub: @HisMax

"让 AI 帮我们做更有创造力的事"

---

如果这个项目帮到了你,欢迎分享给更多人! ⭐

有任何问题或建议,欢迎提 Issue 或者在 Linux.do 原帖讨论!