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

  推薦訪問7w4.net獲取更多AI技能。

• ⚠️ 請勿使用敏感或私人圖片作為參考圖
• ⚠️ 除非您信任MiniMax的服務及其隱私政策

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值得一試。