Banana 高清图片生成

概述

Nano Banana SkillPay

Generate an image through the ClawEase backend. Handle paid Tencent SkillPay 402 challenges and the final 200 image response without exposing merchant secrets or payment artifacts.

Generate an image

1. Obtain a non-empty image prompt. Accept an optional aspect ratio. Always generate at 2K; do not offer or accept another image size.
2. Run:

node <skill-dir>/scripts/generate-image.mjs 
  --prompt '<prompt>' 
  --aspect-ratio '1:1' 
  --output '<absolute-output-path>'

1. The published Skill calls https://clawease.ai by default. For local or staging verification, set CLAW_EASE_API_BASE_URL or pass --api-base-url explicitly.
2. Read the single JSON object printed to stdout.

Supported aspect ratios: 1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9.

Output size is fixed at 2K for consistent pricing. Do not pass --image-size.

Handle the result

status: completed

• Verify file_path exists.
• Return or display that image.
• Treat object_path as the stable OSS identifier. The returned signed url is valid for 24 hours.
• Report model, dimensions when available, and usage only when useful.

status: payment_required

1. Read both payment_code and out_trade_no. Treat them as ephemeral payment artifacts. Do not display, persist, or log them.
2. Pass the exact value to the installed weixinpay_pay tool and show the authorization UI to the user.
3. Never authorize payment on the user's behalf.
4. After the tool confirms payment, rerun the same request with the original values and both payment artifacts:

node <skill-dir>/scripts/generate-image.mjs 
  --prompt '<original-prompt>' 
  --aspect-ratio '<original-aspect-ratio>' 
  --output '<original-absolute-output-path>' 
  --trade-no '<out_trade_no>' 
  --payment-code '<payment_code>'

1. Keep the prompt and aspect ratio equivalent to the first request. The backend fixes the size at 2K, binds the normalized request body to the paid order, and rejects changed generation parameters.
2. If the backend reports skillpay_payment_pending, wait briefly and retry the same paid order. Do not create another order.
3. If the backend reports skillpay_fulfillment_in_progress, wait for the original fulfillment and retry the same paid order.
4. If weixinpay_pay is unavailable, explain that Tencent WorkBuddy/QClaw payment capability is required and stop. Never bypass the charge by calling an alternate endpoint.

Safety rules

• Call the image endpoint without an Authorization header.
• Allow plain HTTP only for loopback hosts. Require HTTPS for remote backends.
• Never hardcode the SkillHub developer private key, pub_key_id, WeChat merchant certificate, code_url, payment code, or trade number in this Skill.
• Consider payment successful for the user flow only when the payment tool confirms it. The backend independently verifies the WeChat order before generation.
• Reject malformed 402 responses that omit either WeixinPay-Required or X-Out-Trade-No.
• Do not retry a failed payment automatically.
• The backend uploads generated bytes to OSS before marking an order fulfilled. Never expect or persist b64_json.

When implementing or reviewing the backend X402 contract, read [references/skillpay-x402.md](references/skillpay-x402.md).