forked from farhoodlabs/skills
feat: add minimax-image-generation skill for MiniMax image generation
Wraps the MiniMax /v1/image_generation API (model: image-01) as a Claude Code skill. Pure bash implementation using curl + jq + base64. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Goose
@@ -0,0 +1,198 @@
|
||||
# MiniMax Image Generation Skill
|
||||
|
||||
Claude Code skill for generating images via the MiniMax API.
|
||||
Wraps the MiniMax `/v1/image_generation` endpoint as a `/minimax-image-generation` slash command.
|
||||
|
||||
## Structure
|
||||
- `SKILL.md` — skill definition (deployed to ~/.claude/skills/minimax-image-generation/)
|
||||
- `scripts/generate.sh` — image generation script
|
||||
- `CLAUDE.md` — implementation notes
|
||||
|
||||
## Commands
|
||||
```bash
|
||||
bash scripts/generate.sh [options]
|
||||
```
|
||||
|
||||
## Rules
|
||||
- The generated image is written to disk as `output-0.jpeg` (and `output-1.jpeg`, etc. for multiple images)
|
||||
- Set `MINIMAX_API_KEY` env var before use
|
||||
- After edits: run `bash scripts/sync.sh` to deploy (if provided)
|
||||
|
||||
---
|
||||
name: minimax-image-generation
|
||||
version: "1.0.0"
|
||||
description: "Generate images from MiniMax's image-01 model. Triggered by phrases like 'generate image', 'create picture', 'minimax image', 'text to image'."
|
||||
argument-hint: '"a sunset over the ocean, cinematic" [--aspect-ratio=16:9] [--num-images=1] [--output=output.jpeg]'
|
||||
allowed-tools: Bash, Read, Write
|
||||
user-invocable: true
|
||||
metadata:
|
||||
openclaw:
|
||||
emoji: "🎨"
|
||||
category: "media"
|
||||
requires:
|
||||
env:
|
||||
- MINIMAX_API_KEY
|
||||
optionalEnv:
|
||||
- MINIMAX_API_BASE_URL
|
||||
bins:
|
||||
- curl
|
||||
- jq
|
||||
primaryEnv: MINIMAX_API_KEY
|
||||
files:
|
||||
- "scripts/*"
|
||||
tags:
|
||||
- image
|
||||
- image-generation
|
||||
- generative-ai
|
||||
- minimax
|
||||
- text-to-image
|
||||
- AI
|
||||
---
|
||||
|
||||
# MiniMax Image Generation
|
||||
|
||||
> Generate images using MiniMax's `image-01` model via the `/v1/image_generation` API.
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# Set your API key
|
||||
export MINIMAX_API_KEY="your-minimax-api-key"
|
||||
|
||||
# Generate an image
|
||||
/minimax-image-generation "a cat wearing a spacesuit, cinematic photography"
|
||||
|
||||
# With options
|
||||
/minimax-image-generation "a sunset over the ocean" --aspect-ratio=16:9 --num-images=1 --output=sunset.jpeg
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Parse User Intent
|
||||
|
||||
Extract from the user's input:
|
||||
|
||||
1. **PROMPT**: The image description (required)
|
||||
2. **ASPECT_RATIO**: `16:9` (default), `1:1`, `9:16`, `4:3`, `3:4`
|
||||
3. **NUM_IMAGES**: Number of images to generate (1–4, default 1)
|
||||
4. **OUTPUT**: Output filename (default `output-{index}.jpeg`)
|
||||
|
||||
---
|
||||
|
||||
## Step 1: Verify Credentials
|
||||
|
||||
```bash
|
||||
if [ -z "${MINIMAX_API_KEY:-}" ]; then
|
||||
echo "ERROR: MINIMAX_API_KEY is not set."
|
||||
echo "Set it with: export MINIMAX_API_KEY='your-api-key'"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
API_BASE_URL="${MINIMAX_API_BASE_URL:-https://api.minimax.io}"
|
||||
echo "Using API base: $API_BASE_URL"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step 2: Call the MiniMax Image Generation API
|
||||
|
||||
```bash
|
||||
PROMPT="a serene mountain landscape at dawn, cinematic, photorealistic"
|
||||
ASPECT_RATIO="${ASPECT_RATIO:-16:9}"
|
||||
NUM_IMAGES="${NUM_IMAGES:-1}"
|
||||
OUTPUT="${OUTPUT:-}"
|
||||
|
||||
URL="${API_BASE_URL}/v1/image_generation"
|
||||
|
||||
response=$(curl -s -X POST "${URL}" \
|
||||
-H "Authorization: Bearer ${MINIMAX_API_KEY}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d "{
|
||||
\"model\": \"image-01\",
|
||||
\"prompt\": \"${PROMPT}\",
|
||||
\"aspect_ratio\": \"${ASPECT_RATIO}\",
|
||||
\"num_images\": ${NUM_IMAGES},
|
||||
\"response_format\": \"base64\"
|
||||
}")
|
||||
|
||||
# Check for errors
|
||||
if echo "$response" | jq -e '.error' >/dev/null 2>&1; then
|
||||
error_msg=$(echo "$response" | jq -r '.error.message // "Unknown error"')
|
||||
echo "ERROR: $error_msg"
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step 3: Decode and Save Images
|
||||
|
||||
```bash
|
||||
images=$(echo "$response" | jq -r '.data.image_base64[]')
|
||||
|
||||
idx=0
|
||||
for image_b64 in $images; do
|
||||
if [ -n "${OUTPUT}" ]; then
|
||||
# Single output filename (use index if multiple images)
|
||||
if [ "$NUM_IMAGES" -gt 1 ]; then
|
||||
filename="${OUTPUT%.*}-${idx}.${OUTPUT##*.}"
|
||||
else
|
||||
filename="$OUTPUT"
|
||||
fi
|
||||
else
|
||||
filename="output-${idx}.jpeg"
|
||||
fi
|
||||
|
||||
echo "$image_b64" | base64 -d > "$filename"
|
||||
echo "Saved: $filename"
|
||||
idx=$((idx + 1))
|
||||
done
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Aspect Ratio Guide
|
||||
|
||||
| Ratio | Use Case |
|
||||
|-------|----------|
|
||||
| `16:9` | Widescreen (default) — desktop wallpaper, banners |
|
||||
| `1:1` | Square — social media posts, profile images |
|
||||
| `9:16` | Portrait — mobile wallpapers, stories |
|
||||
| `4:3` | Standard — presentations, blog images |
|
||||
| `3:4` | Portrait standard — posters, portraits |
|
||||
|
||||
---
|
||||
|
||||
## Configuration Reference
|
||||
|
||||
### Environment Variables
|
||||
|
||||
| Variable | Required | Description |
|
||||
|----------|----------|-------------|
|
||||
| `MINIMAX_API_KEY` | Yes | Your MiniMax API key |
|
||||
| `MINIMAX_API_BASE_URL` | No | API base URL (default: `https://api.minimax.io`) |
|
||||
|
||||
### API Parameters
|
||||
|
||||
| Parameter | Type | Default | Description |
|
||||
|-----------|------|---------|-------------|
|
||||
| `model` | string | `image-01` | Model to use |
|
||||
| `prompt` | string | required | Image description |
|
||||
| `aspect_ratio` | string | `16:9` | Image aspect ratio |
|
||||
| `num_images` | integer | `1` | Number of images (1–4) |
|
||||
| `response_format` | string | `base64` | Output format |
|
||||
|
||||
---
|
||||
|
||||
## Example Output
|
||||
|
||||
```
|
||||
🎨 MiniMax Image Generation
|
||||
├─ Prompt: "a cat wearing a spacesuit, cinematic photography"
|
||||
├─ Aspect ratio: 16:9
|
||||
├─ Model: image-01
|
||||
└─ Generating...
|
||||
|
||||
Saved: output-0.jpeg
|
||||
Done.
|
||||
```
|
||||
Reference in New Issue
Block a user