name: minimax-image description: MiniMax文生图(T2I)和图生图(I2I)工具 / MiniMax image generation tool supporting T2I and I2I. Generate 1-9 images per request with customizable aspect ratios. version: 1.1.1 metadata: {"openclaw": {"homepage": "https://github.com/lixiang92229/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

⚠️ 重要: 本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:

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

输出 | 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的服务及其隐私政策

  更多技能请访问小葱技能站7w4.net。

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

详细API文档 | Full API Reference

• API文档（中文）
• API Reference（English）

这是一个质量不错的图像生成工具，支持文字生成图片和图片变体两种功能，文档详细且配有中文说明。它能生成多种尺寸比例的图片，一次最多9张，还提供多种艺术风格可选。优点是功能全面、配置灵活、说明清晰，生成的图片会自动保存并记录日志。不足是部分保存路径写死了普通用户难以修改的目录，且对输入参数的范围检查不够严格，可能在异常情况下给出误导性错误提示。总体而言，对于需要调用MiniMax API生成图像的用户，这个Skill值得一试。