MiniMax Image Generation

MCP Tools

MiniMax文生图(T2I)和图生图(I2I)工具 / MiniMax image generation tool supporting T2I and I2I. Generate 1-9 images per request with customizable aspect ratios.

Install

openclaw skills install lx-minimax-image-generation

Minimax Image Generation Skill

概述 | Overview

通过 MiniMax API 实现**文生图（T2I）和图生图（I2I）**功能。

Supports Text-to-Image and Image-to-Image generation via MiniMax API.

环境变量 | Environment Variables

变量名	必填	说明
`MINIMAX_API_KEY`	是	MiniMax API密钥 / MiniMax API Key

⚠️ 重要: 本skill需要 MINIMAX_API_KEY 环境变量才能运行。请从 MiniMax开放平台获取API Key。

功能 | Features

1. 文生图 Text-to-Image

根据文字描述生成图片 / Generate images from text prompts:

from scripts.image_gen import generate_image

result = generate_image(
    prompt="北京故宫角楼，晴空万里，摄影作品",
    model="image-01",
    aspect_ratio="16:9",
    n=2
)

2. 图生图 Image-to-Image

基于参考图片生成新图，保持人物主体特征 / Create variations using a reference image:

result = generate_image(
    prompt="穿着中国传统服装，站在长城上",
    model="image-01",
    aspect_ratio="3:4",
    subject_reference=[
        {
            "type": "character",
            "image_file": "https://example.com/photo.jpg"  # 或 base64 Data URL
        }
    ],
    n=1
)

3. 画风生成 Style Models (需要订阅 / Requires subscription)

使用 image-01-live 模型指定画风 / Specify artistic styles:

风格 Style	说明
漫画	Comic/ Manga
元气	Energetic/ Youthful
中世纪	Medieval
水彩	Watercolor

result = generate_image(
    prompt="一位中国科学家在实验室",
    model="image-01-live",
    style_type="水彩",
    style_weight=0.8
)

命令行使用 | CLI Usage

# 1. 设置环境变量 / Set environment variable
export MINIMAX_API_KEY="your-api-key-here"

# 2. 文生图 / Text-to-Image
python3 scripts/image_gen.py -p "一只可爱的橘猫在阳光下打盹" -r "16:9" -n 2

# 3. 图生图 / Image-to-Image
python3 scripts/image_gen.py -p "穿着西装" -r "3:4" --reference "https://example.com/photo.jpg"

# 4. 指定画风 / With style
python3 scripts/image_gen.py -p "海边日落" -s "水彩" -r "16:9"

参数说明 | Parameters

参数	默认值	说明
`--prompt, -p`	必填	图片描述，最长1500字符 / Image description, max 1500 chars
`--model, -m`	image-01	模型 / Model: `image-01` 或 `image-01-live`
`--ratio, -r`	1:1	宽高比 / Aspect ratio: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
`--n`	1	生成数量1-9 / Number of images [1-9]
`--style, -s`	-	画风类型（仅image-01-live）/ Style type for image-01-live
`--reference, -ref`	-	参考图URL或base64（用于图生图）/ Reference image URL or base64
`--output, -o`	-	输出路径 / Output file path（默认: /home/ubuntu/.openclaw/workspace/images）
`--base64`	false	返回base64格式 / Return base64 instead of downloading

输出 | Output

默认输出目录: /home/ubuntu/.openclaw/workspace/images/

可通过 --output 参数自定义路径 / Can be customized via --output parameter.

返回 / Returns:

image_urls: 图片URL列表 / List of image URLs
_local_paths: 本地保存路径 / Local saved file paths

⚠️ 安全风险提示 | Security Warnings

1. API密钥安全 / API Key Security

🔐 必须设置 MINIMAX_API_KEY 环境变量
🔐 请勿将API Key提交到版本控制系统
🔐 建议使用限额的API Key，定期轮换

2. 参考图隐私风险 / Reference Image Privacy Risk

⚠️ 图生图功能会将参考图片上传到MiniMax API
⚠️ 请勿使用敏感或私人图片作为参考图
⚠️ 除非您信任MiniMax的服务及其隐私政策

3. 网络访问 / Network Access

🌐 本skill会访问 https://api.minimaxi.com
🌐 生成的图片URL有效期为24小时
🌐 请确认您的网络环境允许访问上述地址

4. 文件写入 / File Write

📁 默认保存到 /home/ubuntu/.openclaw/workspace/images/
📁 可通过 --output 参数修改保存路径
📁 请确保目标目录有写入权限

5. 本地调用日志 / Local Call Log

📝 每次成功调用后，会自动在 /home/ubuntu/.openclaw/workspace/minimax-image-generation-log.md 追加一条日志
📝 记录内容：时间戳、调用类型（T2I/I2I）、prompt摘要（最多80字）、图片数量、宽高比、本地保存路径
📝 如文件不存在，会自动创建（包含表头）
⚠️ 注意：如 workspace 同步到 GitHub 或分享给他人，使用记录也会一并暴露，请知悉

注意事项 | Notes

⚠️ image-01-live 需要会员订阅 / Requires premium subscription
⚠️ 图片URL有效期24小时 / Image URLs expire in 24 hours
图片建议小于10MB / Image should be under 10MB
参考图建议单人正面照片 / Reference: single person, frontal photo works best