---
name: image-generation
description: Generate images using MiniMax API with support for custom prompts, aspect ratios, and multiple image generation.
metadata: {"clawdbot":{"emoji":"🎨","os":["linux","darwin","win32"]}}
---

# MiniMax Image Generation SKILL

## Description

Generate images using MiniMax API. Supports custom prompts, aspect ratios, generation count, and more.

## Usage

```bash
python scripts/run.py --api-key "your-api-key" --prompt "your-prompt" [options]
```

## Arguments

| Argument | Type | Required | Default | Description |
|----------|------|----------|---------|-------------|
| `--api-key` | string | Yes | - | MiniMax API key (can also be set via `MINIMAX_API_KEY` env var) |
| `--prompt` | string | Yes | - | Image generation prompt |
| `--model` | string | No | `image-01` | Image generation model |
| `--aspect-ratio` | string | No | `1:1` | Image aspect ratio (e.g., 16:9, 1:1, 9:16) |
| `--response-format` | string | No | `url` | Response format (`url` or `base64`) |
| `--n` | int | No | `1` | Number of images to generate (1-3) |
| `--prompt-optimizer` | bool | No | `false` | Enable prompt optimizer |
| `--subject-reference` | string | No | - | Reference image URL or local file path for image-to-image generation |
| `--subject-type` | string | No | `character` | Subject reference type (character, product, logo, video_subject, other) |
| `--seed` | int | No | - | Random seed for reproducible generation |
| `--output-dir` | string | No | `./output` | Output directory for images |

## API Reference

- **Endpoint**: `POST https://api.minimaxi.com/v1/image_generation`
- **Auth**: Bearer Token

## Examples

```bash

python scripts/run.py --api-key "sk-xxx" --prompt "A sunset over the ocean"

# Generate multiple images
python scripts/run.py --api-key "sk-xxx" --prompt "A man in a white t-shirt, full-body, standing front view, outdoors" --n 3 --aspect-ratio "16:9"

# Enable prompt optimizer
python scripts/run.py --api-key "sk-xxx" --prompt "sunset ocean" --prompt-optimizer true

# Image-to-image generation with reference image URL
python scripts/run.py --api-key "sk-xxx" --prompt "A girl looking into the distance from a library window" --subject-reference "https://example.com/reference.jpg" --subject-type "character" --n 2

# Image-to-image with local file
python scripts/run.py --api-key "sk-xxx" --prompt "A girl looking into the distance from a library window" --subject-reference "./my_character.jpg" --subject-type "character"

# Image-to-image with product reference
python scripts/run.py --api-key "sk-xxx" --prompt "A beautiful product shot" --subject-reference "https://example.com/product.jpg" --subject-type "product"

# Use seed for reproducible generation
python scripts/run.py --api-key "sk-xxx" --prompt "A sunset over the ocean" --seed 42
```

## Output

Images are saved to the specified output directory with the naming format: `generated_image_{index}_{timestamp}.{ext}`.