# Showmeai

> Generate images via Showmeai's OpenAI-compatible Images API. Supports nano-banana and gpt-image model series. Default model is nano-banana-pro. Images are NOT saved locally by default (URL only). Use --save flag when the user wants to keep the image.

- Skill: `dvcrn/showmeai` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/showmeai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/showmeai/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/showmeai

---


# Showmeai Image Gen

Generate images via Showmeai's OpenAI-compatible Images API (`/images/generations`).

## Basic Usage

```bash
python3 {baseDir}/scripts/gen.py --prompt "your prompt here"
```

## Options

```bash
# Specify model (default: nano-banana-pro)
python3 {baseDir}/scripts/gen.py --prompt "..." --model nano-banana-pro

# Higher resolution (append -2k or -4k to model name)
python3 {baseDir}/scripts/gen.py --prompt "..." --model nano-banana-pro-2k

# Save image locally (default: NO save, URL only)
python3 {baseDir}/scripts/gen.py --prompt "..." --save

# Save to OSS directory (~/.openclaw/oss/)
python3 {baseDir}/scripts/gen.py --prompt "..." --oss

# Save to custom directory
python3 {baseDir}/scripts/gen.py --prompt "..." --save --out-dir /path/to/dir

# Aspect ratio
python3 {baseDir}/scripts/gen.py --prompt "..." --aspect-ratio 16:9

# Image count
python3 {baseDir}/scripts/gen.py --prompt "..." --count 2
```

## Supported Models

nano-banana series (returns URL, fast):
- nano-banana
- nano-banana-pro  ← default
- nano-banana-2
- nano-banana-pro-2k / nano-banana-pro-4k (high res)

gpt-image series (returns base64, always saved):
- gpt-image-1
- gpt-image-1.5

## Config

Set in `.env` or `~/.openclaw/openclaw.json`:
- `Showmeai_API_KEY` — your Showmeai API key **(required)**
- `Showmeai_BASE_URL` — base URL with /v1 suffix **(required)**; defaults to `https://api.showmeai.art/v1` if not set

## Save Behavior

- Default: no local file, output `MEDIA:<url>` directly
- `--save`: save to `~/.openclaw/media/`
- `--oss`: save to `~/.openclaw/oss/`
- gpt-image models always save to media/ (API returns base64 only)