This project provides a free, zero-configuration API gateway for MiniMax's Hailuo AI models (Text-01, VL-01), targeting developers and researchers who need to integrate advanced AI capabilities like streaming output, speech synthesis/recognition, web search, document analysis, and image interpretation. It offers a ChatGPT-compatible interface, simplifying integration with existing tools and workflows.

How It Works

The project acts as a reverse proxy, extracting user tokens from local storage to authenticate requests to the official MiniMax API. It supports multiple tokens per request, allowing for load balancing or failover across different accounts. The architecture is designed for ease of deployment, with Docker and Docker Compose options, and aims for compatibility with OpenAI's API standards for seamless integration.

Quick Start & Requirements

• Install/Run: docker run -it -d --init --name minimax-free-api -p 8000:8000 -e TZ=Asia/Shanghai vinlic/minimax-free-api:latest
• Prerequisites: Docker, a server with a public IP, and an open port 8000. Requires obtaining a _token from the MiniMax Hailuo AI web interface.
• Setup Time: Minimal, primarily involves Docker setup and token retrieval.
• Docs: https://github.com/LLM-Red-Team/minimax-free-api

Highlighted Details

• Supports MiniMax Text-01 and VL-01 models.
• Offers high-speed streaming output and speech synthesis/recognition.
• Includes capabilities for web search, long document interpretation, and image analysis.
• Provides OpenAI API compatibility for chat completions, audio creation, and transcription.

Maintenance & Community

This project is part of a series of "free-api" projects by LLM-Red-Team, indicating a broader community effort. Specific maintainer details or community channels (like Discord/Slack) are not explicitly listed in the README.

Licensing & Compatibility

The project is presented as a "free API" for testing and research. The README explicitly states: "Only for self-use, prohibited from providing services or commercial use externally." It strongly recommends using the official MiniMax platform for commercial purposes due to the instability of reverse APIs and the risk of account bans.

Limitations & Caveats

This is an unofficial reverse API, subject to instability and potential account suspension by MiniMax. Free hosting options like Render and Vercel may have limitations (e.g., request timeouts, idle shutdowns). Token management and usage are at the user's own risk.