synmindai/dsh-nanobananapro

NanoBananaPro DeepSeek Harness 插件

npm
DeepSeek Harness
License: MIT

dsh-nanobananapro 让 DeepSeek Harness 可以直接调用 NanoBananaPro 公开
API 生图和生视频。每位用户使用自己的 NanoBananaPro API Key；上游供应商、
扣费、数据库和存储密钥都留在 NanoBananaPro 服务端，不进入 Harness。

插件提供：

- nanobananapro_generate_image：文生图、参考图生图
- nanobananapro_generate_video：文生视频、图生视频、多模态参考生视频
- nanobananapro_get_task：查询或继续等待任务
- nanobananapro_get_balance：查看网页积分和 API 积分
- nanobananapro_account_help：返回注册、Key、充值和文档入口

注册、充值和 API Key

1. 打开  登录或注册。
2. 打开  购买 API 积分。
3. 打开  创建 API Key。
4. 只在启动 Harness 的环境中保存 Key，不要写进聊天、代码或
cordis.patch.yml：

export NANOBANANAPRO_API_KEY='sk-...'

5. 重启 Harness，先让它调用 nanobananapro_get_balance 检查余额。

注意：NanoBananaPro 的网页积分和 API 积分是两个独立钱包。这个插件消耗
API 积分，充值时请进入 API Pricing，而不是普通网页套餐。

完整 API 文档：

安装

npx -y @deepseek-ai/dsh plugin --profile web add dsh-nanobananapro
npx -y @deepseek-ai/dsh --profile web --dump-config
npx -y @deepseek-ai/dsh web --profile web

如果安装克隆到本地的源码：

npx -y @deepseek-ai/dsh plugin --profile web add .

对话使用示例

先查询我的 NanoBananaPro API 余额。然后生成一张 16:9、2K 的电影感产品
主视觉：透明跑鞋放在镜面金属台上。等待并返回最终图片。

用 NanoBananaPro 的 Veo 3 Fast 生成一段 16:9 电影感视频：黄色纸飞机缓慢
飞过干净的蓝色摄影棚，等待并返回最终视频链接。

参考图片、视频和音频必须是外网可访问的 HTTPS URL。插件不会自动把本地文件
上传到网站；需要先上传并取得公开 URL。

扣费与安全

- 生图、生视频默认都会先弹出付费确认。
- API Key 由 Harness 凭据服务读取，不作为工具参数交给模型。
- 每个付费请求自动带幂等键；网络重试不会换键，降低重复扣费风险。
- 仅对 429 和服务端 5xx 做有限次数退避重试。
- 余额不足时错误会给出正确的 API 充值链接。
- 等待超时不代表任务失败。此时用原 task_id 调用
nanobananapro_get_task，不要重新提交同一个生成任务。

可选配置

默认配置已经可以直接使用。只有需要更改超时、测试地址或确认策略时，才在
$DSH_HOME/profiles/web/cordis.patch.yml 覆盖完整配置：

- id: nanobananapro
config:
apiBaseUrl: https://gateway.bananapro.site
apiKeyEnv: NANOBANANAPRO_API_KEY
requestTimeoutMs: 30000
pollIntervalMs: 3000
imageWaitTimeoutMs: 300000
videoWaitTimeoutMs: 900000
maxRetries: 2
retryDelayMs: 500
requireApproval: true
allowLocalHttp: false

Harness 覆盖配置时会替换整行 config，不要只保留某一个字段。