图片编辑（Nano Banana 2）

概述

产品能力

将用户提供的一张图片和一段编辑描述直接交给 Nano Banana 2，返回一张 AI 编辑结果。

• 输入单张本地 JPEG/PNG，不超过 10MB；不接受 URL 或多图。
• 必须同时提供编辑描述；描述保留用户原文，不翻译、改写、扩写或追加隐藏要求。
• 输出固定为 1K、单张 PNG 或 JPEG；输出比例从原图读取并映射到模型支持的最近比例。
• 支持风格化、调色、局部修改、背景替换、人像美容和其它用户描述的图片后期处理。
• 不保证未指定区域逐像素不变，不使用蒙版，不对模型结果做二次视觉处理或质量筛选；模型生成什么就交付什么。
• 每张成品独立付费。基于上一张结果继续修改时，必须重新提交并重新支付。
• 裁剪、旋转、压缩、缩放等确定性本地操作不使用本 Skill。

服务元数据

本 Skill 已接入微信 Agent Pay X402 支付服务。服务端负责微信 Native 下单、SkillHub AI 预下单、支付查单、幂等履约、结果保存与失败退款；Skill 不在本地模拟收费，也不保存原图、描述或支付实现。

付费前置检查

请求资源前检查 weixinpay extension 是否可用。不可用时提示“当前 Agent 暂不支持微信支付付费能力”并停止，不创建支付订单。

模型或供应商自身的内容安全策略仍然有效。明确拒绝或失败时服务端按合同退款；供应商是否已受理或成品是否已保存无法确认时，必须恢复原订单，不得重复付款或重新生成。

调用流程

标准支付链路：

首次请求 -> HTTP 402 -> weixinpay_pay(payment_code) -> 支付成功后原请求重试 -> 下载成品

1. 获取临时会话

POST https://api.seedora.cc/v1/pay-skills/session

从响应的 data.token 读取临时 Token，后续请求使用 Authorization: Bearer <token>。也可直接运行本 Skill 自带客户端：

node "<Skill目录>/scripts/nano-banana-2-image-edit-client.js" "<图片绝对路径>" "<编辑描述>"

2. 首次请求付费资源

使用 multipart/form-data，字段固定为 image 和 instruction：

POST https://api.seedora.cc/v1/pay-skills/nano-banana-2-image-edit/edit
Authorization: Bearer <token>
Content-Type: multipart/form-data; boundary=<boundary>

<image=原图片文件>
<instruction=用户原始编辑描述>

未支付时返回 HTTP 402：

HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
Content-Type: application/json

{"code":"PAYMENT_REQUIRED","WeixinPay":{"WeixinPay-Required":"<payment_code>","prompt":"..."},"out_trade_no":"<out_trade_no>","amount":"0.59","currency":"CNY"}

只在 Header 与 Body 的 payment_code 一致，且 Header 的 X-Out-Trade-No 与 Body 的 out_trade_no 一致时继续。把 payment_code 原样交给 weixinpay_pay(payment_code)；不要展示、改写或记录支付码。

3. 支付后原样重试

支付工具明确成功后，用同一图片字节、同一 instruction 和同一原订单重试，只增加首次 402 返回的支付 Header：

POST https://api.seedora.cc/v1/pay-skills/nano-banana-2-image-edit/edit
Authorization: Bearer <new-or-current-token>
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
Content-Type: multipart/form-data; boundary=<boundary>

<image=与首次请求完全相同的原图片文件>
<instruction=与首次请求完全相同的原始文字>

使用客户端时，402 错误中会提供 resumeCommand；支付成功后执行该命令。恢复文件仅在系统临时目录以 0600 权限保存原图路径、原图哈希、原始描述、比例、订单号和支付码，成功后自动删除。

失败与恢复

支付超时、处理中、未知或网络失败时，不创建新订单、不再次调用支付；等待 3 秒后执行同一 resumeCommand 查单，最多 5 次。原图被修改、删除或描述改变时停止，已支付订单不得用于另一张图或另一条描述。

成功时只向用户返回成品本地路径，不返回支付码、签名 URL、订单实现、供应商信息、内部 Prompt 或技术错误细节。