# MiniMax H3

> MiniMax H3 multimodal video generation via Replicate — one endpoint for text-to-video, first/last-frame image-to-video, and reference-based generation (images, videos, audio cited in the prompt). 4-15 second duration at 768P or 2K.

- **Provider**: replicate
- **Model ID**: minimax/h3
- **Category**: video_generation
- **Credits**: 1510 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (integer, optional): Output duration in seconds. (Default: `5`; Options: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`)
- `last_frame_image` (string, optional): Last frame image for video generation. The final frame of the output video will match this image.
- `first_frame_image` (string, optional): First frame image for video generation. The output video will have the same aspect ratio as this image.
- `reference_audio_urls` (array, optional): Public URLs for up to 3 reference audio clips. (Default: `[]`)
- `prompt` (string, **required**): Text prompt for generation
- `resolution` (string, optional): Output resolution. (Default: `2K`; Options: `768P`, `2K`)
- `reference_image_urls` (array, optional): Public URLs for up to 9 reference images. (Default: `[]`)
- `reference_video_urls` (array, optional): Public URLs for up to 3 reference videos. (Default: `[]`)
- `ratio` (string, optional): Output aspect ratio. Required for text-to-video; adaptive for image-to-video. (Default: `16:9`; Options: `adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`)

## Example Request

```json
{
  "model": "minimax/h3",
  "input": {
    "duration": 5,
    "prompt": "the car revs through the desert",
    "resolution": "2K",
    "ratio": "16:9"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

minimax, video-generation, text-to-video, image-to-video, reference-to-video, multimodal-reference

## Documentation

https://replicate.com/minimax/h3