🎨 minimax-image-gen#

neuroXY 专属 AI 画图技能 | 基于 MiniMax Image API

📌 什么时候用#

✅ 使用这个 skill：

• "画一张图片"
• "生成一张可爱猫咪的照片"
• "用动漫风格画少女"
• "创建一个赛博朋克风格的城市图"

❌ 不要用这个 skill：

• 视频生成 → 找其他工具
• 动画制作 → 找其他工具

🚀 快速开始#

bash

# 基本用法
python {baseDir}/scripts/gen.py -p "可爱的猫"

# 使用风格预设
python {baseDir}/scripts/gen.py -s "小猫" --preset 萌宠

# 生成并预览
python {baseDir}/scripts/gen.py -p "风景" --preview

⚙️ 配置#

API Key 配置#

方式一：环境变量（推荐）

powershell

# Windows
$env:MINIMAX_API_KEY = "your-api-key"

# Mac/Linux
export MINIMAX_API_KEY="your-api-key"

方式二：OpenClaw 配置

json

{
  "skills": {
    "entries": {
      "minimax-image-gen": {
        "enabled": true,
        "env": {
          "MINIMAX_API_KEY": "your-key"
        }
      }
    }
  }
}

方式三：自动加载 本技能会自动从 ~/.openclaw/openclaw.json 读取已配置的 Minimax API Key。

获取 API Key#

访问： https://platform.minimaxi.com/user-center/interface-key

📖 使用指南#

命令行参数#

参数简写说明默认值--prompt``-p图片描述（必填）---subject``-s主体描述（用于预设）---count``-c生成数量 (1-9)1--aspect-ratio``-a宽高比1:1--model``-m模型image-01--preset-风格预设---style-风格类型---out-dir``-o输出目录./output--preview-生成后预览false--list-presets-列出所有预设-

宽高比选项#

值尺寸适用场景1:11024×1024头像、方形图16:91280×720壁纸、横幅4:31152×864照片3:21248×832摄影2:3832×1248竖版人物3:4864×1152竖版肖像9:16720×1280手机壁纸21:91344×576超宽屏

模型说明#

模型说明image-01默认模型，高质量，支持所有宽高比image-01-live动漫/生活风格，支持风格参数

🎭 风格预设#

本技能内置 13 种 精心调优的风格预设：

动漫/二次元#

预设说明推荐宽高比动漫少女动漫少女风格，大眼睛，精致五官3:4漫画风漫画风格，简洁线条1:1

艺术风格#

预设说明推荐宽高比水彩画水彩艺术风格，梦幻氛围16:9浮世绘日本传统浮世绘风格16:9像素艺术8-bit 复古游戏风格1:1

人物/肖像#

预设说明推荐宽高比证件照专业证件照，白底3:4肖像专业人像摄影，影棚灯光3:2

创意/科幻#

预设说明推荐宽高比赛博朋克霓虹灯光，未来科技感16:9

风景/建筑#

预设说明推荐宽高比风景画油画风格风景16:9建筑摄影现代建筑摄影3:2

动物/宠物#

预设说明推荐宽高比萌宠可爱宠物风格，大眼睛1:1

产品/美食#

预设说明推荐宽高比美食摄影餐厅风格美食1:1产品图商业产品摄影1:1

使用预设#

bash

# 使用预设 + 主体
python gen.py -s "穿校服的少女" --preset 动漫少女

# 纯手动
python gen.py -p "赛博朋克城市" --preset 赛博朋克

仅 image-01-live 可用风格#

风格值说明漫画漫画风格元气元气满满中世纪中世纪风格水彩水彩画风

💻 示例#

示例 1：生成萌宠图片#

bash

python gen.py -s "英国短毛猫" --preset 萌宠 --preview

示例 2：创建风景壁纸#

bash

python gen.py -p "日落时的海滩" -a 16:9 -c 3 --preview

示例 3：动漫少女#

bash

python gen.py -s "粉色头发的女孩" --preset 动漫少女 --style 元气 --preview

示例 4：赛博朋克城市#

bash

python gen.py -p "未来的东京街头" --preset 赛博朋克 -c 4 --preview

示例 5：列出所有预设#

bash

python gen.py --list-presets

🔧 高级用法#

自定义输出目录#

bash

python gen.py -p "图片" -o "E:/my-images"

禁用 Prompt 优化#

bash

python gen.py -p "具体描述" --no-optimizer

保存到指定位置并预览#

bash

python gen.py -p "猫" -o "C:/Users/asus/Pictures" --preview

📁 输出#

• 目录: ./output (默认)
• 格式: PNG
• 命名: minimax-{时间戳}-{描述}-{序号}.png

⚠️ 错误处理#

错误码说明解决方案1002限流稍后重试1004API Key 错误检查 Key 是否正确1008余额不足充值1026内容敏感修改 prompt2013参数错误检查参数2049无效 API Key重新获取 Key

🔐 安全特性#

• ✅ 输入验证和清理
• ✅ API Key 不写入日志
• ✅ 敏感信息错误提示
• ✅ SSL/TLS 加密传输
• ✅ 超时保护

🌍 跨平台支持#

平台预览方式Windows默认图片查看器macOSPreview / FinderLinuxxdg-open

📝 更新日志#

v1.1.0 (2026-03-18)#

• 🎉 添加 13 种风格预设
• ✨ 支持风格类型 (漫画/元气/中世纪/水彩)
• 🔧 优化跨平台兼容性
• 🛡️ 增强安全性
• 📖 完善文档

v1.0.0 (2026-03-17)#

• 🎨 初始版本
• ✨ 基本生成功能

📄 License#

MIT License - Created by neuroXY

---

有问题随时问 neuroXY！🦐