前言¶
在 Cursor、Claude Code 等环境里写代码时，常会顺手要一张封面、海报或配图。自己切到绘图工具再贴回对话，会打断上下文；若让模型「凭空描述」一张图，又得不到可用文件。下面介绍社区 Skill nano-banana2：把 kexiangai.com 的 nano-banana2 接口封装成 Agent 可调用的能力，在对话里按提示词生成图片，并支持图生图、比例与清晰度参数。
这是什么¶
nano-banana2 是 SkillHub 上的社区 Skill（坐标 @user_4bd21536/nano-banana2，当前版本 1.0.1），分类为 design-media，由发布者 user_4bd21536 维护。它解决的是：当用户要在对话里完成「生成图片」「图生图」「海报图」「封面图」，或指定 16:9 / 9:16 等比例与 1K / 2K / 4K 清晰度时，Agent 应走统一的接口与参数约定，而不是误用视频、OCR 或非生成式修图能力。
Skill 页标注 requires_api_key=true：调用前需在 kexiangai.com 取得密钥，并以 x-api-key 方式使用。
核心功能¶
已核实的能力如下（以 SkillHub 简介为准）：
- 文生图：根据文本
prompt生成图片。 - 图生图：在可选参数
urls中传入参考图 URL，在提示词引导下生成新图。 - 画幅与清晰度：可选
aspectRatio（如 16:9、9:16）、imageSize（1K / 2K / 4K）。 - 统一入口：通过接口 imgEditNB2 调用，参数包括：
-prompt（必填）
-urls（可选）
-aspectRatio（可选）
-imageSize（可选）
明确不适用：视频生成、OCR、以及非生成式图片编辑（Skill 原文：Do NOT use for video generation, OCR, or non-generative image editing）。
安装与启用¶
先做环境检查，再把 Skill 装到当前 Agent 能识别的 skills 目录。
1. 安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
（仅 CLI 时可在文档中使用 --cli-only 参数。）
2. 安装 nano-banana2¶
官方页面要求：根据 https://skillhub.cn/install/skillhub.md，安装 @user_4bd21536/nano-banana2。
安装命令须带 --dir，指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。文档给出的常见路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
skillhub install @user_4bd21536/nano-banana2 --dir ~/.cursor/skills/
将路径替换为你实际使用的 Agent 目录。安装后按各客户端要求重启或刷新 Skill 列表。
3. 配置 API Key¶
在 kexiangai.com 获取 x-api-key，并按 Skill 说明配置到运行环境（具体变量名以 Skill 包内 SKILL.md 为准；页面仅标明需 x-api-key）。
典型用法¶
Skill 未在公开页给出完整 HTTP 示例，触发与参数约定如下，便于在对话中复现意图：
- 用户说「生成一张 16:9 的封面图，2K，主题是……」→ Agent 应选用本 Skill，调用 imgEditNB2，填写
prompt，并设置aspectRatio、imageSize。 - 用户上传或给出图片 URL，要求「按这张风格做海报」→ 在
urls中传入参考图，配合prompt做图生图。 - 用户只给文案、未提比例 → 至少提供
prompt；比例与清晰度可按需求省略或补默认值（以接口实际行为为准）。
示例参数结构（字段名与 Skill 简介一致）：
{
"prompt": "科技感产品海报，深色背景，主标题留白",
"urls": ["https://example.com/reference.png"],
"aspectRatio": "16:9",
"imageSize": "2K"
}
适用场景与注意¶
适合谁：需要在 Agent 工作流里直接出图的产品、运营、开发者；已愿意使用 kexiangai.com 的 nano-banana2 接口并自备 API Key 的团队。
注意：
- 依赖外网接口与计费策略，Key 不要提交到仓库。
- 不要用本 Skill 处理视频、文字识别或「抠图、调色」类非生成式编辑需求。
- SkillHub 页显示版本 v1.0.1；商店统计（下载、安装等）会随时间变化，以 SkillHub 技能页 为准。
结尾¶
nano-banana2 把文生图、图生图和常见画幅/清晰度参数收敛到 imgEditNB2 与一套触发话术上，适合在编码助手场景里快速出封面与海报。安装与优先源说明见 SkillHub 安装文档；技能详情与坐标见官方地址：https://api.skillhub.cn/user_4bd21536/nano-banana2（展示页：https://www.skillhub.cn/skills/user_4bd21536/nano-banana2）。
