# MiniMax H3 Text to Video (Hailuo-03)

> MiniMax H3 is a frontier AI video model that turns text prompts into stunning 2K videos in just seconds. Generate 5–15 second cinematic clips in seven aspect ratios, perfect for social media, marketing, and professional content.

## Overview

- **Model ID**: `Minimax-h3-t2v`
- **Category**: video
- **Provider**: minimax
- **Source Type**: Closed Source Model
- **Status**: model_ready
- **Screenshot**: `https://assets.modelslab.ai/generations/f38d3782-c54c-4796-9624-dd0d3af36b49.png`

## API Information

This model can be used via our HTTP API. See the API documentation and usage examples below.

### Endpoint

- **URL**: `https://modelslab.com/api/v7/video-fusion/text-to-video`
- **Method**: POST

### Parameters

- **`prompt`** (required): Text description of the video you want to generate
  - Type: textarea
  - Example: Enter prompt for video

- **`duration`** (required): The duration of the video in seconds. Default value: 5  (MIn-5 , Max- 15)
  - Type: number (range: 5-15)

- **`aspect_ratio`** (required): spect Ratio: Sets the aspect ratio of the generated video. Default: 16:9.
  - Type: select (options: 16:9, 21:9, 4:3, 1:1, 3:4, 9:16)

## Usage Examples

### cURL

```bash
curl --request POST \
  --url https://modelslab.com/api/v7/video-fusion/text-to-video \
  --header "Content-Type: application/json" \
  --data '{
    "key": "YOUR_API_KEY",
    "model_id": "Minimax-h3-t2v",
    "prompt": "A lone astronaut walks through a glowing bioluminescent forest on an alien planet at twilight. Towering crystal trees shimmer with neon blue and violet light while floating particles drift through the air. The camera begins with a wide aerial shot, then slowly pushes in to follow the astronaut from behind. Soft volumetric fog, cinematic lighting, realistic reflections, and subtle lens flares create an immersive atmosphere. In the distance, massive floating mountains and two moons dominate the sky. Ultra-realistic, highly detailed, smooth camera motion, natural character movement, epic sci-fi cinematic style, 2K quality.",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'
```

### Python

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v7/video-fusion/text-to-video",
    headers={
        "Content-Type": "application/json"
    },
    json={
        "key": "YOUR_API_KEY",
        "model_id": "Minimax-h3-t2v",
        "prompt": "A lone astronaut walks through a glowing bioluminescent forest on an alien planet at twilight. Towering crystal trees shimmer with neon blue and violet light while floating particles drift through the air. The camera begins with a wide aerial shot, then slowly pushes in to follow the astronaut from behind. Soft volumetric fog, cinematic lighting, realistic reflections, and subtle lens flares create an immersive atmosphere. In the distance, massive floating mountains and two moons dominate the sky. Ultra-realistic, highly detailed, smooth camera motion, natural character movement, epic sci-fi cinematic style, 2K quality.",
        "duration": "5",
        "aspect_ratio": "16:9"
    }
)

print(response.json())
```

### JavaScript

```javascript
fetch("https://modelslab.com/api/v7/video-fusion/text-to-video", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "key": "YOUR_API_KEY",
    "model_id": "Minimax-h3-t2v",
    "prompt": "A lone astronaut walks through a glowing bioluminescent forest on an alien planet at twilight. Towering crystal trees shimmer with neon blue and violet light while floating particles drift through the air. The camera begins with a wide aerial shot, then slowly pushes in to follow the astronaut from behind. Soft volumetric fog, cinematic lighting, realistic reflections, and subtle lens flares create an immersive atmosphere. In the distance, massive floating mountains and two moons dominate the sky. Ultra-realistic, highly detailed, smooth camera motion, natural character movement, epic sci-fi cinematic style, 2K quality.",
    "duration": "5",
    "aspect_ratio": "16:9"
  })
})
.then(response => response.json())
.then(data => console.log(data));
```

## Integration Options

### CLI

Install: `curl -fsSL https://modelslab.sh/install.sh | sh` or `brew install modelslab/tap/modelslab`

```bash
modelslab auth login                                    # Authenticate
modelslab models search "Minimax-h3-t2v"                       # Find this model
modelslab models detail --id Minimax-h3-t2v                    # Get model details
modelslab generate image --prompt "..." --model Minimax-h3-t2v  # Generate with model
modelslab config set generation.default_model Minimax-h3-t2v   # Set as default
```

- Website: https://modelslab.sh
- GitHub: https://github.com/ModelsLab/modelslab-cli

### MCP Servers (Model Context Protocol)

For Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible agent.

- Generation: `https://modelslab.com/mcp/v7` (API key auth, 23 tools)
- Agent Control Plane: `https://modelslab.com/mcp/agents` (Bearer token auth, 10 tools)

Claude Code config (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "modelslab-v7": {
      "url": "https://modelslab.com/mcp/v7",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

- Documentation: https://docs.modelslab.com/mcp-web-api/overview

### Agent Skills

Install skill files directly into AI coding agents:

```bash
npx skills add modelslab/skills --all                          # All skills
npx skills add modelslab/skills --skill image-generation       # Specific skill
npx skills add modelslab/skills --all -a claude-code -a cursor # Target agents
```

- GitHub: https://github.com/ModelsLab/skills
- Documentation: https://docs.modelslab.com/agent-skills

### SDKs

- Python: `pip install modelslab`
- TypeScript: `npm install modelslab`
- PHP: `composer require modelslab/modelslab`
- Go: `go get github.com/modelslab/modelslab-go`
- Dart: `dart pub add modelslab`

## Links

- [Model Playground](https://modelslab.com/models/minimax/minimax-h3-t2v)
- [API Documentation](https://docs.modelslab.com)
- [ModelsLab Platform](https://modelslab.com)