First-Last Frame to Video

Video Generation

curl --request POST \
  --url https://api.powertokens.ai/minimax/v1/video_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "A little girl grow up.",
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-Hailuo-02",
  "duration": 6,
  "resolution": "1080P"
}
'

import requests

url = "https://api.powertokens.ai/minimax/v1/video_generation"

payload = {
    "prompt": "A little girl grow up.",
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
    "model": "MiniMax-Hailuo-02",
    "duration": 6,
    "resolution": "1080P"
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    prompt: 'A little girl grow up.',
    first_frame_image: 'https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg',
    last_frame_image: 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',
    model: 'MiniMax-Hailuo-02',
    duration: 6,
    resolution: '1080P'
  })
};

fetch('https://api.powertokens.ai/minimax/v1/video_generation', 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.powertokens.ai/minimax/v1/video_generation",
  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 little girl grow up.',
    'first_frame_image' => 'https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg',
    'last_frame_image' => 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',
    'model' => 'MiniMax-Hailuo-02',
    'duration' => 6,
    'resolution' => '1080P'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: <content-type>"
  ],
]);

$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.powertokens.ai/minimax/v1/video_generation"

	payload := strings.NewReader("{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}")

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

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "Bearer <token>")

	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.powertokens.ai/minimax/v1/video_generation")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.powertokens.ai/minimax/v1/video_generation")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = 'Bearer <token>'
request.body = "{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}"

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

{
  "task_id": "106916112212032",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

POST

minimax

video_generation

Video Generation

curl --request POST \
  --url https://api.powertokens.ai/minimax/v1/video_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "A little girl grow up.",
  "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
  "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
  "model": "MiniMax-Hailuo-02",
  "duration": 6,
  "resolution": "1080P"
}
'

import requests

url = "https://api.powertokens.ai/minimax/v1/video_generation"

payload = {
    "prompt": "A little girl grow up.",
    "first_frame_image": "https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg",
    "last_frame_image": "https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg",
    "model": "MiniMax-Hailuo-02",
    "duration": 6,
    "resolution": "1080P"
}
headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    prompt: 'A little girl grow up.',
    first_frame_image: 'https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg',
    last_frame_image: 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',
    model: 'MiniMax-Hailuo-02',
    duration: 6,
    resolution: '1080P'
  })
};

fetch('https://api.powertokens.ai/minimax/v1/video_generation', 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.powertokens.ai/minimax/v1/video_generation",
  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 little girl grow up.',
    'first_frame_image' => 'https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg',
    'last_frame_image' => 'https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg',
    'model' => 'MiniMax-Hailuo-02',
    'duration' => 6,
    'resolution' => '1080P'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: <content-type>"
  ],
]);

$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.powertokens.ai/minimax/v1/video_generation"

	payload := strings.NewReader("{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}")

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

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("Authorization", "Bearer <token>")

	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.powertokens.ai/minimax/v1/video_generation")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .body("{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.powertokens.ai/minimax/v1/video_generation")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = '<content-type>'
request["Authorization"] = 'Bearer <token>'
request.body = "{\n  \"prompt\": \"A little girl grow up.\",\n  \"first_frame_image\": \"https://filecdn.minimax.chat/public/fe9d04da-f60e-444d-a2e0-18ae743add33.jpeg\",\n  \"last_frame_image\": \"https://filecdn.minimax.chat/public/97b7cd08-764e-4b8b-a7bf-87a0bd898575.jpeg\",\n  \"model\": \"MiniMax-Hailuo-02\",\n  \"duration\": 6,\n  \"resolution\": \"1080P\"\n}"

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

{
  "task_id": "106916112212032",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> in the request header.

Headers

Content-Type

enum<string>

default:application/json

required

Media type of the request body. Set to application/json to ensure the request data is in JSON format.

Available options:

application/json

Body

application/json

model

enum<string>

required

Model name. Available value: MiniMax-Hailuo-02.

Note: The first/last frame generation feature does not support 512P resolution.

Available options:

MiniMax-Hailuo-02

last_frame_image

string

required

Use the specified image as the last frame of the video. Supports public URL or Base64-encoded Data URL (data:image/jpeg;base64,...)

Image requirements:
- Format: JPG, JPEG, PNG, WebP
- Size: less than 20MB
- Dimensions: Short side greater than 300px, aspect ratio between 2:5 and 5:2

⚠️ The generated video dimensions follow the first frame image. When the first and last frame images have different dimensions, the model crops the last frame image based on the first frame.

prompt

string

Text description of the video, up to 2000 characters. For MiniMax-Hailuo-02, the [command] syntax is supported for camera movement control. You can add camera movement commands in the prompt using the [command] format for precise camera control.

15 supported camera movement commands:
- Pan left/right: [Pan left], [Pan right]
- Tilt left/right: [Tilt left], [Tilt right]
- Dolly: [Dolly in], [Dolly out]
- Pedestal: [Pedestal up], [Pedestal down]
- Tilt up/down: [Tilt up], [Tilt down]
- Zoom: [Zoom in], [Zoom out]
- Others: [Shake], [Follow], [Static]
Usage rules:
- Combined movements: Multiple commands within the same pair of [] take effect simultaneously, e.g. [Tilt left, Pedestal up]. It is recommended to combine no more than 3 commands.
- Sequential movements: Commands appearing sequentially in the prompt take effect in order, e.g. "...[Dolly in], then...[Dolly out]"
- Natural language: Natural language descriptions of camera movements are also supported, but using standard commands yields more accurate results.

first_frame_image

string

Use the specified image as the first frame of the video. Supports public URL or Base64-encoded Data URL (data:image/jpeg;base64,...)

Image requirements:
- Format: JPG, JPEG, PNG, WebP
- Size: less than 20MB
- Dimensions: Short side greater than 300px, aspect ratio between 2:5 and 5:2

⚠️ The generated video dimensions follow the first frame image.

prompt_optimizer

boolean

Whether to automatically optimize the prompt. Defaults to true. Set to false for more precise control.

duration

integer

Video duration in seconds. Defaults to 6. Available values for first/last frame generation depend on resolution:

Model	768P	1080P
MiniMax-Hailuo-02	`6` or `10`	`6`

resolution

enum<string>

Video resolution. First/last frame generation supports 768P and 1080P:

Model	6s	10s
MiniMax-Hailuo-02	`768P` (default), `1080P`	`768P`

Available options:

768P,

1080P

callback_url

string

Callback URL for receiving task status update notifications. You can configure a callback via the callback_url parameter to receive asynchronous notifications of task status updates.

Address verification: After configuration, the MiniMax server sends a POST request to callback_url with a challenge field in the request body. Your server must echo back the challenge value within 3 seconds to complete verification. Status updates: After successful verification, whenever the task status changes, MiniMax pushes the latest task status to this URL. The pushed data structure matches the response body of the query video generation task API.

The callback returns the following "status" values:

"processing" - Generating
"success" - Success
"failed" - Failed

from fastapi import FastAPI, HTTPException, Request
import json

app = FastAPI()

@app.post("/get_callback")
async def get_callback(request: Request):
    try:
        json_data = await request.json()
        challenge = json_data.get("challenge")
        if challenge is not None:
            # Validation request, echo back challenge
            return {"challenge": challenge}
        else:
            # Status update request, handle accordingly
            # {
            #     "task_id": "115334141465231360",
            #     "status": "success",
            #     "file_id": "205258526306433",
            #     "base_resp": {
            #         "status_code": 0,
            #         "status_msg": "success"
            #     }
            # }
            return {"status": "success"}
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(
        app,  # Required
        host="0.0.0.0",  # Required
        port=8000,  # Required, port is configurable
        # ssl_keyfile="yourname.yourDomainName.com.key",  # Optional, depends on whether SSL is enabled
        # ssl_certfile="yourname.yourDomainName.com.key",  # Optional, depends on whether SSL is enabled
    )

aigc_watermark

boolean

Whether to add a watermark to the generated video. Defaults to false.

Response

200 - application/json

task_id

string

ID of the video generation task, used for subsequent task status queries.

base_resp

object

Show child attributes

Image to Video Generation

Query Video Generation Task Status

Chat Models

Image Models

Video Models

Audio Models

asset library

Authorizations

Headers

Body

Response