spora-ai/spora-plugin-minimax

MiniMax multimodal tools (image, speech, music, lyrics, video) for Spora agents.

v0.5.0 2026-07-12 15:55 UTC

Requires

• php: ^8.4.1
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• illuminate/database: ^13.0
• psr/log: ^3.0
• spora-ai/spora-core: >=0.6.0 <1.0.0
• symfony/http-client-contracts: ^3.6

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.94
• mockery/mockery: ^1.6
• pestphp/pest: ^4.0
• phpstan/phpstan: ^2.1
• phpstan/phpstan-mockery: ^2.0

Suggests

• spora-ai/spora-plugin-media-archive: Browse, filter, and download media generated by this plugin

MIT

Published on Packagist.org on 2026-07-12 16:30 UTC

README

Spora plugin: minimax. The full reference (install, configuration, per-tool parameters, development) has moved to the docs site:

docs.spora-ai.com/develop/plugins/reference/minimax

See the docs site for the canonical reference. The README previously in this repo has been migrated there.

Archived-output filenames

When a MiniMax tool (image, video, music, speech) successfully ingests its output into the Media Archive, the row is persisted with a human-readable filename that downstream surfaces — download links, the Media Archive detail page, the asset_url query parameter — all reflect.

LLM-supplied filename (preferred)

Every MiniMax tool accepts an optional filename ToolParameter. When the agent supplies one, that name is sanitised (path components stripped, only [A-Za-z0-9._-] kept, length capped at 240 chars) and returned with the tool's canonical extension appended. A wrong extension on the user input (e.g. .jpg for music) is overridden to the canonical one (.mp3). The result is never made unique — two ingests of the same user-named asset land in the Media Archive with the same display name, which is the intended behaviour.

Examples:

LLM input	Persisted filename
sunset-at-the-beach	sunset-at-the-beach.png
track.mp3 (music)	track.mp3
song.txt (music)	song.mp3 (wrong ext overridden)
../../etc/passwd.png	etcpasswd.png (paths stripped)
Track.MP3 (music)	Track.mp3 (case-normalised)

Generated fallback

When the agent doesn't supply a filename, the plugin slugifies the prompt (lower-cased, transliterated to ASCII via Transliterator or iconv, non-alphanumerics replaced with -, length capped at 60 chars on a word boundary) and prepends the kind tag. The slug becomes the filename stem:

Prompt	Persisted filename
a red fox	minimax-image-a-red-fox.png
Sonnenuntergang am Strand	minimax-image-sonnenuntergang-am-strand.png
🌅🌊 (no ASCII chars)	minimax-image.png (prefix fallback)
(empty)	minimax-image.png

Filenames are not unique-enforced (media_assets.filename is plain string(255), no unique index). The same prompt ingested twice produces the same name, which is what the operator wants — readable, sortable, predictable.