Command Line

uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png"

Examples

Basic generation

uv run {baseDir}/scripts/generate_image.py -p "a cute cat wearing sunglasses" -f cat.png

With resolution

uv run {baseDir}/scripts/generate_image.py -p "a sunset over mountains" -f sunset.png -r 2K

With explicit API key

uv run {baseDir}/scripts/generate_image.py -p "a robot" -f robot.png --api-key YOUR_API_KEY

API Key

Get your API key from https://apiyi.com/

Set via environment:

export APIYI_API_KEY=your-key-here

Or configure in ~/.openclaw/openclaw.json:

{
  skills: {
    entries: {
      "draw-images-by-apiyi": {
        enabled: true,
        env: {
          "APIYI_API_KEY": "your-key-here"
        }
      }
    }
  }
}

Parameters

Parameter	Values	Default	Description
`--prompt`, `-p`	text	required	Image description
`--filename`, `-f`	path	required	Output filename
`--resolution`, `-r`	`1K`, `2K`, `4K`	`1K`	Output resolution
`--api-key`, `-k`	string	env var	Override environment variable

Output Path

Relative path (e.g., -f out.png) → outputs to current workspace root
Absolute path (e.g., -f /tmp/out.png) → uses specified path

Notes

Resolutions: 1K (1024×1024), 2K (2048×2048), 4K (4096×4096)
The script prints a MEDIA: line for OpenClaw to auto-attach images
Requires APIYI_API_KEY environment variable

draw-images-by-apiyi

Draw Images by APIYI

Usage

Slash Command (Recommended)

Natural Language