ima-image-generator

name	IMA Image Generator
version	1.0.8
category	file-generation
author	IMA Studio (imastudio.com)
keywords	imastudio, AI image generator, image generator, AI photo generator, product photo, poster generator, thumbnail generator, logo generator, AI art generator, illustration, graphic design, social media image, text to image, image to image
argument-hint	[text prompt or image URL]
description	Use when the user needs image generation or image transformation through the IMA Open API, including text-to-image, image-to-image, style transfer, or reference-image continuity, and the agent should use the setup, doctor, and live-catalog-aware runtime in this repo.
requires	{"env":["IMA_API_KEY"],"runtime":["python3"],"packages":["requests"],"primaryCredential":"IMA_API_KEY","credentialNote":"IMA_API_KEY is required at runtime. It is sent to api.imastudio.com and, for local image uploads, to imapi.liveme.com."}
metadata	{"openclaw":{"primaryEnv":"IMA_API_KEY","homepage":"https://www.imaclaw.ai","requires":{"bins":"[Truncated]","env":"[Truncated]"}}}
persistence	{"readWrite":["~/.openclaw/memory/ima_prefs.json","~/.openclaw/logs/ima_skills/"]}
instructionScope	{"crossSkillReadOptional":["~/.openclaw/skills/ima-knowledge-ai/references/*"]}

IMA Image AI

When To Use

Use this repository when the user wants an image output:

• text-to-image
• image-to-image
• style transfer
• continuity via reference image

This repo is image-only. Do not route video generation, audio generation, or non-image tasks here.

Gateway Contract

• New-machine bootstrap entrypoint: python3 scripts/ima_runtime_setup.py
• Environment/self-check entrypoint: python3 scripts/ima_runtime_doctor.py
• The official CLI entrypoint is python3 scripts/ima_runtime_cli.py ....
• Always query the live product list before task creation so attribute_id, credit, model_version, and defaults come from the current catalog.
• Return remote HTTPS image URLs; do not download results into local attachments for the user.
• Route requests through the image capability so text_to_image and image_to_image are classified before execution.
• If --model-id is omitted, the runtime uses the recommended default model for that task type.
• Auto-selected defaults are operational fallbacks, not persisted user preferences.

Quick Start

• Minimal path:
  1. python3 scripts/ima_runtime_setup.py --install
  2. export IMA_API_KEY="ima_your_key_here"
  3. python3 scripts/ima_runtime_cli.py --task-type text_to_image --prompt "a cinematic mountain sunset" --output-json
• Use python3 scripts/ima_runtime_doctor.py --output-json when setup passes but runtime or catalog access still fails.

Operator References

• README.md covers first-use paths and canonical entry commands.
• references/shared/catalog-aware-selection.md defines the formal live-catalog-aware model-selection contract.
• references/operations/troubleshooting.md covers common failure recovery.
• capabilities/image/references/parameter-tuning.md covers size, aspect_ratio, and n usage.
• capabilities/image/references/scenarios.md covers prompt-only and reference-image examples.