Agent-Skills.md

Agent Skills: MiniMax Image Skill

Generate images through the MiniMax Image API. Use only when the user names MiniMax or a MiniMax image model such as `image-01` or `image-01-live`; for image requests with no provider named, use the default image skill instead.

UncategorizedID: feiskyer/codex-settings/minimax-image-skill

Repository

feiskyer/codex-settings
feiskyerLicense: MIT
24133

Install this agent skill to your local

pnpm dlx add-skill https://github.com/feiskyer/codex-settings/tree/HEAD/skills/minimax-image-skill

Skill Files

Browse the full folder contents for minimax-image-skill.

Download Skill

Loading file tree…

skills/minimax-image-skill/SKILL.md

Skill Metadata

Name
minimax-image-skill
Description
Generate images through the MiniMax Image API. Use only when the user names MiniMax or a MiniMax image model such as `image-01` or `image-01-live`; for image requests with no provider named, use the default image skill instead.

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 for that model. Optional API fields are exposed through --aspect-ratio, --width, --height, --seed, --n, --response-format, and --disable-prompt-optimizer.

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, report the returned error and ask the user to adjust only that option.
  • Do not claim success unless at least one image was saved locally.