Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Fix metadata mismatch: MATON_API_KEY is optional (Drive upload only), removed from requires.env
What This Skill Does
Wraps the kie.ai API to generate images using models like Flux, GPT-4o Image, and Gemini 3 Pro at 30-80% lower cost than official APIs. Saves generated files locally and optionally uploads them to Google Drive. Tracks task history and credit usage.
Using kie.ai as a proxy gives access to multiple top-tier image models through a single API key at a fraction of the direct provider cost.
When to use it
- Generating product mockup images at reduced API cost
- Creating high-resolution widescreen images for presentations
- Batch image generation with automatic Google Drive archival
- Checking remaining AI credit balance before a generation run
- Resuming an interrupted image generation task
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Generate a 4K cyberpunk city image in 16:9 and upload it to my Drive
- 1Runs `./kie-ai.sh generate-image "Cyberpunk city" --resolution 4K --aspect 16:9 --upload-drive`
- 2Script authenticates to api.kie.ai using KIE_API_KEY
- 3Submits generation task and polls for completion via task state tracker
- 4Saves the resulting PNG to the local `images/` directory
- 5Uploads the file to the configured Google Drive folder via maton.ai gateway
Image saved locally as `images/2026-03-14-HH-MM-SS-1.png` and uploaded to Google Drive
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.