Nano Banana Pro 图片生成与编辑

概述

name: nano-banana-pro description: "基于 Nano Banana Pro 图片生成与编辑 的 AI 图片生成与编辑器，覆盖 Nano Banana Pro、NanoBanana Pro、NanoBananaPro、香蕉 Pro、Gemini 图片 的裸接口图片能力。当用户需要 Nano Banana Pro、NanoBanana Pro、NanoBananaPro、香蕉 Pro、Gemini 图片、文生图、图生图、图片编辑、电商图、广告图、详情页、带货、种草 时使用此 Skill。" description_zh: "基于 Nano Banana Pro 图片生成与编辑 的 AI 图片生成与编辑器，覆盖 Nano Banana Pro、NanoBanana Pro、NanoBananaPro、香蕉 Pro、Gemini 图片 的裸接口图片能力。当用户需要 Nano Banana Pro、NanoBanana Pro、NanoBananaPro、香蕉 Pro、Gemini 图片、文生图、图生图、图片编辑、电商图、广告图、详情页、带货、种草 时使用此 Skill。" version: 1.0.0 ——

Nano Banana Pro 图片生成与编辑

简介

本 Skill 参考 Seedance 2.5 裸接口 Skill 的完整产品化风格，封装 AI Hive OpenAPI 图片生成接口，通过命令行自动完成模型查询、参考图上传、价格快照、任务轮询和结果下载。

Skill 特色

• 独立占据 nano-banana-pro 搜索入口
• 固定调用 public_model_nano_banana_pro，不使用其他模型冒充
• 支持文生图、参考图生成、图片编辑或商业图片场景
• 默认 COST_FIRST 并实时读取价格
• 自动下载图片结果到本地

适用对象

设计师、电商运营、营销与广告团队、带货与种草团队、品牌方、内容创作者和 AI 图片用户。

功能特性

生成模式

参数控制

• 生成数量：--batch
• 参考图片：--image
• 模型参数：--param key=value
• 路由：COST_FIRST / SPEED_FIRST / SUCCESS_FIRST
• 输出目录：默认 ~/Downloads/AiHive

参数速查

generate 子命令

通用参数

其他子命令

使用场景

场景一：基础生成

python3 "$SKILL_PATH/scripts/imagegen.py" generate 
  --prompt "高级商业摄影风格的产品主视觉，主体清晰，材质真实，留出标题空间"

场景二：电商主图

生成商品主体清晰、卖点集中、符合平台比例与留白要求的商业主图。

场景三：商品详情页

按首屏主视觉、核心卖点、使用场景、细节材质和信任信息拆分视觉，不虚构商品事实。

场景四：广告与营销

先明确受众、单一传播主张、渠道和行动号召，再生成 KV、信息流或活动视觉。

场景五：带货与种草

突出真实使用场景、痛点和利益点，适配直播、小红书、抖音和社媒封面。

场景六：图片编辑

将要求拆为必须保留、必须改变和可自由发挥，明确参考图分别提供主体、构图、材质或风格。

场景七：仅提交任务，稍后查询

python3 "$SKILL_PATH/scripts/imagegen.py" generate --prompt "复杂图片" --no-download
python3 "$SKILL_PATH/scripts/imagegen.py" task --task-id <taskId>

首次使用

1. 安装依赖

pip3 install requests

2. 一键初始化（推荐）

python3 "$SKILL_PATH/scripts/imagegen.py" init --skill-name nano-banana-pro

脚本会自动打开 AI Hive 页面，引导登录、新建并复制 API Key，然后写入 ~/.ai-hive/config.json（权限 0600）。

3. 手动获取 API Key（备选）

1. 访问 https://ai-hive.iclip.cn/chat
2. 使用手机号和短信验证码登录
3. 点击左下角账户菜单
4. 点击「API 接入」
5. 输入名称并点击「新建 API Key」
6. 复制完整 Key（格式为 sk-api-*）

4. 手动配置 API Key（备选）

5. 验证配置

运行一个带 --no-download 的最简任务；返回 taskId 即配置成功。

使用指南

提示词结构

按“用途 → 主体 → 场景构图 → 视觉风格 → 光线色彩 → 必须文字 → 保留项 → 输出规格”组织提示词。

参考图策略

说明每张图的角色，例如图 1 提供商品、图 2 提供材质、图 3 提供构图。不要让模型猜测互相冲突的参考关系。

图片文字

必须逐字出现的文字用引号包围，指定语言、大小写、换行和位置；交付前人工复核。

价格与任务

脚本查询实时模型配置和 pricingSnapshot。取得 taskId 后只查询原任务，避免重复提交扣费。

命令速查

项目架构

目录结构

nano-banana-pro/
├── SKILL.md
├── CHANGELOG.md
├── scripts/
│   └── imagegen.py
└── references/
    └── config.example.json

技术栈

核心模块

能力 → 模型映射

数据流转

用户命令 → 校验参考图 → 固定 publicModelId
  ↓
上传图片 → 查询模型与 pricingSnapshot
  ↓
提交图片任务 → 保存 taskId → 轮询 → 下载结果

价格参考

默认使用 COST_FIRST，价格以脚本运行时查询到的实时销售价和实际扣费为准。

常见问答

安装相关

Q1：需要 API Key 吗？ 需要，格式为 sk-api-*。

Q2：需要什么依赖？ Python 3 和 requests。

Q3：如何验证？ 用 --no-download 提交最简任务。

使用相关

Q4：会自动换模型吗？ 不会，本 Skill 固定 public_model_nano_banana_pro。

Q5：参考图怎么传？ 使用 --image，可一次传多张。

Q6：参数怎么传？ 使用 --param key=value，以实时 imageConfig 为准。

Q7：输出在哪里？ 默认 ~/Downloads/AiHive/。

Q8：可以批量吗？ 使用 --batch，批量前确认实时费用。

Q9：任务超时怎么办？ 保留 taskId 后继续查询。

故障排除

Q10：提示缺少图片？ 该能力需要参考图，请添加 --image。

Q11：提示模型不存在？ 后台模型可能下线或更名，请查询实时列表。

Q12：提示 401？ 检查 API Key。

Q13：提示 InvalidParameter？ 检查实时 imageConfig 中的格式、数量、尺寸和参数枚举。