MiniMax Image Generation (Text-to-Image & Image-to-Image)#

⚠️ Requires a Coding Plan API Key Subscribe at: https://platform.minimaxi.com/subscribe/coding-plan

Text-to-image (t2i) and image-to-image (i2i) generation tool using MiniMax's image generation API.

---

Setup#

1. Configure API Key#

bash

openclaw config set skills.entries.minimax-image-generator.apiKey "sk-your-key"

Or add to openclaw.json skills entries:

json

{
  "skills": {
    "entries": {
      "minimax-image-generator": {
        "apiKey": "sk-your-key"
      }
    }
  }
}

2. Dependencies#

bash

pip install requests

---

Architecture#

text

~/.openclaw/workspace/skills/minimax-image-generator/
├── SKILL.md
├── _meta.json
└── scripts/
    └── minimax_image_gen.py

---

Usage#

From terminal#

bash

# Text-to-image (t2i) - basic
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "a beautiful sunset over ocean"

# Text-to-image with options
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "a cat" --model image-01 --aspect-ratio 16:9 --n 2

# Image-to-image (i2i) - reference image by URL
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "transform to anime style" --image-url "https://example.com/photo.jpg"

# Image-to-image with base64
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "make it brighter" --image-base64 "data:image/jpeg;base64,..."

# Save to file
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "a cat" --save cat.png

From code#

python

from minimax_image_gen import generate_image

# Text-to-image
result = generate_image(
    prompt="a beautiful sunset over ocean",
    model="image-01",
    aspect_ratio="16:9",
    n=1
)

# Image-to-image (URL)
result = generate_image(
    prompt="transform to anime style",
    image_url="https://example.com/photo.jpg"
)

# Image-to-image (base64)
result = generate_image(
    prompt="make it brighter",
    image_base64="data:image/jpeg;base64,..."
)

---

Tool Definition#

Name: minimax_image_gen

Input Schema:

json

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Image description text, max 1500 chars."
    },
    "model": {
      "type": "string",
      "enum": ["image-01", "image-01-live"],
      "default": "image-01",
      "description": "Model name."
    },
    "image_url": {
      "type": "string",
      "description": "Reference image URL for image-to-image (i2i). Supports public URLs."
    },
    "image_base64": {
      "type": "string",
      "description": "Reference image as base64 Data URL for i2i. Format: data:image/jpeg;base64,..."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": ["1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"],
      "default": "1:1",
      "description": "Image aspect ratio."
    },
    "style_type": {
      "type": "string",
      "enum": ["漫画", "元气", "中世纪", "水彩"],
      "description": "Style (only for image-01-live)."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "default": 1,
      "description": "Number of images to generate."
    },
    "response_format": {
      "type": "string",
      "enum": ["url", "base64"],
      "default": "url",
      "description": "Return format."
    },
    "prompt_optimizer": {
      "type": "boolean",
      "default": false,
      "description": "Enable prompt auto-optimization."
    }
  },
  "required": ["prompt"]
}

Output: JSON with image URLs or base64 data

---

Error Codes#

CodeMeaning0Success1002Rate limit1004Auth failed - check API Key1008Insufficient balance1026Content violation2013Parameter error2049Invalid API Key