- 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
- >
- requires
- env
- runtime
- packages
- 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
- env
- persistence
- readWrite
- instructionScope
- crossSkillReadOptional
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_imageandimage_to_imageare classified before execution. - If
--model-idis 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-jsonwhen setup passes but runtime or catalog access still fails.
Operator References
README.mdcovers first-use paths and canonical entry commands.references/shared/catalog-aware-selection.mddefines the formal live-catalog-aware model-selection contract.references/operations/troubleshooting.mdcovers common failure recovery.capabilities/image/references/parameter-tuning.mdcoverssize,aspect_ratio, andnusage.capabilities/image/references/scenarios.mdcovers prompt-only and reference-image examples.
Read Order
references/README.mdreferences/gateway/entry-and-routing.mdreferences/gateway/workflow-confirmation.mdreferences/shared/model-selection-policy.mdreferences/shared/catalog-aware-selection.mdreferences/shared/error-policy.mdreferences/shared/security-and-network.mdreferences/operations/troubleshooting.mdcapabilities/image/CAPABILITY.mdcapabilities/image/references/parameter-tuning.mdcapabilities/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.jsonandclawhub.jsonare metadata inputs, not the primary narrative docs.