智绘图片香蕉

概述

角色定位

你是 智绘图片香蕉 的调用助手。Nano Banana 是 Google Gemini 的原生图像生成能力（当前主流为 Nano Banana 2 / Gemini 3.1 Flash Image），适合文生图、参考图生图与对话式修图。

约束：

• 只通过下文 API 调用，不要臆造上游模型或第三方接口
• model 固定为 ixhlink-skills-image-banana，capability 固定为 image_generation
• 付费 Skill：402 后调起微信支付；成功后用相同 JSON body 重试，Header 附带 WeixinPay-Required、X-Payment-Id
• 异步任务须轮询至 status = succeeded 再取结果

与 image-gen 的选用：

元数据

服务地址

Base URL：https://iskills.ixhlink.com

下文接口均写路径（如 /api/v1/llm/invoke），完整地址 = Base URL + 路径。

统一响应格式：

{"success": true, "code": 0, "message": "ok", "data": {}}

调用流程

image_generation 为慢任务，默认异步。典型流程：

1. 理解用户需求，按「Prompt 撰写」优化描述（尤其含文字、多参考图时）
2. （可选）GET /api/v1/llm/models 确认模型已启用
3. POST /api/v1/llm/invoke 提交请求
4. 若返回 402：调起微信支付，成功后用相同 JSON body 重试，Header 附带 WeixinPay-Required 与 X-Payment-Id
5. 从响应取 data.task.id，轮询 GET /api/v1/llm/tasks/{task_id} 直至 status = succeeded
6. 从 data.result.data[].url 读取输出图片 URL

也可直接用 POST /api/v1/llm/tasks 创建异步任务（请求体相同，强制异步）。

Prompt 撰写（Nano Banana 特化）

Nano Banana 对具体、结构化描述响应更好。调用 API 前，将用户意图整理为清晰 prompt：

文生图：

• 主体 + 场景 + 光线 + 风格 + 构图
• 需画面内文字时，用引号写明原文，并说明字体风格与位置，例如：标题文字「夏日音乐节」，粗体无衬线，居中偏上
• 信息图/海报：先列信息层级（主标题、副标题、要点），再描述版式

图生图 / 对话式修图（提供 images）：

• 开头说明保留项：严格保留参考图中人物五官与服装
• 再写修改项：将背景改为赛博朋克夜景，霓虹反射
• 多轮修改：在上一轮结果 URL 或新上传图上继续，prompt 只描述本次变更

多参考图：

• 说明每张图的用途：图1 人物面部参考，图2 服装参考，图3 构图参考
• 避免互相矛盾的描述

尺寸建议：

支持常见比例：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9 等；具体以上游模型为准。

1. 查询模型（可选）

GET /api/v1/llm/models
Accept: application/json

确认返回的 items 中包含：

{"model": "ixhlink-skills-image-banana", "capability": "image_generation"}

2. 提交图片生成

POST /api/v1/llm/invoke
Content-Type: application/json

文生图示例：

{
  "capability": "image_generation",
  "model": "ixhlink-skills-image-banana",
  "payload": {
    "prompt": "极简产品海报，白色背景，中央放置磨砂玻璃瓶护肤品，柔和侧光。标题文字「PURE GLOW」，现代无衬线粗体，深灰配色，居中偏上。副标题「天然植萃」较小字号位于标题下方。",
    "size": "3:4",
    "response_format": "url"
  }
}

图生图 / 修图示例（带参考图）：

{
  "capability": "image_generation",
  "model": "ixhlink-skills-image-banana",
  "payload": {
    "prompt": "严格保留参考图中人物面部与发型。将背景替换为东京涩谷夜景，霓虹灯牌反射在地面，电影感色调",
    "images": [
      {"url": "https://example.com/portrait.png"}
    ],
    "size": "16:9",
    "response_format": "url"
  }
}

多参考图示例：

{
  "capability": "image_generation",
  "model": "ixhlink-skills-image-banana",
  "payload": {
    "prompt": "图1人物面部与表情，图2服装款式，合成半身商务形象照，浅灰渐变背景，专业摄影棚光",
    "images": [
      {"url": "https://example.com/face.png"},
      {"url": "https://example.com/outfit.png"}
    ],
    "size": "3:4",
    "response_format": "url"
  }
}

payload 字段：

提交成功响应（异步）：

{
  "success": true,
  "code": 0,
  "message": "任务已提交",
  "data": {
    "task": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "pending",
      "capability": "image_generation",
      "model_key": "ixhlink-skills-image-banana"
    }
  }
}

3. 轮询任务结果

GET /api/v1/llm/tasks/{task_id}
Accept: application/json

任务状态： pending → running → succeeded / failed

建议间隔 2–5 秒轮询，超时可根据业务设为 3–5 分钟。

成功响应示例：

{
  "success": true,
  "code": 0,
  "message": "ok",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "succeeded",
    "result": {
      "data": [
        {"url": "https://oss.example.com/banana-output.png"}
      ]
    }
  }
}

输出图片 URL 在 data.result.data[].url。

付费前置检查

调用本 Skill 前，必须检查当前 Agent 是否已安装支付能力（weixinpay extension）：

• ✅ 已安装：可继续提供付费创作服务
• ❌ 未安装：向用户提示「当前 Agent 暂不支持付费创作能力」，终止流程

服务与定价

价格以 SkillHub 后台配置为准。命中创作意图后，向用户展示服务名称和价格，由用户确认后进入付费流程。

付费说明

当 amount_fen > 0 且未完成支付时，首次 POST /api/v1/llm/invoke 会返回 HTTP 402，响应中携带：

• Header：WeixinPay-Required: <payment_code>、X-Payment-Id: <payment_id>
• Body：WeixinPay 对象（含 payment_id、prompt 等）

客户端流程（Agent / MCP / Web）：

首次 invoke → 402 → weixinpay_pay(payment_code) → 支付成功后重试 invoke

「原样重试」的含义：

• JSON body 不变：model、capability、payload 必须与首次请求完全一致
• 订单参数单独带上：将 402 中的 payment_code、payment_id 通过 Header 传入（推荐），或写入 body 的 WeixinPay；勿改 payload 业务字段来传订单号

重试请求示例：

POST /api/v1/llm/invoke
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Payment-Id: <payment_id>

{"model":"ixhlink-skills-image-banana","capability":"image_generation","payload":{...}}

amount_fen = 0 时可跳过支付，直接调用。每笔订单按次消费，使用后不可复用。

错误处理

任务失败时 status = failed，查看 data.error_message（已脱敏，不含上游地址或内部日志）。

质量自检

出图后快速核对：

• [ ] 画面内文字是否与 prompt 引号内原文一致、清晰可读
• [ ] 多参考图场景：主体身份/服装是否与参考一致
• [ ] 图生图：是否保留了要求不修改的部分
• [ ] 构图与 size 比例是否匹配用途

未通过时，在 prompt 中加强约束（引号标明文字、写明保留项）后重试，避免一次堆砌过多矛盾要求。