IMA AI Image Generator & Photo Generator — Poster, Thumbnail, Logo, Art, Illustration, Product & Social Media Graphic Design

---

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: - python3 env: - IMA_API_KEY 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.

Read Order

1. references/README.md 2. references/gateway/entry-and-routing.md 3. references/gateway/workflow-confirmation.md 4. references/shared/model-selection-policy.md 5. references/shared/catalog-aware-selection.md 6. references/shared/error-policy.md 7. references/shared/security-and-network.md 8. references/operations/troubleshooting.md 9. capabilities/image/CAPABILITY.md 10. capabilities/image/references/parameter-tuning.md 11. capabilities/image/references/scenarios.md

Boundary

references/gateway/* covers entry, routing, and clarification seams.

references/shared/* covers rules reused across the runtime.

capabilities/image/* owns image-specific behavior.

_meta.json and clawhub.json are metadata inputs, not the primary narrative docs.

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.