MiniMax 图像生成（文本生成图像 & 图像生成图像）

⚠️ 需要一个 Coding Plan API Key
订阅地址：https://platform.minimaxi.com/subscribe/coding-plan

基于 MiniMax 图像生成 API 实现的文本生成图像（t2i）与图像生成图像（i2i）工具。

配置

1. 配置 API Key

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

或在 openclaw.json 的 skills entries 中添加：

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

2. 依赖项

pip install requests

架构

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

使用方法

在终端中使用

# 文本生成图像（t2i）——基础用法
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "海面上壮丽的日落"

# 带参数的文本生成图像
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "一只猫" --model image-01 --aspect-ratio 16:9 --n 2

# 图像生成图像（i2i）——通过 URL 引用参考图像
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "转换为动漫风格" --image-url "https://example.com/photo.jpg"

# 图像生成图像（i2i）——使用 base64 编码图像
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "让画面更明亮" --image-base64 "data:image/jpeg;base64,..."

# 保存结果到文件
MINIMAX_API_KEY="sk-your-key" python3 scripts/minimax_image_gen.py "一只猫" --save cat.png

在代码中调用

from minimax_image_gen import generate_image

# 文本生成图像
result = generate_image(
    prompt="海面上壮丽的日落",
    model="image-01",
    aspect_ratio="16:9",
    n=1
)

# 图像生成图像（URL 方式）
result = generate_image(
    prompt="转换为动漫风格",
    image_url="https://example.com/photo.jpg"
)

# 图像生成图像（base64 方式）
result = generate_image(
    prompt="让画面更明亮",
    image_base64="data:image/jpeg;base64,..."
)

工具定义

名称：minimax_image_gen

输入 Schema：

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "图像描述文本，最长 1500 字符。"
    },
    "model": {
      "type": "string",
      "enum": ["image-01", "image-01-live"],
      "default": "image-01",
      "description": "模型名称。"
    },
    "image_url": {
      "type": "string",
      "description": "图像生成图像（i2i）所用的参考图像 URL。支持公开可访问的 URL。"
    },
    "image_base64": {
      "type": "string",
      "description": "i2i 所用的 base64 格式参考图像 Data URL。格式示例：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": "图像宽高比。"
    },
    "style_type": {
      "type": "string",
      "enum": ["漫画", "元气", "中世纪", "水彩"],
      "description": "风格类型（仅适用于 image-01-live）。"
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "default": 1,
      "description": "生成图像的数量。"
    },
    "response_format": {
      "type": "string",
      "enum": ["url", "base64"],
      "default": "url",
      "description": "返回格式。"
    },
    "prompt_optimizer": {
      "type": "boolean",
      "default": false,
      "description": "启用提示词自动优化功能。"
    }
  },
  "required": ["prompt"]
}

输出：包含图像 URL 或 base64 数据的 JSON

错误码