技能介绍

解决的问题

把 AI Hive 图片接口封装成裸接口时，容易遇到几个工程问题：模型 ID 写错、参考图上传后忘记关联、任务轮询超时、价格没有快照、结果下载散落各处。这个技能围绕 public_model_nano_banana_pro 固定入口，把查询、上传、提交、轮询和下载串成可复用的 CLI 流程，减少手写脚本里的状态漂移。

工作方式

生成与编辑：使用 generate --prompt 描述画面或编辑要求；需要参考图时用 --image 传入一张或多张图片，并明确每张图提供主体、构图、材质或风格。
参数与路由：通过 --param key=value 传递实时 imageConfig 支持的参数，--batch 控制数量，--routing 可选 COST_FIRST、SPEED_FIRST 或 SUCCESS_FIRST；默认结果目录是 ~/Downloads/AiHive。
任务管理：提交后拿到 taskId，可用 task --task-id 查询状态；upload --file 用于上传图片；技能不会自动换模型，避免“看起来像 Nano Banana Pro”的误用。

适用边界

需要有效的 AI Hive API Key，并依赖 Python 3 与 requests 运行。参数枚举、图片尺寸、参考图数量应以运行时返回的模型配置为准；提示词中必须出现的文字仍需交付前人工复核。批量生成会叠加费用，建议先确认实时价格；模型下线、更名或后台配置变化时，应查询实时列表而不是硬编码旧参数。