minimax-image-skill

MiniMax Image Skill

Generate images from a text prompt through the bundled MiniMax Image API helper.

Resolve the skill directory

Resolve the absolute directory containing this SKILL.md before running a command and refer to it as <skill-dir>. Keep output paths relative to the user's working directory unless the user requests another location.

Requirements

• Export MINIMAX_API_KEY before running the helper.
• Use Python 3.9 or newer. The helper uses only the Python standard library.

Generate an image

Every option has a working default, so pass only what the request actually constrains:

python3 "<skill-dir>/minimax_image.py" \
  --prompt "A quiet observatory beneath an aurora" \
  --output "observatory.png"

The global endpoint is used by default. Select the China endpoint explicitly when needed:

python3 "<skill-dir>/minimax_image.py" \
  --region china \
  --prompt "A paper-cut landscape at sunrise" \
  --output "landscape.png"

Use --model image-01-live when requested. Consult python3 "<skill-dir>/minimax_image.py" --help for optional fields and accepted values.

The helper downloads URL responses immediately because generated URLs expire. It also decodes base64 responses and creates output parent directories automatically. For multiple results, it adds a numeric suffix to the output filename.

Safety and failures

• Never print or persist the API key.
• Do not call the API until the prompt and local output path pass validation.
• If the API rejects a field combination, correct an assistant-chosen option when the user's requested result is unchanged; ask when resolving it would change a user constraint. Check for generated output before a bounded retry.
• Do not claim success unless at least one image was saved locally.