Nano Banana — Image Generation Skill

When to Use

Generating images for Etsy prints, Frame TV art, or any AI image generation task using kie.ai API.

API Details

• API: kie.ai (wrapper for Google's Gemini image model)
• Key: ~/.clawdbot/.env → KIE_AI_API_KEY
• Models:
  • google/nano-banana — 2¢/image (DEFAULT)
  • google/nano-banana-pro — 12¢/image (tricky text/scripture art only)

Async Workflow

Step 1: Create Task

TASK_ID=$(curl -s -X POST https://api.kie.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $KIE_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana",
    "input": {
      "prompt": "Your prompt here...",
      "output_format": "png",
      "image_size": "3:4"
    }
  }' | jq -r '.data.taskId')

Step 2: Poll (~10-15 sec, then poll)

curl -s "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $KIE_AI_API_KEY" | jq '{state: .data.state, result: .data.resultJson}'

States: generating → success or failed

Step 3: Download

IMAGE_URL=$(curl -s "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $KIE_AI_API_KEY" | jq -r '.data.resultJson | fromjson | .resultUrls[0]')
curl -s -o output.png "$IMAGE_URL"

⚠️ CRITICAL Parameter Differences

Model	Size param	Values
google/nano-banana	image_size	"1:1", "3:4", "4:3", "9:16", "16:9"
google/nano-banana-pro	aspect_ratio	"1:1", "3:4", "4:3", "9:16", "16:9"

Pro also supports: resolution: "1K", "2K"

Aspect Ratio Guide

• 3:4 = PORTRAIT (8.5x11") — USE FOR PRINTABLES
• 4:3 = LANDSCAPE (11x8.5") — USE FOR PRINTABLES
• 4:5 = Instagram portrait
• 9:16 = Frame TV / stories
• 16:9 = Wide banner
• 1:1 = Square (NOT for printables!)

⚠️ PRINTABLE PUPPET SHEETS: Always 3:4 or 4:3 — NEVER 1:1!

Style Transfer Rules

• google/nano-banana = text-to-image (from scratch)
• google/nano-banana-edit = image-to-image (transforms ONE input)
• DO NOT pass multiple images — model will MERGE them!
• For style transfer: ONE content image + describe style IN THE PROMPT
• Example: "Transform into impressionistic oil painting with visible brushstrokes, warm cream/gold palette..."

Pipeline Location

/projects/etsy-pipeline/