MiniMax 图片生成技能

功能概览

工作流程

文生图

文本描述 → API 调用 → 自动保存本地 → 返回路径

图生图

参考图 + 文本描述 → API 调用 → 自动保存本地 → 返回路径

快速开始

文生图

import requests
import os
import base64

API_KEY = os.getenv("MINIMAX_API_KEY")
URL = "https://api.minimaxi.com/v1/image_generation"

payload = {
    "model": "image-01",
    "prompt": "一只可爱的小老虎在森林里",
    "aspect_ratio": "16:9",
    "n": 1,
    "response_format": "url"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(URL, json=payload, headers=headers)
result = response.json()
image_url = result["data"]["image_urls"][0]

# 自动下载保存
save_dir = os.path.expanduser("~/.openclaw/workspace/assets/images")
os.makedirs(save_dir, exist_ok=True)
filename = f"generated_{int(time.time())}.jpeg"
save_path = os.path.join(save_dir, filename)

img_response = requests.get(image_url)
with open(save_path, 'wb') as f:
    f.write(img_response.content)

print(f"图片已保存: {save_path}")

图生图

# 读取本地图片并转为 Base64
with open("reference.jpg", "rb") as f:
    img_base64 = base64.b64encode(f.read()).decode()

payload = {
    "model": "image-01",
    "prompt": "same person wearing traditional Chinese Hanfu",
    "aspect_ratio": "3:4",
    "n": 1,
    "subject_reference": [
        {
            "type": "character",
            "image_file": f"data:image/jpeg;base64,{img_base64}"
        }
    ]
}

支持的模型

核心参数

subject_reference 结构

参考图要求

• 格式：JPG, JPEG, PNG
• 大小：小于 10MB
• 最佳效果：单人正面照片

宽高比

风格类型（仅 image-01-live）

输出目录

生成的图片默认保存在：~/.openclaw/workspace/assets/images/

文件名格式：{type}_{timestamp}_{index}.jpeg

• type: text2img / img2img
• timestamp: Unix 时间戳
• index: 多图时的序号

脚本工具

• scripts/generate_image.py - 文生图工具（自动保存本地）
• scripts/image_to_image.py - 图生图工具（自动保存本地）

命令行用法

# 文生图
python generate_image.py "一只可爱的小老虎" --ratio 16:9 --n 3

# 图生图
python image_to_image.py "穿汉服的女孩" --ref path/to/image.jpg --ratio 3:4

API 参考

• references/image-api.md - 完整 API 文档