🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Minimax API
πŸ¦€ ClawHub

Minimax API

by @matthew77

Provides image analysis and description from URLs or local files plus real-time web search using MiniMax's Token Plan API.

Versionv1.0.3
Downloads660
#crypto-defi#writing#legal
TERMINAL
clawhub install minimax-api

πŸ“– About This Skill

name: minimax-api description: Enables image understanding and web search via MiniMax's Token Plan API. Use when asked to analyze/describe images, extract information from images, or search the web. Handles both HTTP/HTTPS image URLs and local file paths (absolute paths). Triggers on: "analyze this image", "describe this picture", "what's in this image", "search the web for", "look up", "web search".

Minimax API

Overview

Provides two capabilities via MiniMax's Token Plan API: 1. Image understanding β€” analyze images via VLM 2. Web search β€” real-time web search

API base URL: https://api.minimaxi.com

Capabilities

1. understand_image

Analyzes an image and returns a text description.

Input:

  • image_url: HTTP/HTTPS URL or absolute local file path (e.g., /home/user/photo.png, D:\images\photo.png)
  • prompt: What to ask about the image

    • Output: Text description from the VLM.

    Script: scripts/minimax_image.py

    Usage: 

    export MINIMAX_API_KEY="your_api_key"
    python3 skills/minimax-api/scripts/minimax_image.py \
  --prompt "Describe this image briefly" \
  --image-url "https://example.com/photo.jpg"
    Or with local file
    
python3 skills/minimax-api/scripts/minimax_image.py \
  --prompt "Extract text from this image" \
  --image-url "/home/user/documents/receipt.png"

    2. web_search

    Performs a web search and returns formatted results.

    Input:

  • query: Search query string

    • Output: JSON with organic results, related searches, and metadata.

    Script: scripts/minimax_search.py

    Usage: 

    export MINIMAX_API_KEY="your_api_key"
    python3 skills/minimax-api/scripts/minimax_search.py \
  --query "MiniMax M2.7 release notes"

    Setup

    Required: A MiniMax API key from platform.minimaxi.com.

    Set it as an environment variable:

    export MINIMAX_API_KEY="your_api_key_here"

    Add the above line to your ~/.bashrc (or .zshrc) to make it permanent.

    Alternatively, pass --api-key directly on the command line (not recommended β€” exposes key in shell history).

    API Reference

    See references/api_spec.md for full API documentation including request/response schemas, error codes, and headers.

    βš™οΈ Configuration

    Required: A MiniMax API key from platform.minimaxi.com.

    Set it as an environment variable:

    export MINIMAX_API_KEY="your_api_key_here"

    Add the above line to your ~/.bashrc (or .zshrc) to make it permanent.

    Alternatively, pass --api-key directly on the command line (not recommended β€” exposes key in shell history).