Em breve

MiniMax

Disponível

minimax-h3-max

MiniMax H3 Max API

Name: MiniMax H3 Max API
Brand: CometAPI
SKU: minimax-h3-max
Price: 0.08 USD
Availability: InStock

coming soon

Preço inicial

Ver preços

Cobrança por uso

Status da API

Disponível

Endpoint de produção

Resposta

Pronto para assíncrono

Tempo de resposta da API observado

Lançado

Aug 31, 2026

MiniMax

API

Copie um endpoint funcional e um exemplo de código, e abra a referência completa da API quando precisar de todos os parâmetros.

Uma API, acesso a modelos pronto para produção

Autentique-se uma vez, chame o endpoint do modelo e mantenha o mesmo fluxo de cobrança e observabilidade entre provedores.

POST/v1/videosGET/v1/videos/{task_id}/contentGET/v1/videos/{task_id}

Código de exemplo e API para MiniMax H3 Max

Acesse código de exemplo abrangente e recursos de API para MiniMax H3 Max para otimizar seu processo de integração. Nossa documentação detalhada fornece orientação passo a passo, ajudando você a aproveitar todo o potencial do MiniMax H3 Max em seus projetos.

POST

/v1/videos

GET

/v1/videos/{task_id}/content

GET

/v1/videos/{task_id}

set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3-max' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

cURL Code Example

set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3-max' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

Python Code Example

import os
import time
from pathlib import Path

import requests


api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}


def get(path: str, timeout: int) -> requests.Response:
    for attempt in range(3):
        try:
            response = requests.get(
                f"{base_url}{path}", headers=headers, timeout=timeout
            )
            response.raise_for_status()
            return response
        except requests.RequestException:
            if attempt == 2:
                raise
            time.sleep(2)
    raise RuntimeError("unreachable")

# 1. Create the task.
form = {
    "model": (None, "minimax-h3-max"),
    "prompt": (
        None,
        "A cinematic view of clouds moving over green mountains, "
        "locked camera, no text.",
    ),
    "seconds": (None, "5"),
    "size": (None, "1344x768"),
}
if image_url := os.getenv("MINIMAX_H3_IMAGE_URL"):
    form["images"] = (None, image_url)

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files=form,
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
print(f"Task: {task_id}")

# 2. Poll until the task finishes.
while True:
    response = get(f"/v1/videos/{task_id}", timeout=30)
    task = response.json()
    status = task["status"]
    print(f"Status: {status}")
    if status == "failed":
        raise RuntimeError(task)
    if status == "completed":
        break
    time.sleep(10)

# 3. Download the completed video.
response = get(f"/v1/videos/{task_id}/content", timeout=300)
output = Path(f"{task_id}.mp4")
output.write_bytes(response.content)
print(f"Saved: {output}")

JavaScript Code Example

import fs from "node:fs";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com";
const headers = { Authorization: `Bearer ${apiKey}` };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function get(path) {
  for (let attempt = 0; attempt < 3; attempt += 1) {
    try {
      const result = await fetch(`${baseUrl}${path}`, { headers });
      if (!result.ok) throw new Error(`${result.status} ${await result.text()}`);
      return result;
    } catch (error) {
      if (attempt === 2) throw error;
      await sleep(2000);
    }
  }
  throw new Error("unreachable");
}

// 1. Create the task.
const form = new FormData();
form.append("model", "minimax-h3-max");
form.append(
  "prompt",
  "A cinematic view of clouds moving over green mountains, locked camera, no text.",
);
form.append("seconds", "5");
form.append("size", "1344x768");
if (process.env.MINIMAX_H3_IMAGE_URL) {
  form.append("images", process.env.MINIMAX_H3_IMAGE_URL);
}

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const taskId = (await response.json()).id;
console.log(`Task: ${taskId}`);

// 2. Poll until the task finishes.
while (true) {
  response = await get(`/v1/videos/${taskId}`);
  const task = await response.json();
  console.log(`Status: ${task.status}`);
  if (task.status === "failed") throw new Error(JSON.stringify(task));
  if (task.status === "completed") break;
  await sleep(10000);
}

// 3. Download the completed video.
response = await get(`/v1/videos/${taskId}/content`);
const output = `${taskId}.mp4`;
fs.writeFileSync(output, Buffer.from(await response.arrayBuffer()));
console.log(`Saved: ${output}`);

Casos de uso

Use MiniMax H3 Max em fluxos de produção compatíveis com suas capacidades de video, e compare alternativas antes de um compromisso de integração de longo prazo.

Conceitos de texto para vídeo e conteúdo social

Demos de produto e storyboards cinematográficos

Movimento de imagem para vídeo e iteração criativa

Outros modelos

Compare outros modelos disponíveis na CometAPI considerando qualidade, latência, capacidades e preço.

Abrir comparação de modelos →

Aliyun

Wan3.0

From fast verification to cinematic output, billing is based on the generated video duration, selecting the appropriate resolution, and turning every generation into a planned creative investment activity rule

Ver modelo

Flux

Flux 3

FLUX 3 - Real World Models: Towards Multimodal Flow Models as the Backbone of Visual Intelligence.

Ver modelo

Aliyun

Happy Horse 1.1

HappyHorse 1.1 é um modelo multimodal de geração de vídeo projetado para criação de conteúdo profissional, publicidade, curtas-metragens, produção para redes sociais e narrativa. Ele amplia as capacidades do HappyHorse 1.0 — que recebeu grande atenção após ficar bem classificado em avaliações independentes de geração de vídeo — com maior coerência entre cenas e fidelidade visual aprimorada.

Ver modelo

Bytedance

Seedance 2-0

Seedance 2.0 é o modelo base multimodal de vídeo de próxima geração da ByteDance, focado na geração de vídeos narrativos cinematográficos de múltiplos planos. Diferentemente de demonstrações de texto para vídeo de plano único, Seedance 2.0 enfatiza o controle baseado em referências (imagens, clipes curtos, áudio), a consistência de personagens/estilo entre os planos e a sincronização nativa de áudio/vídeo — visando tornar o vídeo com IA útil para fluxos de trabalho criativos profissionais e de pré-visualização.

Ver modelo

Google

Gemini omni fast

Gemini Omni Fast is a lightweight multimodal video generation model designed for fast and flexible content creation. It enables efficient video generation with support for multiple input types, making it suitable for interactive and iterative workflows.

Ver modelo

OpenAI

Sora 2 Pro

Sora 2 Pro é nosso modelo de geração de mídia mais avançado e poderoso, capaz de gerar vídeos com áudio sincronizado. Ele pode criar clipes de vídeo detalhados e dinâmicos a partir de linguagem natural ou imagens.

Ver modelo

Uptime

Veja dados de heartbeat em tempo real, disponibilidade do endpoint e tempos de resposta observados antes de ir para produção.

Continue explorando

Compare modelos e continue sua pesquisa

Código de exemplo e API para MiniMax H3 Max

set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3-max' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

cURL Code Example

set -euo pipefail

# 1. Create the task.
task=$(curl --fail-with-body --silent --show-error \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=minimax-h3-max' \
  --form-string 'prompt=A cinematic view of clouds moving over green mountains, locked camera, no text.' \
  --form-string 'seconds=5' \
  --form-string 'size=1344x768')
# Add --form-string 'images=https://example.com/reference.jpg' for image-to-video.

task_id=$(jq -r '.id' <<<"$task")
echo "Task: ${task_id}"

# 2. Poll until the task finishes.
while true; do
  task=$(curl --fail-with-body --silent --show-error \
    --retry 3 --retry-all-errors --retry-delay 2 \
    "https://api.cometapi.com/v1/videos/${task_id}" \
    -H "Authorization: Bearer $COMETAPI_KEY")
  status=$(jq -r '.status' <<<"$task")
  echo "Status: $status"
  [[ "$status" == "failed" ]] && { echo "$task" >&2; exit 1; }
  [[ "$status" == "completed" ]] && break
  sleep 10
done

# 3. Download the completed video.
curl --fail-with-body --silent --show-error \
  --retry 3 --retry-all-errors --retry-delay 2 \
  "https://api.cometapi.com/v1/videos/${task_id}/content" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output "${task_id}.mp4"
echo "Saved: ${task_id}.mp4"

Python Code Example

import os
import time
from pathlib import Path

import requests


api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}


def get(path: str, timeout: int) -> requests.Response:
    for attempt in range(3):
        try:
            response = requests.get(
                f"{base_url}{path}", headers=headers, timeout=timeout
            )
            response.raise_for_status()
            return response
        except requests.RequestException:
            if attempt == 2:
                raise
            time.sleep(2)
    raise RuntimeError("unreachable")

# 1. Create the task.
form = {
    "model": (None, "minimax-h3-max"),
    "prompt": (
        None,
        "A cinematic view of clouds moving over green mountains, "
        "locked camera, no text.",
    ),
    "seconds": (None, "5"),
    "size": (None, "1344x768"),
}
if image_url := os.getenv("MINIMAX_H3_IMAGE_URL"):
    form["images"] = (None, image_url)

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files=form,
    timeout=60,
)
response.raise_for_status()
task_id = response.json()["id"]
print(f"Task: {task_id}")

# 2. Poll until the task finishes.
while True:
    response = get(f"/v1/videos/{task_id}", timeout=30)
    task = response.json()
    status = task["status"]
    print(f"Status: {status}")
    if status == "failed":
        raise RuntimeError(task)
    if status == "completed":
        break
    time.sleep(10)

# 3. Download the completed video.
response = get(f"/v1/videos/{task_id}/content", timeout=300)
output = Path(f"{task_id}.mp4")
output.write_bytes(response.content)
print(f"Saved: {output}")

JavaScript Code Example

import fs from "node:fs";

const apiKey = process.env.COMETAPI_KEY;
const baseUrl = "https://api.cometapi.com";
const headers = { Authorization: `Bearer ${apiKey}` };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function get(path) {
  for (let attempt = 0; attempt < 3; attempt += 1) {
    try {
      const result = await fetch(`${baseUrl}${path}`, { headers });
      if (!result.ok) throw new Error(`${result.status} ${await result.text()}`);
      return result;
    } catch (error) {
      if (attempt === 2) throw error;
      await sleep(2000);
    }
  }
  throw new Error("unreachable");
}

// 1. Create the task.
const form = new FormData();
form.append("model", "minimax-h3-max");
form.append(
  "prompt",
  "A cinematic view of clouds moving over green mountains, locked camera, no text.",
);
form.append("seconds", "5");
form.append("size", "1344x768");
if (process.env.MINIMAX_H3_IMAGE_URL) {
  form.append("images", process.env.MINIMAX_H3_IMAGE_URL);
}

let response = await fetch(`${baseUrl}/v1/videos`, {
  method: "POST",
  headers,
  body: form,
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const taskId = (await response.json()).id;
console.log(`Task: ${taskId}`);

// 2. Poll until the task finishes.
while (true) {
  response = await get(`/v1/videos/${taskId}`);
  const task = await response.json();
  console.log(`Status: ${task.status}`);
  if (task.status === "failed") throw new Error(JSON.stringify(task));
  if (task.status === "completed") break;
  await sleep(10000);
}

// 3. Download the completed video.
response = await get(`/v1/videos/${taskId}/content`);
const output = `${taskId}.mp4`;
fs.writeFileSync(output, Buffer.from(await response.arrayBuffer()));
console.log(`Saved: ${output}`);