MiniMax H3

MiniMax H3 API. MiniMax's newest video model: text-to-video and image-to-video at 2K, 5-15 seconds.

POST/v1/media/queue

from $0.221/second

Overview

MiniMax H3 — MiniMax's newest video model, generating 2K clips of 5–15 seconds from text or an image. Async operation — submit a job, poll for completion.

Property	Value
Model ID	`minimax/minimax-h3`
Alias	`minimax-h3`
Provider	MiniMax
Inputs	text-to-video, image-to-video
Resolutions	2K
Aspect Ratios	auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Duration	5–15 seconds
Audio Generation	Not supported
Billing	Per job — priced when queued, charged only on success
Pricing	from $0.221/second

Usage

All media models use the async job queue. Submit a job, then poll for the result.

Step 1: Submit Job

Text-to-Video

options.params passes this model's own parameters (see Model parameters).

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'minimax/minimax-h3',
    prompt: 'A cinematic drone shot over a rugged coastline at golden hour',
    options: {
      aspectRatio: 'auto',
      resolution: '2K',
      duration: '5',
      params: {
        aigc_watermark: false,
      },
    },
  }),
});
const { data } = await res.json();
// data.jobId — use this to poll for results

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/minimax-h3", "prompt": "A cinematic drone shot over a rugged coastline", "options": {"aspectRatio": "auto", "resolution": "2K", "duration": "5", "params": {"aigc_watermark": false}}}'

Image-to-Video

Pass a reference image via imageData. By default it is the first frame; set options.imageRole to last_frame to make it the final frame instead.

const res = await fetch('https://api.yepapi.com/v1/media/queue', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'minimax/minimax-h3',
    prompt: 'Animate this scene — clouds drifting, light changing',
    options: {
      resolution: '2K',
      duration: '5',
      imageRole: 'first_frame',
    },
    imageData: {
      mimeType: 'image/jpeg',
      base64: '...', // Base64-encoded image
    },
  }),
});

curl -X POST https://api.yepapi.com/v1/media/queue \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax/minimax-h3", "prompt": "Animate this scene — clouds drifting, light changing", "options": {"resolution": "2K", "duration": "5", "imageRole": "first_frame"}, "imageData": {"mimeType": "image/jpeg", "base64": "..."}}'

Step 2: Poll for Result

const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.video — { mimeType, base64 } when completed

curl https://api.yepapi.com/v1/media/status/JOB_ID \
  -H "x-api-key: YOUR_API_KEY"

Request Body

Parameter	Type	Required	Description	Default
`model`	`string`	Yes	`minimax/minimax-h3` or alias `minimax-h3`	—
`prompt`	`string`	Yes	Text description of the video to generate	—
`options.aspectRatio`	`string`	No	One of: auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	`auto`
`options.resolution`	`string`	No	`2K`	`2K`
`options.duration`	`string` or `number`	No	`5` to `15` (seconds)	`5`
`options.imageRole`	`string`	No	How to use the input image: `first_frame` or `last_frame`	`first_frame`
`options.params`	`object`	No	Model-specific parameters under their own names: `aigc_watermark`. Unknown names return 400	—
`imageData.mimeType`	`string`	No	MIME type of input image (image/png, image/jpeg, image/webp)	—
`imageData.base64`	`string`	No	Base64-encoded input image for image-to-video generation	—

Options are validated when you submit: an unsupported duration, resolution or value returns 400 naming the allowed values.

Model parameters

Pass these inside options.params.

Parameter	Type	Allowed	Description	Default
`aigc_watermark`	`boolean`	—	Add the maker's AI-generated-content watermark	`false`

Features

Text-to-video and image-to-video
2K output, 5–15 seconds
Aspect ratios from 21:9 to 9:16, or auto / adaptive
First or last frame from imageData

Pricing

Tier	≈ Cost/sec	5-second video
2K	$0.221	$1.11

Prices shown are for a 5-second clip at the default settings; longer clips cost proportionally more. Each job is priced when it's queued — the exact quote for your duration, resolution and options — and charged only if it succeeds. Failed or moderated jobs are free.

Info

Video jobs can take several minutes to complete. When capacity is busy, jobs wait in the queue (status stays pending or processing) — no action needed. Results retained for 1 hour.

Under the Hood

MiniMax H3

On this page