MiniMax
About 537 wordsAbout 2 min
Adds MiniMax’s non-text multimodal capabilities — image, speech, music (instrumental, with lyrics, or standalone lyrics), video — to Spora agents. Text/chat is provided by Spora’s built-in Anthropic-compatible driver pointed at MiniMax’s base URL (see below).
Installation
# Recommended — install via the Spora CLI
php bin/spora plugin:install spora-ai/spora-plugin-minimax
php bin/spora spora:install # applies the plugin's migration
# For development against a sibling git clone, pass --path:
php bin/spora plugin:install spora-ai/spora-plugin-minimax --path=/abs/path/to/checkout
# Alternative — drop a clone into the Spora repo
git clone https://github.com/spora-ai/spora-plugin-minimax.git plugins/minimax
php bin/spora spora:installAfter install, tools are exposed as minimax:image, minimax:speech, minimax:music, minimax:video.
Configuration
Settings → Tools → MiniMax. All four tools share the same MINIMAX_API_KEY (issued at https://platform.minimax.io → API Keys).
The default base_url is the Global endpoint (https://api.minimax.io). Operators in China should override base_url to https://api.minimaxi.com for the China-region endpoint.
| Setting | Required | Default |
|---|---|---|
api_key | yes | — |
base_url | no | https://api.minimax.io (Global) |
model | no | per provider (see below) |
voice_id | no | English_PassionateWarrior |
poll_interval_seconds | no | 10 |
poll_timeout_seconds | no | 600 |
api_key fields are encrypted at rest by Spora’s ToolConfigService, masked in the UI, and never logged.
Per-tool parameters
Each tool accepts a prompt and returns ToolResult::ok (with the upstream CDN URL, valid 24h) or ToolResult::fail. Never throws — a single API failure cannot kill the agent loop.
| Tool | Default model | Notes |
|---|---|---|
minimax:image | image-01 | aspect_ratio ∈ 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9 |
minimax:speech | speech-2.8-hd | TTS; voice_id, speed (0.5-2.0) |
minimax:music | music-2.6 | Operations: compose (instrumental or with lyrics, 1-3500 chars), write_lyrics (full song from a topic), edit_lyrics (rewrite existing lyrics) |
minimax:video | MiniMax-Hailuo-2.3 | Async — polls until Success or timeout. Returns file_id (the underlying file-retrieval endpoint is not documented on the public docs and is out of v1 scope). |
The music tool’s action discriminator selects the operation. compose uses /v1/music_generation and accepts an optional lyrics parameter. The write_lyrics and edit_lyrics operations use /v1/lyrics_generation. All three operations share the same api_key, base_url, and (compose-only) model settings.
Every call writes one row to minimax_generation_log (redacted of api_key, Authorization, and base64 blobs > 1 KB) for audit.
Text generation via MiniMax
Spora’s Anthropic-compatible driver talks to MiniMax’s Anthropic-protocol endpoint. Configure any agent with:
llm_provider:anthropicbase_url(Global / international):https://api.minimax.io/anthropicbase_url(China):https://api.minimaxi.com/anthropicllm_api_key: the sameMINIMAX_API_KEYllm_model: e.g.MiniMax-M3
No plugin code is involved.
Development
composer install
./vendor/bin/pest # 19 tests
./vendor/bin/phpstan analyse
./vendor/bin/php-cs-fixer fix --dry-run --diffCI: .github/workflows/ci.yml — Pest on PHP 8.4 + 8.5, PHPStan level 5, php-cs-fixer dry-run. A separate coverage job runs Pest with pcov and uploads coverage.xml + JUnit; the sonar job then uploads both to SonarCloud (project key spora-ai_spora-plugin-minimax), so the new_coverage metric is measurable per PR. Requires the SONAR_TOKEN secret in the repo. MIT license.
Repo: spora-ai/spora-plugin-minimax · MIT