SnapAI

从终端生成高质量的方形应用图标艺术品 —— 专为React Native和Expo构建。

SnapAI 是一个开发者友好的命令行工具（CLI），可直接连接以下提供商：

• OpenAI Images (gpt-1.5 → gpt-image-1.5, gpt-1 → gpt-image-1)
• Google Nano Banana (Gemini 图像模型) —— 通过 --model banana 选择

工作流程特意设计为仅支持方形：始终为 1024x1024 (1:1)，以匹配 iOS/Android 图标需求并避免调整大小的麻烦。

功能 ✨

• 快速：几秒钟内生成图标。无需界面。无需账户。
• 最新图像模型：
  • OpenAI:
    • gpt-1.5 (底层使用 gpt-image-1.5)
    • gpt-1 (底层使用 gpt-image-1)
  • Google Nano Banana (Gemini):
    • 普通版：gemini-2.5-flash-image
    • 专业版：gemini-3-pro-image-preview
• 面向 iOS + Android：提示词增强针对应用图标风格输出进行了优化。
• 质量控制：
  • OpenAI: --quality auto|high|medium|low (别名：hd → high, standard → medium)
  • Nano Banana 专业版：--quality 1k|2k|4k
• 开发者体验（DX）友好：只是一个 CLI（也非常适合 CI/CD（持续集成/持续部署））。
• 隐私优先：无遥测，无追踪。使用您的 API 密钥并将请求直接发送给您选择的提供商。

视频教程 🎥

在 YouTube 上观看

阅读：介绍 Code With Beto Skills

安装 📦

# 推荐（无需安装）
npx snapai --help

# 或者全局安装
npm install -g snapai

重要 🔑
您需要至少一个API 密钥：

• OpenAI (用于 gpt-1.5 → gpt-image-1.5, gpt-1 → gpt-image-1)
• Google AI Studio (用于 Google Nano Banana / Gemini，通过 --model banana)

SnapAI 仅支持 CLI，并将请求直接发送给您选择的提供商。

快速开始（第一个图标） ⚡

npx snapai icon --prompt "minimalist weather app with sun and cloud"

输出默认为 ./assets（带时间戳的文件名）。

注意 📝
模型仍可能绘制带有视觉留白（空边框）的主体。这是正常的。
SnapAI 默认避免强制包含 "icon" / "logo" 等词汇以减少留白。
如果您想要更“像图标”的构图，请使用 --use-icon-words 启用。

提供商与模型（“banana”的含义） 🧠

SnapAI 通过 --model 暴露提供商：

提供商	SnapAI 参数	底层模型	备注
OpenAI (最新版)	--model gpt-1.5	gpt-image-1.5	始终为 1:1 方形 1024x1024，背景/输出控制
OpenAI (旧版)	--model gpt-1	gpt-image-1	同上控制
Google Nano Banana (普通版)	--model banana	gemini-2.5-flash-image	始终 1 张图像，方形输出
Google Nano Banana 2	--model banana-2	gemini-3.1-flash-image-preview	1 张图像，思考配置，1K 输出
Google Nano Banana (专业版)	--model banana --pro	gemini-3-pro-image-preview	通过 --quality 1k/2k/4k 设置质量层级，通过 -n 设置多张

提示 💡
如果您想快速获取多种变体，请使用 OpenAI (-n) 或 Banana Pro (--pro -n ...)。

设置 🔐

您可以将密钥存储在本地（开发机），或在运行时提供（CI/CD）。

本地配置（写入 ~/.snapai/config.json）

snapai config --openai-api-key "sk-your-openai-api-key"
snapai config --google-api-key "your-google-ai-studio-key"

snapai config --show

CI/CD 密钥（推荐）

使用环境变量，这样不会写入磁盘：

export SNAPAI_API_KEY="sk-..."
export SNAPAI_GOOGLE_API_KEY="..."

# 也支持：
# export OPENAI_API_KEY="sk-..."
# export GEMINI_API_KEY="..."

GitHub Actions 示例：

- name: Generate app icon
  run: npx snapai icon --prompt "minimalist weather app with sun and cloud" --output ./assets/icons
  env:
    SNAPAI_API_KEY: ${{ secrets.SNAPAI_API_KEY }}

您也可以按命令传递密钥（不持久化）：

npx snapai icon --openai-api-key "sk-..." --prompt "modern app artwork"
npx snapai icon --model banana --google-api-key "..." --prompt "modern app artwork"

用法 🚀

通用（推荐）

# 默认 (OpenAI)
npx snapai icon --prompt "modern fitness tracker with heart rate monitor"

# 输出目录
npx snapai icon --prompt "professional banking app with secure lock" --output ./assets/icons

# 风格提示（增强后追加）
npx snapai icon --prompt "calculator app" --style minimalism

# 预览最终生成的提示词（不生成图像）
npx snapai icon --prompt "calculator app" --raw-prompt --prompt-only
npx snapai icon --prompt "calculator app" --prompt-only
npx snapai icon --prompt "calculator app" --style minimalism --prompt-only

OpenAI (gpt-1.5 / gpt-1)

# 多种变体
npx snapai icon --prompt "app icon concept" --model gpt-1.5 -n 3

# 更高画质
npx snapai icon --prompt "premium app icon" --quality high

# 透明背景 + 输出格式
npx snapai icon --prompt "logo mark" --background transparent --output-format png

Google Gemini (gemini-2.5-flash-image / gemini-3-pro-image-preview)

# 普通版 (1 张图像)
npx snapai icon --prompt "modern app artwork" --model banana

# 专业版 (多张图像 + 画质层级)
npx snapai icon --prompt "modern app artwork" --model banana --pro --quality 2k -n 3

Nano Banana 备注：

• 普通模式 始终生成 1 张图像（无 -n，无 --quality 层级）。
• 专业模式 支持 多张图像 (-n) 和 高清层级 (--quality 1k|2k|4k)。
• 输出始终为 方形。

提示词技巧（小改动，大影响） 📝

• 先描述产品，再描述风格：
  • “一款金融应用，盾牌 + 对勾，现代，干净渐变”
• 如果看到太多空边框：
  • 移除 "icon" / "logo" 等词汇（默认行为），或者保持关闭并明确说明“填满画面”
• 使用 --style 进行渲染/材质提示（示例：minimalism, material, pixel, kawaii, cute, glassy, neon）

注意 📝
如果您传递 --style，样式系统将被视为硬性约束，优先级高于提示词中的其他措辞。
尽量避免与所选样式_冲突_的提示词（例如 --style minimalism + “霓虹发光”），否则模型可能会产生不一致的结果。

命令参考 📚

snapai icon 参数

参数	简写	默认值	描述
--prompt	-p	必需	生成图标的描述
--output	-o	./assets	输出目录
--model	-m	gpt-1.5	gpt-1.5/gpt-1 (OpenAI) 或 banana (Google Nano Banana)
--quality	-q	auto	GPT: auto/high/medium/low (别名：hd, standard)。Banana Pro: 1k/2k/4k
--background	-b	auto	背景 (transparent, opaque, auto) (仅限 OpenAI)
--output-format	-f	png	输出格式 (png, jpeg, webp) (仅限 OpenAI)
--n	-n	1	图片数量 (最大 10)。对于普通 Banana，必须为 1。
--moderation		auto	内容过滤 (low, auto) (仅限 OpenAI)
--prompt-only		false	预览最终提示词和配置而不生成图像
--raw-prompt	-r	false	原样发送提示词 (无 SnapAI 增强/约束)。如果设置了样式，样式仍然适用
--style	-s		渲染风格提示，附加在增强之后
--use-icon-words	-i	false	在增强中包含 "icon" / "logo" (可能会增加内边距)
--pro	-P	false	启用 Nano Banana Pro (仅限 banana)
--openai-api-key	-k		OpenAI API 密钥覆盖 (不持久化)
--google-api-key	-g		Google API 密钥覆盖 (不持久化)

示例（真实输出）🖼️

提示词	结果	命令
minimalist weather app with sun and cloud		npx snapai icon --prompt "minimalist weather app with sun and cloud" --model gpt-1.5
premium banking app, shield + checkmark, clean gradients		npx snapai icon --prompt "premium banking app, shield + checkmark, clean gradients" --model gpt-1.5
calendar app, simple date grid, clean illustration		npx snapai icon --prompt "calendar app, simple date grid, clean illustration" --model gpt-1
notes app, pen + paper, minimal, friendly		npx snapai icon --prompt "notes app, pen + paper, minimal, friendly" --model gpt-1
music player app, abstract sound wave, clean shapes		npx snapai icon --prompt "music player app, abstract sound wave, clean shapes" --model banana
camera app, lens icon, simple concentric circles		npx snapai icon --prompt "camera app, lens icon, simple concentric circles" --model banana
finance app, secure lock, clean illustration, bold silhouette		npx snapai icon --prompt "finance app, secure lock, clean illustration, bold silhouette" --model banana --pro
photo editor app, magic wand + spark, simple shapes, modern gradients		npx snapai icon --prompt "photo editor app, magic wand + spark, simple shapes, modern gradients" --model banana --pro

由 Code with Beto 打造 👋

SnapAI 由 Beto 制作 —— 我构建开源工具并教授 React Native。如果你正在学习 React Native，我有一套 综合课程，包含真实项目、终身访问权限以及专属 Discord 社区。已有数百名开发者加入。

YouTube · Discord · 通讯

隐私与安全 🔒

• SnapAI 不 附带遥测或分析数据。
• SnapAI 根据 --model 设置，直接 向 OpenAI 或 Google 发送请求。
• SnapAI 不运行后端，也不收集你的提示词或图像。
• 除非你运行了 snapai config ... (或通过环境变量/标志在运行时提供)，否则 API 密钥仅本地存储。

警告 ⚠️
切勿将 API 密钥提交到 Git。在 CI (持续集成) 中使用环境变量。

开发 🛠️

• 开发环境搭建
• 发布指南

git clone https://github.com/betomoedano/snapai.git
cd snapai && pnpm install && pnpm run build
./bin/dev.js --help

贡献指南 🤝

• 报告错误：GitHub Issues
• 提出功能建议：GitHub Issues
• 改进文档/代码：查看 CONTRIBUTING.md

许可证 📄

MIT

SnapAI 快速上手指南

SnapAI 是一个专为 React Native 和 Expo 开发者设计的命令行工具（CLI），用于直接从终端生成高质量的方形 App 图标。它支持 OpenAI 和 Google Gemini 图像模型，输出固定为 1024x1024 尺寸，无需手动调整。

环境准备

在开始之前，请确保满足以下要求：

1. 系统环境：已安装 Node.js（推荐 LTS 版本）。
2. 网络访问：由于工具直接调用 OpenAI 或 Google AI Studio 接口，请确保您的网络环境可以访问这些服务（可能需要配置代理）。
3. API 密钥：您需要至少一个有效的 API 密钥：
   • OpenAI：用于生成 gpt-1.5 或 gpt-1 模型图标。
   • Google AI Studio：用于生成 banana (Gemini) 模型图标。

安装步骤

SnapAI 支持免安装直接使用，也支持全局安装。

方式一：直接使用（推荐） 无需安装，通过 npx 直接运行：

npx snapai --help

方式二：全局安装 如果您希望将其作为系统命令使用：

npm install -g snapai

基本使用

1. 配置 API 密钥

您可以通过环境变量或配置文件存储密钥。为了 CI/CD 安全，推荐使用环境变量。

设置环境变量：

export SNAPAI_API_KEY="sk-your-openai-api-key"
export SNAPAI_GOOGLE_API_KEY="your-google-ai-studio-key"

或者在运行时临时指定（不会持久化）：

npx snapai icon --openai-api-key "sk-..." --prompt "modern app artwork"

2. 生成第一个图标

使用最简命令即可生成图标，默认输出到当前目录下的 ./assets 文件夹。

npx snapai icon --prompt "minimalist weather app with sun and cloud"

3. 常用参数示例

• 指定输出目录：

  npx snapai icon --prompt "professional banking app" --output ./assets/icons
  

• 切换 Google 模型：

  npx snapai icon --prompt "modern app artwork" --model banana
  

• 生成多张变体：

  npx snapai icon --prompt "app icon concept" --model gpt-1.5 -n 3
  

注意：生成的图片始终为正方形 (1024x1024)。如果图片边缘出现空白边框，这是正常现象，可通过添加 --use-icon-words 参数尝试优化构图。