A compact web UI for MiniMax translation and media generation.

简体中文

This version builds on v0.1 with a streamlined UI, production hardening, configurable API-key providers, and a new Translation module. PostgreSQL is no longer bundled: connect any reachable PostgreSQL 16+ instance through config/database.yaml.

• Translation with source-language detection
• Image generation
• Text-to-speech
• Music generation
• T2V, I2V, and FL2V video generation
• Encrypted API keys, redacted history, and local media storage
• Optional HTTP Basic authentication and production-safe defaults

Requirements: Docker with Compose v2 and PostgreSQL 16+.

git clone <repo-url> minimax-tool
cd minimax-tool
cp config/database.yaml.example config/database.yaml
$EDITOR config/database.yaml
touch .master_key && chmod 600 .master_key
docker compose up -d --build

Verify and open the app:

curl http://localhost:9060/api/health
# {"status":"ok","db":true,"version":"0.2.0"}

http://localhost:9060

Add a MiniMax API key under Config Center → API Keys, then use Translation or any Studio module.

Use the self-contained stack when an external database is not available:

cp config/database.pg18.yaml.example config/database.pg18.yaml
touch .master_key && chmod 600 .master_key
export POSTGRES_PASSWORD='replace-with-a-strong-password'
docker compose -f docker-compose.pg18.yml up -d --build

PostgreSQL uses the minimax_pg18_data named volume by default. Customize persistence with environment variables:

# Custom named volumes
PG_VOLUME_NAME=my_pg_data UPLOAD_VOLUME_NAME=my_uploads \
  docker compose -f docker-compose.pg18.yml up -d

# Host-directory bind mounts
PG_DATA_PATH=/srv/minimax/postgres UPLOAD_DATA_PATH=/srv/minimax/uploads \
  docker compose -f docker-compose.pg18.yml up -d

Keep POSTGRES_PASSWORD available for every Compose command. PostgreSQL 18 data is mounted at /var/lib/postgresql as required by the official image.

• T2V — text to video
• I2V — first frame plus prompt
• FL2V — first and last frames plus prompt

Camera-control example:

A man picks up a book [push in, crane up], then reads [static shot].

• Usage
• Deployment
• Security
• Architecture

MIT © 2026 MiniMax Tool contributors.