Setup (Prerequisites)

1. Install mcporter

# 如果未有 npm/npx
npm install -g mcporter

或者用 npx 直接跑：

npx mcporter --help

2. Set MiniMax API Key

响 terminal 度 set 環境變數：

export MINIMAX_API_KEY="your-api-key-here"

或者响 ~/.mcporter/config.json 入面 set：

{
  "env": {
    "MINIMAX_API_KEY": "your-api-key-here",
    "MINIMAX_RESOURCE_MODE": "url"
  }
}

3. Add MiniMax MCP Server

mcporter mcp add minimax-mcp

---

MiniMax MCP Skill

Use mcporter to call MiniMax MCP server tools.

Prerequisites

• mcporter CLI installed
• MiniMax MCP server configured in mcporter

Available Tools

Tool	Description
text_to_image	Generate images from text prompts
text_to_audio	Convert text to speech (TTS)
generate_video	Generate videos from text prompts
image_to_video	Generate videos from images
music_generation	Generate music from prompt + lyrics
voice_clone	Clone voice from audio file
voice_design	Generate voice from description
list_voices	List available voice IDs
play_audio	Play audio file

Basic Usage

Image Generation

mcporter call minimax-mcp.text_to_image prompt:"your prompt" aspectRatio:"4:3"

Audio Generation (TTS)

mcporter call minimax-mcp.text_to_audio text:"Hello world" voiceId:"male-qn-qingse"

Video Generation

mcporter call minimax-mcp.generate_video prompt:"your video description"

Sending to Telegram

IMPORTANT: When MiniMax returns a URL, it includes a query string with authentication token. You MUST use the FULL URL including all query parameters.

Correct (full URL with token):

<MINIMAX_OUTPUT_URL>?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx

Incorrect (URL without token):

<MINIMAX_OUTPUT_URL>

Sending Image to Telegram

1. Call text_to_image and capture the FULL URL (including query string)
2. Send directly to Telegram using message tool with media parameter:

message(
  action="send",
  channel="telegram",
  target="<chat_id>",
  media="<full_url_with_token>",
  message="Your caption"
)

Sending Audio to Telegram

Same approach - use FULL URL with token:

message(
  action="send",
  channel="telegram",
  target="<chat_id>",
  media="<full_url_with_token>",
  message="Your caption"
)

IMPORTANT: When sending audio, ALWAYS include the text content as the message caption below the audio!

Example:

# Generate audio
audio_url = "<MINIMAX_AUDIO_URL>?Expires=xxx&Signature=xxx"
text_content = "呢段係你想既文字內容..."

# Send with both audio and text
message(
  action="send",
  channel="telegram",
  target="<chat_id>",
  media=audio_url,
  message=text_content  # Always include the text!
)

Common Parameters

text_to_image

• prompt: Text description of desired image
• aspectRatio: "1:1", "16:9", "4:3", "3:2", "2:3", "3:4", "9:16", "21:9"
• n: Number of images (1-9)
• model: Model to use (default: "image-01")

text_to_audio

• text: Text to convert to speech
• voiceId: Voice ID (e.g., "male-qn-qingse", "female-shaonv")
• speed: Speech speed (0.5-2)
• emotion: "happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral"
• format: "mp3", "wav", "pcm", "flac"
• languageBoost: Enhance recognition for specific languages/dialects
  • Cantonese: "Chinese,Yue" or "Chinese"
  • Mandarin: "Chinese" or "Chinese,Mandarin"
  • English: "English"
  • Always include this when generating Cantonese audio!

generate_video

• prompt: Video description
• model: "T2V-01", "T2V-01-Director", "I2V-01", "I2V-01-Director", "I2V-01-live", "MiniMax-Hailuo-02"
• duration: 6 or 10 (for MiniMax-Hailuo-02)
• resolution: "768P", "1080P"

Optimization & Troubleshooting

• Timeout Management: Video generation can take significant time (up to 20-30 minutes for high-quality 10s clips). Always pass a large --timeout value (e.g., --timeout 1800000) to mcporter to prevent early termination.
• Gateway Turn Limit: Most OpenClaw profiles have a 10-minute turn timeout (600000ms). To avoid being killed by the gateway, ALWAYS run generate_video with background: true or inside a background process.
• Model Choice: Use MiniMax-Hailuo-02 for higher quality 10-second videos.

Error Handling

If you get 403 Forbidden when sending to Telegram:

• Make sure you're using the FULL URL with query string
• The token (Signature) expires - regenerate if needed

Notes

• MiniMax MCP must be configured with MINIMAX_RESOURCE_MODE=url in mcporter config
• Generated media URLs include authentication tokens that expire
• Always use the complete URL returned by MCP calls

Cantonese (廣東話) Tips

When generating Cantonese audio:

• Use voice ID from Cantonese category (e.g., "Cantonese_PlayfulMan", "Cantonese_CuteGirl")
• Always add: languageBoost:"Chinese,Yue" or languageBoost:"Chinese"
• Example:

  mcporter call minimax-mcp.text_to_audio text:"新年快樂" voiceId:"Cantonese_PlayfulMan" languageBoost:"Chinese,Yue"