MiniMaxMediumUltra

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 with images, videos, and audio cited in the prompt. 4-15 second duration at 768P or 2K.

1510 credits

per 5s 2K video — billed per second (768P 186/s, 2K 302/s)

One endpoint for text-to-video, image-to-video, and reference-based generation

First and/or last frame control for precise start and end framing

Up to 9 reference images, 3 reference videos, and 3 reference audio clips

4-15 second duration at 768P or 2K

Seven aspect ratios including adaptive

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3",
  "input": {
    "prompt": "the car revs through the desert",
    "first_frame_image": "https://example.com/car.png",
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt for generation
`first_frame_image`	string	No	-	First frame image. The output video will have the same aspect ratio as this image
`last_frame_image`	string	No	-	Last frame image. The final frame of the output video will match this image
`reference_image_urls`	array	No	-	Public URLs for up to 9 reference images
`reference_video_urls`	array	No	-	Public URLs for up to 3 reference videos
`reference_audio_urls`	array	No	-	Public URLs for up to 3 reference audio clips
`duration`	integer	No	5	Output duration in seconds (4-15). Billed per second 456789101112131415
`resolution`	string	No	2K	Output resolution. 768P bills 186 credits/sec, 2K bills 302 credits/sec 768P2K
`ratio`	string	No	16:9	Output aspect ratio. Required for text-to-video; adaptive for image-to-video adaptive21:916:94:31:13:49:16

How to Provide File Input

There are 3 ways to provide files for the first_frame_imagelast_frame_imagereference_image_urlsreference_video_urlsreference_audio_urls parameters:

Recommended

Image URL

Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.

{
  "model": "minimax/h3",
  "input": {
    "prompt": "your prompt here",
    "first_frame_image": "https://example.com/image.jpg"
  }
}

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=minimax/h3" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:first_frame_image=@your_file.png"

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Image-to-Video from a First Frame

Animate a still image with a prompt-guided motion

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3",
  "input": {
    "prompt": "the car revs through the desert",
    "first_frame_image": "https://example.com/car.png",
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }
}'

Reference-Based Generation

Keep a subject consistent using reference images

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/h3",
  "input": {
    "prompt": "The woman from the reference images walks through a sunlit market, cinematic tracking shot",
    "reference_image_urls": [
      "https://example.com/subject-1.jpg"
    ],
    "duration": 8,
    "resolution": "768P",
    "ratio": "adaptive"
  }
}'