MiniMax H3 2K - Create video

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/minimax-h3-2k \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
  "webhook_url": "<string>",
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "image_end": "aSDinaTvuI8gbWludGxpZnk=",
  "reference_images": [
    "https://example.com/reference-1.jpg"
  ],
  "reference_videos": [
    "https://example.com/reference-1.mp4"
  ],
  "reference_audios": [
    "https://example.com/reference-voice.mp3"
  ],
  "duration": 5,
  "aspect_ratio": "widescreen_16_9",
  "aigc_watermark": false
}
'

import requests

url = "https://api.magnific.com/v1/ai/video/minimax-h3-2k"

payload = {
    "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
    "webhook_url": "<string>",
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "image_end": "aSDinaTvuI8gbWludGxpZnk=",
    "reference_images": ["https://example.com/reference-1.jpg"],
    "reference_videos": ["https://example.com/reference-1.mp4"],
    "reference_audios": ["https://example.com/reference-voice.mp3"],
    "duration": 5,
    "aspect_ratio": "widescreen_16_9",
    "aigc_watermark": False
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cinematic shot of a cat walking through a neon-lit alley at night',
    webhook_url: '<string>',
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    image_end: 'aSDinaTvuI8gbWludGxpZnk=',
    reference_images: ['https://example.com/reference-1.jpg'],
    reference_videos: ['https://example.com/reference-1.mp4'],
    reference_audios: ['https://example.com/reference-voice.mp3'],
    duration: 5,
    aspect_ratio: 'widescreen_16_9',
    aigc_watermark: false
  })
};

fetch('https://api.magnific.com/v1/ai/video/minimax-h3-2k', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/video/minimax-h3-2k",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A cinematic shot of a cat walking through a neon-lit alley at night',
    'webhook_url' => '<string>',
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'image_end' => 'aSDinaTvuI8gbWludGxpZnk=',
    'reference_images' => [
        'https://example.com/reference-1.jpg'
    ],
    'reference_videos' => [
        'https://example.com/reference-1.mp4'
    ],
    'reference_audios' => [
        'https://example.com/reference-voice.mp3'
    ],
    'duration' => 5,
    'aspect_ratio' => 'widescreen_16_9',
    'aigc_watermark' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.magnific.com/v1/ai/video/minimax-h3-2k"

	payload := strings.NewReader("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}")

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

	req.Header.Add("x-magnific-api-key", "<api-key>")
	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://api.magnific.com/v1/ai/video/minimax-h3-2k")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/minimax-h3-2k")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Hailuo 3

MiniMax H3 2K - Create video

Generate 2K video with MiniMax H3. Supports text-to-video, image-to-video with an optional first and last frame, and subject reference images (up to 9, mentioned in the prompt as @Image1..@Image9). Keyframes and reference images are mutually exclusive. The response is a task: poll the GET endpoint or supply webhook_url to be notified; the finished task carries a time-limited MP4 URL. Reference videos are billed on top of the output duration, capped at 15 seconds.

POST

video

minimax-h3-2k

curl --request POST \
  --url https://api.magnific.com/v1/ai/video/minimax-h3-2k \
  --header 'Content-Type: application/json' \
  --header 'x-magnific-api-key: <api-key>' \
  --data '
{
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
  "webhook_url": "<string>",
  "image": "aSDinaTvuI8gbWludGxpZnk=",
  "image_end": "aSDinaTvuI8gbWludGxpZnk=",
  "reference_images": [
    "https://example.com/reference-1.jpg"
  ],
  "reference_videos": [
    "https://example.com/reference-1.mp4"
  ],
  "reference_audios": [
    "https://example.com/reference-voice.mp3"
  ],
  "duration": 5,
  "aspect_ratio": "widescreen_16_9",
  "aigc_watermark": false
}
'

import requests

url = "https://api.magnific.com/v1/ai/video/minimax-h3-2k"

payload = {
    "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
    "webhook_url": "<string>",
    "image": "aSDinaTvuI8gbWludGxpZnk=",
    "image_end": "aSDinaTvuI8gbWludGxpZnk=",
    "reference_images": ["https://example.com/reference-1.jpg"],
    "reference_videos": ["https://example.com/reference-1.mp4"],
    "reference_audios": ["https://example.com/reference-voice.mp3"],
    "duration": 5,
    "aspect_ratio": "widescreen_16_9",
    "aigc_watermark": False
}
headers = {
    "x-magnific-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-magnific-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    prompt: 'A cinematic shot of a cat walking through a neon-lit alley at night',
    webhook_url: '<string>',
    image: 'aSDinaTvuI8gbWludGxpZnk=',
    image_end: 'aSDinaTvuI8gbWludGxpZnk=',
    reference_images: ['https://example.com/reference-1.jpg'],
    reference_videos: ['https://example.com/reference-1.mp4'],
    reference_audios: ['https://example.com/reference-voice.mp3'],
    duration: 5,
    aspect_ratio: 'widescreen_16_9',
    aigc_watermark: false
  })
};

fetch('https://api.magnific.com/v1/ai/video/minimax-h3-2k', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.magnific.com/v1/ai/video/minimax-h3-2k",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prompt' => 'A cinematic shot of a cat walking through a neon-lit alley at night',
    'webhook_url' => '<string>',
    'image' => 'aSDinaTvuI8gbWludGxpZnk=',
    'image_end' => 'aSDinaTvuI8gbWludGxpZnk=',
    'reference_images' => [
        'https://example.com/reference-1.jpg'
    ],
    'reference_videos' => [
        'https://example.com/reference-1.mp4'
    ],
    'reference_audios' => [
        'https://example.com/reference-voice.mp3'
    ],
    'duration' => 5,
    'aspect_ratio' => 'widescreen_16_9',
    'aigc_watermark' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-magnific-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.magnific.com/v1/ai/video/minimax-h3-2k"

	payload := strings.NewReader("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}")

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

	req.Header.Add("x-magnific-api-key", "<api-key>")
	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://api.magnific.com/v1/ai/video/minimax-h3-2k")
  .header("x-magnific-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/video/minimax-h3-2k")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-magnific-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prompt\": \"A cinematic shot of a cat walking through a neon-lit alley at night\",\n  \"webhook_url\": \"<string>\",\n  \"image\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"image_end\": \"aSDinaTvuI8gbWludGxpZnk=\",\n  \"reference_images\": [\n    \"https://example.com/reference-1.jpg\"\n  ],\n  \"reference_videos\": [\n    \"https://example.com/reference-1.mp4\"\n  ],\n  \"reference_audios\": [\n    \"https://example.com/reference-voice.mp3\"\n  ],\n  \"duration\": 5,\n  \"aspect_ratio\": \"widescreen_16_9\",\n  \"aigc_watermark\": false\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json

prompt

string

required

Text prompt describing the video to generate. Chinese and English are supported. Mention reference images as @Image1, @Image2, ... matching their 1-indexed array order. For best instruction following keep it under roughly 500 Chinese characters or 1,000 English words.

Required string length: 1 - 7000

Example:

"A cinematic shot of a cat walking through a neon-lit alley at night"

webhook_url

string<uri>

URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.

image

string<byte>

Optional image to use as the first frame for image-to-video generation. Accepts a publicly accessible URL or a base64-encoded image. Mutually exclusive with reference_images.

image_end

string<byte>

Optional image to use as the last frame for image-to-video generation. Requires image: the provider rejects a last frame with no first frame. Together they generate a transition video between the two. Mutually exclusive with reference_images. Accepts a publicly accessible URL or a base64-encoded image.

reference_images

string<byte>[]

Up to 9 reference images for reference-to-video generation. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Each image must be JPG, JPEG, PNG, WEBP, HEIC or HEIF, no larger than 30 MB, 256 to 5760 px per side, with an aspect ratio from 0.4 to 2.5. Mutually exclusive with image and image_end.

Maximum array length: 9

Example:

["https://example.com/reference-1.jpg"]

reference_videos

string[]

Up to 3 reference videos. Each item must be a publicly accessible HTTPS URL or a video upload file_id (upl_vid_...). Reference them in the prompt using @Video1, @Video2 or @Video3. Each video must be MP4 or MOV (H.264 or H.265), 2 to 15 seconds, 23.976 to 60 fps, no larger than 50 MB, 256 to 5760 px per side, with an aspect ratio from 0.4 to 2.5, and their combined duration must not exceed 15 seconds. Mutually exclusive with image and image_end. These are billed: their combined duration is added to the output duration, capped at 15 seconds.

Maximum array length: 3

Example:

["https://example.com/reference-1.mp4"]

reference_audios

string<uri>[]

Up to 3 reference audios. Each item must be a publicly accessible HTTPS URL — unlike reference_videos, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2 or @Audio3. Each audio must be WAV or MP3, 2 to 15 seconds and no larger than 15 MB, and their combined duration must not exceed 15 seconds. Audio cannot be the only reference: at least one reference_images or reference_videos entry is required alongside it. Mutually exclusive with image and image_end. Adds nothing to the price.

Maximum array length: 3

Example:

["https://example.com/reference-voice.mp3"]

duration

integer

default:5

Video duration in seconds. Any integer from 4 to 15. H3 accepts 4-second clips, unlike H3 Max, whose floor is 5.

Required range: 4 <= x <= 15

Example:

5

aspect_ratio

enum<string>

default:widescreen_16_9

Output video aspect ratio. Available options:

adaptive: infer the ratio from the reference images
film_horizontal_21_9: Ultra-wide cinematic (21:9)
widescreen_16_9: Standard widescreen (16:9)
classic_4_3: Classic TV format (4:3)
square_1_1: Square format (1:1)
traditional_3_4: Portrait classic (3:4)
social_story_9_16: Vertical/social media story (9:16)

adaptive needs something to adapt to. It only means anything when the request carries reference_images; on a text-only request there is nothing to infer from and it falls back to widescreen_16_9.

Note: ignored when image or image_end is supplied — in keyframe mode the output always follows the aspect ratio of the supplied image.

Available options:

adaptive,

film_horizontal_21_9,

widescreen_16_9,

classic_4_3,

square_1_1,

traditional_3_4,

social_story_9_16

aigc_watermark

boolean

default:false

Whether the provider stamps a visible AI-generated-content watermark on the output video.

Response

OK - The task exists and the status is returned

data

object

required

Show child attributes

Example:

{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}

Get started

APIs

MiniMax H3 2K - Create video

Authorizations

Body

Response