# MiniMax Hailuo-03 (H3) Text to Video - Core.Today AI API

> MiniMax Hailuo-03 (H3) text-to-video via Fal.AI. State-of-the-art 2K video generation from a text prompt, 5-15 second duration, native audio, and wide aspect-ratio support (21:9 through 9:16).

- **Provider**: MiniMax
- **Model ID**: minimax/h3/text-to-video
- **Category**: Video Generation
- **Credits**: 3020 per second, tiered by resolution
- **Speed**: Medium
- **Quality**: Ultra

## Features
- State-of-the-art 2K resolution text-to-video generation
- Native audio generation alongside video
- 5-15 second configurable duration
- Wide aspect-ratio support from 21:9 to 9:16

## Use Cases
- High-resolution flagship marketing or hero video content
- Wide-format (21:9) cinematic shots for landing pages or ads
- Vertical (9:16) social clips with native audio
- Short narrative or product showcase videos from a single prompt

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Text prompt for video generation

### Optional
- **duration**: integer (default: 5) - The duration of the video in seconds.
- **resolution**: string (default: 2K) - The resolution of the generated video.
  Options: 768P, 2K
- **aspect_ratio**: string (default: 16:9) - The aspect ratio of the generated video.
  Options: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

## Examples

### Garden scene with natural motion
A gentle nature scene showcasing smooth camera tracking and natural motion at 2K resolution.
```json
{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A white kitten chases a butterfly across a sunlit garden. Gentle camera tracking, natural movement, soft afternoon light filtering through the leaves.",
    "duration": 5,
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }
}
```

### Wide cinematic hero shot
Generate an ultra-wide 21:9 shot suited for landing-page hero video.
```json
{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A sleek electric car drives along a coastal highway at sunset, wide cinematic framing, dramatic lighting.",
    "duration": 10,
    "resolution": "2K",
    "aspect_ratio": "21:9"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Use 21:9 for cinematic landing-page hero shots, or 9:16 for vertical social content — both are supported at full 2K.
- Duration ranges from 5 to 15 seconds; longer clips cost proportionally more at the per-second rate.
- This model generates native audio automatically — no separate audio upload is needed.

## Documentation
https://fal.ai/models/minimax/h3/text-to-video