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:
| Modelo | Id do modelo | Faz | Resolução | Duração | Preço a partir de | Rotas |
|---|---|---|---|---|---|---|
| Hailuo 2.3 | hailuo-2.3 | texto para vídeo, imagem para vídeo | 768p, 1080p | 6 ou 10 s | $0.06 / s | duas rotas |
| Hailuo 2.3 Fast | hailuo-2.3-fast | imagem para vídeo | 768p, 1080p | 6 ou 10 s | $0.04 / s | uma rota |
| Hailuo 2.3 Standard | hailuo-2.3-std | imagem para vídeo | 768p, 1080p | 6 ou 10 s | $0.04 / s | uma rota |
| Hailuo 02 | hailuo-02 | texto para vídeo, imagem para vídeo, primeiro e último quadros | 512p, 768p, 1080p | 5 ou 10 s | $0.02 / s | duas rotas |
| Hailuo 02 Pro | hailuo-02-pro | texto para vídeo, imagem para vídeo | 1080p | 6 s | $0.06 / s | uma rota |
| MiniMax H3 | minimax-h3 | texto para vídeo, imagem para vídeo, primeiro e último quadros, imagens de referência, com som | 768p, 2K | 4 a 15 s | $0.03 / s | três rotas |
| MiniMax H3 Max | minimax-h3-max | texto para vídeo, imagem para vídeo, imagens de referência | 480p, 768p, 1080p | 5 a 15 s | $0.05 / s | uma 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.
| Modelo | Resolução | Por segundo | Clipe de 6 s | Clipe de 10 s |
|---|---|---|---|---|
| Hailuo 2.3 | 768p | $0.06 | $0.36 | $0.60 |
| Hailuo 2.3 | 1080p | $0.09 | $0.54 | Só 6 s |
| Hailuo 2.3 Fast | 768p | $0.04 | $0.24 | $0.40 |
| Hailuo 2.3 Fast | 1080p | $0.06 | $0.36 | Só 6 s |
| Hailuo 02 | 768p | $0.04 | 5 s: $0.20 | $0.40 |
| MiniMax H3 | 768p | $0.03 | $0.18 | $0.30 |
| MiniMax H3 | 2K | $0.04 | $0.24 | $0.40 |
| MiniMax H3 Max | 1080p | $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.
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"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 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);{
"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:
{
"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.