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

⚠️ 需要 编程计划 API 密钥
订阅地址：https://platform.minimaxi.com/subscribe/coding-plan

使用 MiniMax 图像生成 API 的文生图（t2i）和图生图（i2i）工具。

---

环境配置

1. 配置 API 密钥

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

或添加到 openclaw.json 的技能条目中：

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

2. 依赖安装

bash
pip install requests

---

目录结构

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

---

使用方法

终端使用

bash

文生图（t2i）- 基础用法

MINIMAXAPIKEY=sk-your-key python3 scripts/minimaximagegen.py 海上美丽的日落

文生图带参数

MINIMAXAPIKEY=sk-your-key python3 scripts/minimaximagegen.py 一只猫 --model image-01 --aspect-ratio 16:9 --n 2

图生图（i2i）- 通过 URL 引用参考图片

MINIMAXAPIKEY=sk-your-key python3 scripts/minimaximagegen.py 转换为动漫风格 --image-url https://example.com/photo.jpg

图生图使用 base64 编码

MINIMAXAPIKEY=sk-your-key python3 scripts/minimaximagegen.py 使其更亮 --image-base64 data:image/jpeg;base64,...

保存到文件

MINIMAXAPIKEY=sk-your-key python3 scripts/minimaximagegen.py 一只猫 --save cat.png

代码调用

python
from minimaximagegen 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,... )

---

工具定义

名称： minimaximagegen

输入模式：
json
{
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

---

错误代码

代码	含义
0	成功
1002

请求频率限制 |
| 1004 | 认证失败 - 检查 API 密钥 |
| 1008 | 余额不足 |
| 1026 | 内容违规 |
| 2013 | 参数错误 |
| 2049 | 无效的 API 密钥 |