ima-nano-banana-image-generator

name	IMA Nano Banana Image Generator
version	1.1.0
category	file-generation
author	IMA Studio (imastudio.com)
keywords	nano banana, nano banana 2, nano banana pro, image generation, gemini image, text to image, image to image, ima studio, ai-nano-banana
argument-hint	[text prompt or image URL]
description	Nano Banana-only image generation on IMA Open API. Supports text_to_image and image_to_image with gemini-3.1-flash-image (budget) and gemini-3-pro-image (premium). Deterministic size/ratio mapping, 512/1K/2K/4K resolution. Requires IMA_API_KEY.
requires	{"env":["IMA_API_KEY"],"primaryCredential":"IMA_API_KEY","credentialNote":"IMA_API_KEY is sent to api.imastudio.com for generation APIs and to imapi.liveme.com only when image_to_image uses local file upload.\n"}
persistence	{"readWrite":["~/.openclaw/memory/ima_prefs.json","~/.openclaw/logs/ima_skills/"],"retention":"Logs are auto-cleaned after 7 days; preferences remain until user deletes them."}

IMA Nano Banana Image Generator

Scope

This skill is for IMA Open API image generation with strict Nano Banana scope:

• Task types: text_to_image, image_to_image
• Allowed model IDs only:
  • gemini-3.1-flash-image
  • gemini-3-pro-image
• Always execute through bundled script: scripts/ima_image_create.py

Out of scope:

• Video or non-image tasks
• Non-IMA providers
• Non-Nano-Banana model families (for example SeeDream, Midjourney)
• Handcrafted API requests (do not bypass script)

Quick Runbook (Authoritative)

If any later section conflicts with this runbook, follow this runbook.

1. Confirm request is in scope (IMA + Nano Banana image generation/editing).
2. Resolve task_type:
   • No reference image -> text_to_image
   • With reference image/edit request -> image_to_image
3. Resolve model:
   • Premium/best quality -> gemini-3-pro-image
   • Cheapest/budget -> gemini-3.1-flash-image + --size 512
   • Otherwise -> gemini-3.1-flash-image
4. Resolve parameters:
   • Size -> --size (512,1K,2K,4K)
   • Ratio -> --extra-params JSON (for example {"aspect_ratio":"16:9"})
5. If user asks 8K, explain unsupported and downgrade to 4K.
6. For image_to_image, require at least one input image.
7. For remote image URLs:
   • Prefer https://
   • If user gives http://, ask for https:// URL or local file
8. Endpoint policy is fixed:
   • Main API: https://api.imastudio.com
   • Upload API: https://imapi.liveme.com
   • No CLI/env override for these domains in this skill.
9. Run only ; do not call API endpoints manually.