imini-imagegen

Use this skill when the user wants to generate raster images through the imini image generation API, including text-to-image and image-guided generation with...

Security Scan

The skill's code, instructions, and required environment vars line up with its stated purpose of calling the imini image-generation API; nothing requests unrelated credentials or installs arbitrary code.

Purpose & Capability

Name/description, SKILL.md, references, and the bundled Python script all describe and implement the same behavior (POST /v1/images/generate, poll task, download images). Required items (python3 and IMINI_IMAGE_API_KEY) are appropriate and proportional.

Instruction Scope

Runtime instructions are scoped to collecting prompts/options and running the bundled script. The script only reads declared env vars and performs API calls to the documented base URL and subsequent downloads of image URLs. Note: the script will fetch whatever image URLs are provided (user-supplied reference URLs and result image URLs), so it will perform network downloads; this is expected but means it can contact arbitrary hosts provided by inputs.

Install Mechanism

No install spec (instruction-only with a bundled script) — nothing is downloaded or installed at install time, which is low-risk.

Credentials

Only IMINI_IMAGE_API_KEY is required (with optional IMINI_IMAGE_API_BASE_URL/timeout/poll env vars). The requested env vars match the documented API usage and are proportionate to the skill's function.

Persistence & Privilege

always:false and no special config paths. The agents/openai.yaml enables implicit invocation (allow_implicit_invocation:true), which permits autonomous use by agents — this is common for skills and not by itself a red flag, but be aware agents may call the skill without explicit manual invocation.

Assessment

This skill appears to do exactly what it says: it needs a single API key (IMINI_IMAGE_API_KEY) and python3, calls the imini API, polls for results, and downloads image files. Before installing: (1) do not put real keys into the skill directory or repo — set the env var in your runtime environment only; (2) confirm you trust the imini API host (default base URL is https://openapi.imini.ai/imini/router); (3) be aware the skill will download image URLs (both user-supplied references and returned result URLs), so it will make outward network requests — avoid passing internal/private URLs you don't want fetched; (4) if you do not want agents to call this skill autonomously, remove or modify the implicit-invocation setting in your agent configuration. If you want extra assurance, review the remainder of the bundled script (the truncated portion) to confirm downloads and logging behave exactly as you expect.

Generate images through the imini image generation API using a local API key from environment variables. This skill supports text-to-image and image-guided generation with public image URLs, asks the user to choose a model when they did not specify one, then polls the async task until final images are ready and saved into the workspace.

When To Use

Use this skill when:

• The user wants to generate an image, poster, cover, concept image, or other raster output.
• The user provides a prompt and wants you to actually call the imini API.
• The user provides one or more public image URLs as references for style or content guidance.

Do not use this skill when:

• The user wants SVG, icons, diagrams, or HTML/CSS visuals.
• The task is only to brainstorm or rewrite prompts without actually generating images.
• The only reference input is a local file path; v1 supports public URLs only.

Configuration

The script reads configuration from environment variables. In OpenClaw, declare IMINI_IMAGE_API_KEY in the skill config so the registry and runtime requirements stay aligned.

• IMINI_IMAGE_API_KEY (required)
• IMINI_IMAGE_API_BASE_URL (optional, default https://openapi.imini.ai/imini/router)
• IMINI_IMAGE_TIMEOUT (optional, default 300)
• IMINI_IMAGE_POLL_INTERVAL (optional, default 2)

Do not put real keys into this skill directory, SKILL.md, or command arguments. Setup details live in references/config.md.

Workflow

1. Confirm the request is actual image generation, not vector/UI drawing.
2. Collect the prompt.
3. Optionally collect:
   • model
   • aspect_ratio
   • public image URLs
   • reference mode if the user clearly wants style instead of default asset
4. If the user did not specify a model, ask before generating:

Which model do you want to use?
1. google/nano-banana: faster and lower cost for standard image generation
2. google/nano-banana-pro: higher quality and higher resolution support
3. google/nano-banana-2: most capable option with more aspect ratios and resolutions

If you are not sure, I recommend starting with google/nano-banana.

Do not call the API until the user chooses a model, unless they explicitly ask you to use the default recommendation.

5. Run the bundled script:

python3 /absolute/path/to/imini-imagegen/scripts/generate_image.py \
  --model google/nano-banana \
  --prompt "A shiba inu wearing a spacesuit and standing on the moon, 3D cartoon style" \
  --aspect-ratio 1:1 \
  --out-dir output/imagegen

With references:

python3 /absolute/path/to/imini-imagegen/scripts/generate_image.py \
  --model google/nano-banana \
  --prompt "Keep the main composition and turn it into a cinematic poster with dramatic lighting" \
  --image-url "https://example.com/ref1.jpg" \
  --reference-type asset \
  --out-dir output/imagegen

6. Wait for the script to:
   • submit POST /v1/images/generate
   • poll GET /v1/images/tasks/{task_id}
   • download final images[].url results
7. Report:
   • final saved file paths
   • task status
   • failure reason if the task fails

Input Rules

• prompt is required.
• Supported models:
  • google/nano-banana
  • google/nano-banana-pro
  • google/nano-banana-2
• If the user did not specify a model, ask them to choose before generating.
• If the user asks for a recommendation, prefer google/nano-banana as the default low-friction option.
• resolution defaults to 1K. Higher values should only be used when the chosen model supports them.
• aspect_ratio is optional. Allowed values are documented in references/api.md.
• --image-url count limits depend on the chosen model.
• v1 accepts only public image URLs for references.
• reference_type defaults to asset; use style only when the user clearly wants style transfer behavior.

Failure Handling

If generation fails, check in this order:

1. IMINI_IMAGE_API_KEY is present.
2. The API returned auth or validation errors.
3. Reference URLs are public and reachable.
4. The task status changed to failed.
5. The task timed out before completion.
6. The task succeeded but images was empty or downloads failed.

For API shapes, status values, and exact request fields, read references/api.md.