Guia do modelo

API do Hailuo: Hailuo 2.3, Hailuo 02 e MiniMax H3

A MiniMax vende duas linhas de vídeo: os modelos Hailuo, conhecidos pelo movimento vivo, e o mais novo MiniMax H3, com som e saída em 2K. Este guia cobre todas as versões na Revana, quanto cada uma custa por segundo e como chamá-la.

Modelos de vídeo Hailuo e MiniMax em uma só API

O Hailuo é a família de vídeo da MiniMax, conhecida pelo movimento enérgico: ação, dança e movimento físico. O modelo de vídeo mais novo da MiniMax, o H3, é vendido com o nome MiniMax. A Revana oferece as duas linhas no mesmo formato de requisição:

Modelos de vídeo Hailuo e MiniMax comparados
ModeloId do modeloFazResoluçãoDuraçãoPreço a partir deRotas
Hailuo 2.3hailuo-2.3texto para vídeo, imagem para vídeo768p, 1080p6 ou 10 s$0.06 / sduas rotas
Hailuo 2.3 Fasthailuo-2.3-fastimagem para vídeo768p, 1080p6 ou 10 s$0.04 / suma rota
Hailuo 2.3 Standardhailuo-2.3-stdimagem para vídeo768p, 1080p6 ou 10 s$0.04 / suma rota
Hailuo 02hailuo-02texto para vídeo, imagem para vídeo, primeiro e último quadros512p, 768p, 1080p5 ou 10 s$0.02 / sduas rotas
Hailuo 02 Prohailuo-02-protexto para vídeo, imagem para vídeo1080p6 s$0.06 / suma rota
MiniMax H3minimax-h3texto para vídeo, imagem para vídeo, primeiro e último quadros, imagens de referência, com som768p, 2K4 a 15 s$0.03 / strês rotas
MiniMax H3 Maxminimax-h3-maxtexto para vídeo, imagem para vídeo, imagens de referência480p, 768p, 1080p5 a 15 s$0.05 / suma rota

O Hailuo 2.3 Fast e o Standard apenas animam uma imagem que você envia; para um clipe só a partir de um prompt, use o Hailuo 2.3, o Hailuo 02 ou o MiniMax H3.

Qual usar

  • O MiniMax H3 é o mais novo e o mais flexível: clipes de até 15 segundos, som gerado junto com a imagem, até nove imagens de referência e uma configuração 2K por apenas $0.04 por segundo. Ele sempre gera som, então não envie audio: false.
  • O Hailuo 2.3 é a escolha para tomadas com muito movimento, como esporte, dança e acrobacias, a partir de um prompt ou de uma imagem inicial.
  • O Hailuo 2.3 Fast anima uma imagem estática por $0.04 por segundo em 768p, um preço baixo para imagem para vídeo.
  • O Hailuo 02 é o indicado quando você precisa que um clipe comece em uma imagem e termine em outra, e a configuração de 512p, a $0.02 por segundo, é uma forma barata de testar ideias de imagem para vídeo.

Não publicamos notas de qualidade; renderize o mesmo prompt em dois deles e compare.

Preços do Hailuo e do MiniMax (outubro de 2026)

Todos são cobrados por segundo de saída. A tabela mostra a tarifa listada e um clipe típico em cada configuração.

Preço do Hailuo e do MiniMax por segundo e por clipe
ModeloResoluçãoPor segundoClipe de 6 sClipe de 10 s
Hailuo 2.3768p$0.06$0.36$0.60
Hailuo 2.31080p$0.09$0.54Só 6 s
Hailuo 2.3 Fast768p$0.04$0.24$0.40
Hailuo 2.3 Fast1080p$0.06$0.36Só 6 s
Hailuo 02768p$0.045 s: $0.20$0.40
MiniMax H3768p$0.03$0.18$0.30
MiniMax H32K$0.04$0.24$0.40
MiniMax H3 Max1080p$0.16$0.96$1.60

Nem toda rota aceita um clipe de 10 segundos em 1080p nos modelos Hailuo, então conte com 6 segundos em 1080p e use 768p para clipes de 10 segundos. O MiniMax H3 não tem essa lacuna: qualquer duração de 4 a 15 segundos nas duas configurações. Para ver como eles se comparam a outros modelos de vídeo, consulte o guia da API de vídeo mais barata.

Gere um clipe do MiniMax H3

Envie POST /v1/generations e consulte a geração a cada poucos segundos até ela ter succeeded ou failed. Este clipe de 10 segundos em 2K com som custa $0.40.

cURL
export REVANA_API_KEY="sr_live_..."

# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "input": {
      "prompt": "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
      "resolution": "2K",
      "duration": 10,
      "aspect_ratio": "16:9"
    },
    "max_cost_usd": 0.5
  }'

# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
  -H "Authorization: Bearer $REVANA_API_KEY"
Python
import os
import time

import requests

API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}

resp = requests.post(f"{API}/generations", headers=HEADERS, json={
    "model": "minimax-h3",
    "input": {
        "prompt": "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
        "resolution": "2K",
        "duration": 10,
        "aspect_ratio": "16:9",
    },
    "max_cost_usd": 0.5,
})
resp.raise_for_status()
job = resp.json()

while job["status"] in ("queued", "running"):
    time.sleep(5)
    job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()

if job["status"] == "succeeded":
    print(job["output"]["urls"], job["cost_usd"])
else:
    print("Failed:", job["error"])
Node.js
// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
  Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
  "Content-Type": "application/json",
};

const res = await fetch(`${API}/generations`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "minimax-h3",
    input: {
      prompt: "A breakdancer spins on one hand in an empty car park at dusk, the camera circling low around him. Sneakers squeak on concrete, a beat echoes from a speaker.",
      resolution: "2K",
      duration: 10,
      aspect_ratio: "16:9",
    },
    max_cost_usd: 0.5,
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 5000));
  job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}

if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);
Resposta
{
  "id": "gen_01JC2V8K5T",
  "model": "minimax-h3",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC2V8K5T/0.mp4"
    ],
    "duration_s": 10,
    "has_audio": true
  },
  "cost_usd": 0.4,
  "attempts": 1,
  "error": null,
  "created_at": "2026-10-28T10:14:02Z",
  "completed_at": "2026-10-28T10:15:31Z"
}

Anime uma imagem com o Hailuo 2.3 Fast

Para imagem para vídeo, envie o quadro inicial em image_url e descreva o movimento. Este clipe de 6 segundos em 768p custa $0.24:

Corpo da requisição
{
  "model": "hailuo-2.3-fast",
  "input": {
    "prompt": "The dancer leaps and lands in a low crouch, her skirt swirling, the camera pushing in.",
    "image_url": "https://example.com/dancer.jpg",
    "resolution": "768p",
    "duration": 6
  },
  "max_cost_usd": 0.3
}

Uma duração ou resolução que o modelo não lista é recusada na hora com 422 invalid_input, e a mensagem lista o que ele aceita. Requisições recusadas e jobs que falham nunca são cobrados.

Todos os modelos Hailuo e MiniMax estão na página de modelos. Os detalhes campo a campo estão na documentação e os pacotes de créditos na página de preços; obtenha uma chave de API para rodar os exemplos.

Perguntas frequentes

Quanto custa a API do Hailuo?

Em outubro de 2026, o Hailuo 2.3 custa $0.06 por segundo em 768p e $0.09 em 1080p. O Hailuo 2.3 Fast custa $0.04 em 768p. O Hailuo 02 começa em $0.02 por segundo em 512p.

O que é o MiniMax H3?

O modelo de vídeo mais novo da MiniMax. Ele faz clipes de 4 a 15 segundos com som a partir de texto, uma imagem inicial, primeiro e último quadros ou até nove imagens de referência, em 768p ou 2K, a partir de $0.03 por segundo.

O Hailuo faz texto para vídeo?

O Hailuo 2.3, o Hailuo 02 e o Hailuo 02 Pro fazem. O Hailuo 2.3 Fast e o Hailuo 2.3 Standard são só de imagem para vídeo.

Qual a duração máxima de um vídeo do Hailuo?

O Hailuo 2.3 faz clipes de 6 ou 10 segundos e o Hailuo 02 faz clipes de 5 ou 10 segundos; em 1080p, conte com 6 segundos. O MiniMax H3 vai de 4 a 15 segundos.

O MiniMax H3 gera som?

Sim, sempre. O som é gerado junto com a imagem e o preço é o mesmo, então deixe o campo audio de fora.

Experimente Hailuo e MiniMax com uma só chave

Uma chave de API para todos os modelos Hailuo e MiniMax e todos os outros modelos de vídeo e imagem. Crédito pré-pago a partir de $10, cobrado apenas pelos clipes entregues.