MiniMax H3 API: Pricing, Endpoints & Code Examples

curl --request POST \
  --url https://api.minimax.io/v2/video_generation \
  --header "Authorization: Bearer $MINIMAX_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A cinematic tracking shot of a runner crossing a rain-soaked neon street at night, synchronized footsteps and distant city ambience."
      }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9"
  }'

{
  "task_id": "YOUR_TASK_ID"
}

curl --request GET \
  --url https://api.minimax.io/v2/query/video_generation/YOUR_TASK_ID \
  --header "Authorization: Bearer $MINIMAX_API_KEY"

import os
import time
import requests

API_KEY = os.environ["MINIMAX_API_KEY"]
BASE_URL = "https://api.minimax.io"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

payload = {
    "model": "MiniMax-H3",
    "content": [
        {
            "type": "text",
            "text": (
                "A cinematic tracking shot of a runner crossing "
                "a rain-soaked neon street at night."
            ),
        }
    ],
    "resolution": "768P",
    "duration": 5,
    "ratio": "16:9",
}

create_response = requests.post(
    f"{BASE_URL}/v2/video_generation",
    headers=headers,
    json=payload,
)
create_response.raise_for_status()

task_id = create_response.json()["task_id"]
print("Task:", task_id)

while True:
    query_response = requests.get(
        f"{BASE_URL}/v2/query/video_generation/{task_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    query_response.raise_for_status()

    task = query_response.json()["task"]
    status = task["status"]

    if status == "succeeded":
        print("Video:", task["content"]["url"])
        break

    if status in {"failed", "cancelled"}:
        raise RuntimeError(f"Generation ended with status: {status}")

    time.sleep(5)

const API_KEY = process.env.MINIMAX_API_KEY;

async function createH3Video() {
  const response = await fetch(
    "https://api.minimax.io/v2/video_generation",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        model: "MiniMax-H3",
        content: [
          {
            type: "text",
            text: "A cinematic product shot with a slow camera orbit and synchronized studio ambience.",
          },
        ],
        resolution: "768P",
        duration: 5,
        ratio: "16:9",
      }),
    }
  );

  if (!response.ok) {
    throw new Error(`MiniMax API error: ${response.status}`);
  }

  return response.json();
}

createH3Video().then(console.log);

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "The subject slowly turns toward the camera while the camera performs a gentle push-in."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame"
    }
  ],
  "resolution": "768P",
  "duration": 5
}

{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "Use the character appearance from the image and the walking motion and camera movement from the reference video."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/character.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/motion-reference.mp4"
      },
      "role": "reference_video"
    }
  ],
  "resolution": "768P",
  "duration": 5,
  "ratio": "16:9"
}