MiniMax H3

POST

tasks

MiniMax H3

curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "callback_url": "<string>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "resolution": "<string>",
    "duration": 123,
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "callback_url": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    resolution: '<string>',
    duration: 123,
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    callback_url: '<string>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")
  .asString();

MiniMax H3 is MiniMax’s omni-modal video model, released July 2026. One endpoint takes text, images, video and audio as input and renders a finished clip with its own audio track in a single pass — no separate scoring step. Three modes share the endpoint; what you send decides which one runs:

Text to video — prompt only
Image to video — image_urls, or first_frame_image / last_frame_image for an explicit first/last frame
Reference to video — video_urls (camera work and style) or audio_urls (rhythm and score)

Async: the request returns a task_id; poll task status until completed.

Pricing

Prices are not listed here — they follow upstream changes, and anything written into the docs drifts out of date.Live prices: the “Model Market” in the console, or the GET /v1/models endpoint (see Models). What a call actually cost: every response carries cost / usage.cost — that is the authoritative number.

Available models

Model ID	Resolution	Duration (sec)	Audio	Notes
`minimax-h3`	`768p` / `2k`	any integer 4–15	✅ native	Omni-modal input, finished clip with sound in one pass
`minimax-h3-max`	`480p` / `768p`	any integer 4–15	✅ native	Faster, cheaper low-resolution tier with the same capabilities as H3
`minimax-h3-regeneration`	`2k`	any integer 4–15	✅ native	Re-renders an existing 768p H3 clip at native 2K; `video_urls` required

Billed by resolution × duration; 2k costs more. A reference video (video_urls) is billed at 2× the unit price — the upstream charges input-video seconds plus output seconds, and this is an interim approximation; minimax-h3-regeneration’s unit price already includes the input, so it is not doubled. The first 5 reference images are free; beyond that the upstream charges per image, which we currently do not pass on.

Examples

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "a mountain town at dawn, mist lifting, camera pushing from the rooftops toward the ridge",
    "resolution": "2k",
    "duration": 8
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "she slowly lifts her head, wind moves her hair, slight push in",
    "image_urls": ["https://cdn.example.com/portrait.jpg"],
    "resolution": "768p",
    "duration": 6
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "day turns to night, the lights come on one by one",
    "first_frame_image": "https://cdn.example.com/day.jpg",
    "last_frame_image": "https://cdn.example.com/night.jpg",
    "duration": 10
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "same camera rhythm, snowy mountains instead",
    "video_urls": ["https://cdn.example.com/reference.mp4"],
    "audio_urls": ["https://cdn.example.com/bgm.mp3"],
    "resolution": "2k",
    "duration": 12
  }'

Parameters

string

required

Always minimax-h3

string

required

What the shot should show. Write it even when you supply references — the references say what it looks like, the prompt says what happens

string

default:"768p"

768p / 2k

integer

default:"5"

Any integer from 4 to 15 seconds

string[]

Reference images, or the opening frame. Publicly reachable image URLs

string

First-frame image URL

string

Last-frame image URL; pair with first_frame_image for an A-to-B transition

string[]

Reference video — supplies camera movement, pacing and style

string[]

Reference audio — shapes the rhythm and score of the result

string

Called when the task reaches a terminal state; see callbacks

Image mode and reference mode are mutually exclusive. First/last frames (first_frame_image / last_frame_image) cannot be combined with reference media (video_urls / audio_urls) in one request — upstream treats them as two different generation modes.

Limits

Item	Limit
Reference images	up to 9
Reference videos	up to 3, each 2–15 sec
Reference audio	up to 3, each 2–15 sec
Total reference duration	≤ 15 sec
Prompt	≤ 7000 characters

Task system — submit, poll, callbacks
Models — list available models and live prices

MiniMax H3

curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "video_urls": [
    "<string>"
  ],
  "audio_urls": [
    "<string>"
  ],
  "callback_url": "<string>"
}
'

import requests

url = "https://www.qingbo.dev/v1/tasks"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "resolution": "<string>",
    "duration": 123,
    "image_urls": ["<string>"],
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "video_urls": ["<string>"],
    "audio_urls": ["<string>"],
    "callback_url": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    resolution: '<string>',
    duration: 123,
    image_urls: ['<string>'],
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    video_urls: ['<string>'],
    audio_urls: ['<string>'],
    callback_url: '<string>'
  })
};

fetch('https://www.qingbo.dev/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"audio_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\"\n}")
  .asString();

Text Generation

Image Generation

Video Generation

Audio

Tools & Embeddings

Task Management

Pricing

Available models

Examples

Parameters

Limits

​Pricing

​Available models

​Examples

​Parameters

​Limits

​Related

Pricing

Available models

Examples

Parameters

Limits

Related