软件的外接引擎
软件负责工作台、素材整理和结果保存；API 服务商负责真正的文本理解、图片生成或视频生成。软件不内置免费额度，Key、模型权限和调用费用由你自己的服务商账户决定。
完整使用
教程
BANANACAT IMAGE · BananaCat Windows 安装版
从 API 配置、首次生成到结果保存，一次走完真实工作流。
适用于 Windows 安装版按实际工作台操作即可
START HERE先把工具跑起来，
先把工具跑起来，
再进入任务。
API MAP / 00
先理解这三件事
先图片，再文本
只做产品主图时，先配置图片供应商、图片 Base URL、图片 API Key 和图像模型。自动详情、提示词详情、跨境详情还需要文本模型；Agent 图片分析才需要视觉 Key。
先检测，再生成
保存设置前先用“检测连接与模型权限”。检测通过只代表供应商接受当前配置，不代表每个模型、每种尺寸和每次生成都一定成功。
SETTINGS DICTIONARY / 01设置页每一项
设置页每一项
到底管什么？
主 Base URL主网关地址
主网关的根地址，文本、图片未单独配置时会回退到这里。
图片供应商图片走哪条链路
同一网关选“主 Base URL”；单独供应商选专用图片网关。
图片 Base URL图片专用地址
只有图片供应商与主网关不同才填写，会覆盖主 Base URL。
图片接口类型请求格式
Images 对应 /v1/images/generations；Gemini 对应原生 generateContent。
图片 API Key图片调用凭据
优先给图片生成使用；未填写时才回退到主网关 Key。
文本模型 API Key文案与规划凭据
自动详情、提示词详情、跨境详情等文本任务使用。
视频 Base URL / Key视频调用凭据
只有使用产品视频工作流时才需要，图片任务可以留空。
图像模型（Model）具体模型名
选择服务商账户实际开通的模型，模型名不匹配会报错。
最短配置路径主 Base URL -> 主网关 API Key -> 图片供应商 -> 图片 API Key -> 图像模型 -> 检测连接 -> 保存设置
只做图片任务时，先完成这条路径即可；文本、视频和视觉 Key 按需增加。01
STEP 01
开始前准备
先准备一次完整的“输入—调用—保存”闭环。
- Windows 电脑和可写本地目录。
- 有权使用、主体完整且文字可辨认的 JPG / PNG 商品原图；不要只准备截图或被压缩到看不清的图片。
- 按任务准备 Logo、参考成品图、克隆参考图、真实卖点、目标语言、输出平台和画幅要求。
- 有效邀请码；首次进入显示“邀请码解锁”，单个邀请码只能绑定一台机器。
- 一个已开通图片模型权限的服务商账户，以及对应的 API Key。第三方费用、额度、限流和服务状态由供应商决定。
02
STEP 02
启动并完成解锁
本教程适用于 Windows 安装版。
- 安装并启动桌面客户端，等待窗口出现。
- 在“邀请码解锁”输入框填写管理员提供的码，点击“解锁进入”，等待成功提示。
- 邀请码只负责软件门禁，不是图片模型 API Key；两者不能互相替代。
- 遇到问题时优先查看客户端的提示和诊断信息，不要手工删除本地数据。
03
STEP 03
打开 API 设置
从顶部进入“授权与设置”，你会看到设置、记忆查询、备份与恢复、免责声明四个页签。
- 进入“设置”页签；左侧的“本地调用说明”说明 Key 由你申请、只保存在当前本机。
- 先看“主网关 / 图片 / 文本 / 视频配置”这一块。右上角“获取令牌”只能打开服务商页面，不能替你创建或充值账户。
- 只做图片任务时，不需要先配置视频 Key；只做简单产品主图时，也不必配置视觉 Key。
- 设置不会自动把 Key 发送给社群网站；不要把 Key 截图、录屏或发给他人。
04
STEP 04
查看高清01 / 主网关与图片供应商
填写主网关
主网关是文本、图片和部分任务的默认入口。
- 在“主 Base URL（默认控制全部）”下拉框选择你的服务商；列表没有时选择“自定义 / 手动输入”。
- Base URL 填服务商文档给出的根地址，例如 https://api.example.com/v1。不要把 /v1/images/generations、/chat/completions 或 :generateContent 直接粘到这里。
- “文案/对话链路调用哪条”默认选择“主网关文本模型”；只有你明确准备了另一套 OpenAI Chat 配置时才切换。
- 在“主网关 API Key”粘贴对应 Key。图片或文本没有单独 Key 时，软件会按回退规则使用它。
查看高清先看清默认链路
主 Base URL 决定默认请求入口；图片供应商选择“主 Base URL”时，图片会沿用这里的地址和主网关 Key。
05
STEP 05
查看高清02 / API Key 区域
填写图片链路
图片生成是否成功，取决于图片地址、接口类型、Key 和模型四项能否匹配。
- “图片供应商”选“主 Base URL”表示图片和主网关共用一套地址与 Key；选“自动”时，软件只会使用同族的完整配置。
- 如果服务商提供独立图片地址，选择“自定义图片网关”，填写“图片 Base URL（可选，覆盖主 Base URL）”和“图片 API Key”。
- “图片接口类型”选择 Images 或 Gemini 原生接口，必须以服务商文档实际支持的协议为准；协议选错会得到 400、404 或模型不支持。
- 图片 API Key 只粘贴 Key 本身，不要加 Bearer、引号、换行或整段请求头。
查看高清Key 按用途填写
主网关 Key 是默认凭据；文本、视觉和视频 Key 只有在使用对应能力或需要覆盖主网关时才填写。截图中的 Key 已做脱敏处理。
06
STEP 06
选择模型与辅助 Key
模型是服务商账户里真正可调用的名称，不是随便写的昵称。
- 在“图像模型（Model）”选择账户已开通的模型：Gemini 3 Pro / Flash、GPT Image 2、Nano Banana 等选项以当前软件列表为准。
- 在“Agent 聊天模型”选择对话与策略模型；在“专业文案与规划模型”选择自动详情等任务的文本模型。
- 只有 Agent 上传图片后需要视觉理解时，才填写“gpt-4o 图片分析 API Key”；只有视频工作流才填写“视频 API Key”。
- 如果供应商没有开通某个模型权限，不要靠改模型名绕过；换成账户实际有权限的模型或联系供应商开通。
07
STEP 07
检测、保存与本地副本
先验证配置，再开始第一次生成。
- 点击“检测连接与模型权限”，看到“连接成功”或明确的供应商提示后再继续；检测未完成时先修 Base URL、Key 和模型的对应关系。
- 点击“保存设置”。保存后立即生效，一般不需要重启应用。
- 勾选“生成完成后自动保存副本到本地文件夹”，点击“选择文件夹”指定长期可写目录；这只是副本，不会改变结果区。
- 建议先用一张商品图、1 张结果做低成本测试，确认能生成、能打开、能保存后再提高数量。
08
STEP 08
查看高清01 / 建立企业视觉档案 
查看高清02 / 产品资料 
查看高清03 / 本地业务记忆查询 
查看高清04 / 企业视觉 DNA 
查看高清05 / 记忆记录 
查看高清06 / 审计与回滚 
查看高清07 / 备份与恢复 
查看高清08 / 导入资料
建立企业记忆
企业记忆是一套本机、可确认、可追溯的资料层；它不是自动学习，也不会绕过人工确认。
- 先建立企业视觉档案：填写企业名称、行业、主营业务、目标客群和品牌定位，上传有权使用的 Logo、企业资料和视觉参考图。企业资料保存在本机企业数据库，Logo 原文件保存在本机企业资产目录。
- 产品资料可从 Agent 或“记忆查询”导入 JSON、Markdown 或 TXT；系统先解析预览，只有点击确认后才写入产品长期记忆。企业项目与具体产品、平台和用途保持作用域隔离。
- 一次聊天或一次生成不会自动成为长期规则。想保存某套风格，必须在 Agent 结果中明确确认“保存这套风格”；视觉 DNA 只记录色彩、调性、构图、背景、光线和禁止项等可复用规则。
- 在“记忆查询”中搜索并检查状态、来源、有效期和作用域。当前用户输入优先于历史检索；商品真实图与 SKU 事实优先于视觉记忆。
- 需要修改长期规则时先审核待确认变更；确认会生成新的不可变版本，拒绝则不生效。发现规则不合适，可按作用域回滚或停止使用。
- 通过“备份与恢复”保护 Agent 数据库、业务数据库和企业资产。恢复前会创建安全备份，完成后自动重启；自动备份保留最近 7 个，手动备份不会自动删除。
- 不要把 API Key、原图字节、Base64、客户隐私或完整敏感提示词写进记忆、截图、录屏和公开文档。
查看高清先把企业资料建成档案
在 Agent 企业模式中填写企业名称、行业、主营业务、目标客群和品牌定位，再上传深色/浅色 Logo 与视觉参考图。资料先保存在本机企业数据库，确认后才会参与后续分析与生图。
查看高清产品资料先预览，再确认
在记忆查询中上传 JSON、Markdown 或 TXT，系统先解析预览；点击确认后才写入与聊天相同的产品长期记忆。企业项目和具体产品保持隔离。
查看高清只检索已确认、未过期的记忆
搜索可按内容、类型、作用域和平台定位。密钥、原图字节和完整敏感提示词不会出现在这里；普通聊天不会自动变成长期记忆。
查看高清保存的是视觉规则，不是某一张图
视觉 DNA 汇总企业确认过的色彩、调性、构图、背景、光线和禁止项。它只作为后续任务的参考，商品真实信息与 SKU 证据始终优先。
查看高清每条记忆都有来源与状态
记录会显示类型、作用域、创建与审核时间、有效期、来源会话和置信度。只有“已确认”且仍在有效期内的记录，才可能被 Agent 检索。
查看高清变更可审计，也能回到旧版本
长期规则变更先进入待确认区；确认后生成不可变版本。发现新规则不合适时，可按作用域回滚到指定版本，不会静默覆盖历史任务。
查看高清企业记忆和资产一起保护
“立即备份”会保存 Agent 数据库、业务数据库与企业资产。自动备份保留最近 7 个；恢复前先创建安全备份，恢复完成后客户端自动重启。
查看高清只导入有权使用的资料
选择企业资料文件后再回到预览确认。不要导入客户隐私、API Key、未授权素材或临时缓存；公开教程不展示任何真实凭据。
09
STEP 09
查看高清01 / 进入电商物料 
查看高清02 / 上传产品图片 
查看高清03 / 填写产品信息 
查看高清04 / 设置并生成
第一次生成：产品主图
下面是一条最短、最容易验证的完整路径。
- 进入“电商物料工作台”，模式选择“产品主图”。
- 在“产品图片”上传 1 张主体完整、方向正确、包装文字清晰的商品图；等缩略图出现后再继续。
- 按需上传 Logo，填写真实卖点、目标用途、电商类型和背景风格；没有真实资料的价格、销量、认证和功效不要编造。
- 在禁改项里写清“保持商品颜色、形状、包装、容量、Logo、标签不变”；想改变的内容只写背景、构图、光线或排版。
- 确认生成数量后，点击底部“生成 N 张”。按钮进入生成中后不要连续点击，等待结果区出现完成或错误状态。
查看高清先选对工作台与模式
打开电商物料工作台，顶部选择“电商物料”，工作入口中的模式选择“自动详情”。右侧结果区会一直保留，用来查看生成状态与结果。
查看高清先上传主体，再补 Logo
在产品图片区域上传正面、背面、左右侧、顶部和底部等视角；也可以直接上传图片。需要品牌露出时，再上传左上角的首图 Logo。
查看高清只填写真实产品事实
产品名称、品牌名称、产品描述与卖点会参与文案和画面生成。没有资料的价格、功效、认证和参数不要猜，留空或先补齐事实。
查看高清确认参数后只点一次生成
先确定屏数、比例、分辨率和语言，再选择背景风格与生成模式。点击“生成 N 张”后等待结果区完成，不要连续点击造成重复任务。
10
STEP 10
看懂其他模式
不同模式改变的是输入合同，不是 API 配置逻辑。
- 自动详情：上传商品图和资料，让系统先整理详情页结构；生成后重点检查卖点顺序与事实。
- 提示词详情：自己写页面结构、语气、画幅和禁改项，适合已有明确创意方向的任务。
- 克隆详情：上传新商品图和“克隆参考图（版式蓝图）”；参考图只提供结构，新商品事实以新图为准。
- 跨境详情：确认地区、内容风格和详情页语言；认证、功效、保修、原产地和价格必须有真实资料。
- 主图套图：为同一商品生成统一用途的一组图；主图裂变：把已确认的“主图母图”只做允许范围内的背景、构图或文案变化。
11
STEP 11
检查、保存与下载
生成完成不等于可以直接发布。
- 逐张检查商品颜色、形状、包装、Logo、标签、文字、材质、阴影、边缘、构图和平台尺寸。
- 失败结果、占位图、文字乱码、商品事实被改写的结果不要保存到交付目录。
- 合格结果可点“设为主图”或“保存到资产”；单图下载进入系统“下载”目录，批量保存进入所选目录下的时间戳子目录。
- 用系统图片查看器打开实际文件，确认文件可打开、数量正确、结果与页面预览一致。
12
STEP 12
历史与迁移
本地数据和 API 配置都属于当前设备的工作环境。
- “历史记录”用于回看任务；能否再次下载取决于本地结果文件是否仍在。
- 迁移电脑前先备份原图、结果、资产和设置；不要直接复制正在运行中的数据库文件。
- 开始新商品前使用“一键清除已输入信息”，避免上一件商品的 Logo、卖点或参考图串入新任务。
13
STEP 13
故障处理顺序
先看错误类型，再改一个变量；不要同时重填所有设置。
- 401 / 403：供应商拒绝鉴权。检查 Key 是否属于当前 Base URL、是否有对应模型权限，不能只换模型名。
- 400 / 404：请求格式或地址不对。检查 Base URL 是否多填了完整接口路径，以及 Images / Gemini 接口类型是否匹配。
- 连接超时：检查网络、服务商状态和 Base URL；不要连续点击导致重复任务。
- 无生成结果：先看当前模式是否缺少图片、Logo、参考图或主图母图，再检查额度和模型权限。
- 商品被改写：换更清晰原图，补充颜色、结构、标签和 Logo 禁改项；删除错误结果后重新生成。
FIRST RUN / 14第一次生成
第一次生成
照这个例子填。
配置目标
主 Base URL：服务商根地址
图片供应商：主 Base URL 或专用网关
图片接口：按服务商文档选择
图片模型：账户已开通的模型
素材目标
上传 1 张清晰商品图
补充 Logo 或参考图（按模式需要）
写真实卖点与禁改项
先生成 1 张做低成本验证
成功标准
结果区出现完成状态
图片能打开且主体未被改写
可保存到资产或下载目录
自动副本按设置落盘
RELEASE CHECKLIST
发布前检查
- 商品颜色、形状、包装和标签未被改写
- Logo、容量、型号和文案符合真实资料
- 失败图和占位图不进入交付目录
- 实际下载文件可打开且与结果区一致