

Como Usar o MiniMax Hailuo 02: Guia Completo
Aprenda a usar o MiniMax Hailuo 02 na APIMart: gere uma chave de API, estruture pedidos texto-para-vídeo e imagem-para-vídeo e renderize clipes cinematográficos em 1080p.
O MiniMax Hailuo 02 é um modelo de IA poderoso para criar vídeos com qualidade cinematográfica e controle preciso sobre imagem, movimento e efeitos. Ele está disponível na APIMart pela MiniMax Hailuo 02 API e suporta texto-para-vídeo, imagem-para-vídeo e transições entre primeiro e último frame, gerando clipes curtos de alta qualidade em resoluções de até 1080p. Veja o que você precisa saber:
- Recursos principais: crie vídeos a partir de prompts de texto, de um primeiro frame ou de um par de primeiro e último frame, e descreva o movimento de câmera diretamente no prompt.
- Preço: em outubro de 2026, clipes em 1080p custam US$ 0,08 por segundo na APIMart; confira os preços atuais na página do modelo.
- Configuração: gere uma chave de API, estruture o pedido com os parâmetros e use polling assíncrono para obter os vídeos.
- Aplicações: ideal para anúncios, vitrines de produto, storyboards e vídeos de treinamento.
Para começar, crie uma conta na APIMart, guarde sua chave de API em segurança e siga o guia passo a passo para gerar vídeos. Use prompts específicos e indicações de câmera claras para tirar o máximo da qualidade. Para projetos mais longos, junte vários clipes usando frames consistentes ou experimente o Kling V3 API como alternativa de geração cinematográfica.
Principais pontos
- O MiniMax Hailuo 02 gera, pela APIMart, clipes de texto-para-vídeo, imagem-para-vídeo e transições do primeiro ao último frame em até 1080p, usando o ID de modelo MiniMax-Hailuo-02.
- O fluxo é: criar uma conta na APIMart, gerar em API Key Management uma chave exibida só uma vez, enviar um corpo JSON por POST para
https://api.apimart.ai/v1/videos/generationse consultar /v1/tasks/{task_id} a cada 15–30 segundos até o status ser completed. - Os parâmetros principais são prompt, duration de 5 ou 10 segundos, resolution de 512p, 768p ou 1080p, first_frame_image e last_frame_image como URL pública ou Base64, e prompt_optimizer, ativado por padrão.
- Em outubro de 2026, o Hailuo 02 custa na APIMart US$ 0,0104 por segundo em 512p, US$ 0,04 em 768p e US$ 0,08 em 1080p; o vídeo pronto é lido em data.result.videos[0].url[0], e os resultados ficam guardados por 72 horas, então salve os arquivos logo.
- Na APIMart, 1080p só aceita clipes de 5 segundos e não há áudio nativo; vídeos com mais de 10 segundos são encadeados usando o último frame como próximo first_frame_image.
MiniMax Hailuo 02 em resumo
| Especificação | Detalhes |
|---|---|
| Desenvolvedor | MiniMax |
| Entradas | Prompt de texto; imagens opcionais de primeiro e último frame como URL pública ou Base64 |
| Saída | Vídeo em 512p, 768p ou 1080p; 1080p só aceita clipes de 5 segundos |
| Duração do clipe | 5 ou 10 segundos; clipes de 10 segundos exigem 768p ou 512p |
| Áudio | Sem áudio nativo; combine com ferramentas do MiniMax Audio, como Speech 2.8 ou Music 2.6 |
| Recursos principais | Direção de câmera escrita no prompt; prompt_optimizer ativado por padrão; opção fast_pretreatment |
| Preço na APIMart (out. de 2026) | US$ 0,0104/s em 512p, US$ 0,04/s em 768p, US$ 0,08/s em 1080p |
| Disponibilidade | APIMart, ID de modelo MiniMax-Hailuo-02, POST https://api.apimart.ai/v1/videos/generations |
| Melhor para | Anúncios, vitrines de produto, storyboards, vídeos de treinamento, B-roll com água, fogo, fumaça e tecido |
| Limites | task_id assíncrono; resultados guardados por 72 horas |
Primeiros passos com o MiniMax Hailuo 02 na APIMart

Configuração da conta e acesso à chave de API
Para começar, acesse apimart.ai e crie uma conta. Se você trabalha em equipe, a APIMart permite criar uma organização. Assim, todos compartilham um saldo central, o que facilita a colaboração sem precisar trocar credenciais pessoais.
Com a conta pronta, adicione fundos ao saldo compartilhado. Esse saldo vale para todos os modelos da APIMart, inclusive opções de ponta como o Veo 3.1 API para geração de vídeo profissional. Depois, vá até a seção API Key Management no painel do console e gere uma chave de API.
Atenção: sua chave de API é exibida apenas uma vez. Copie-a e guarde em local seguro, como um gerenciador de senhas ou um cofre de segredos. Ao usar a chave no código, carregue-a de uma variável de ambiente (por exemplo, APIMART_API_KEY) em vez de colocá-la diretamente no código. Isso reduz o risco de exposição acidental se o código for compartilhado ou enviado para o controle de versão. Toda requisição à API vai incluir essa chave no cabeçalho de autorização:
Authorization: Bearer YOUR_API_KEY
Para equipes, o recurso Organizations é uma ótima forma de gerenciar o acesso de maneira centralizada, sem compartilhar credenciais individuais [2]. Com a chave de API pronta, você pode configurar os parâmetros do pedido e começar a gerar vídeos. Você também pode experimentar o Grok Imagine Video API como alternativa de alta qualidade.
Parâmetros principais dos pedidos ao MiniMax Hailuo 02
Com a chave de API protegida, é hora de montar o pedido com os parâmetros certos. O campo "model": "MiniMax-Hailuo-02" é obrigatório, além de alguns outros. Veja os mais importantes:
| Parâmetro | Tipo | Descrição | Observações |
|---|---|---|---|
model | string | Identifica o modelo | Deve ser MiniMax-Hailuo-02 |
prompt | string | Descreve a cena, a ação e o estilo | Obrigatório |
duration | integer | Duração do clipe em segundos | 5 (padrão) ou 10; 1080p só aceita 5 s |
resolution | string | Qualidade de saída | 512p, 768p (padrão) ou 1080p |
first_frame_image | string | Frame inicial para imagem-para-vídeo | URL pública ou data URI em Base64 |
last_frame_image | string | Frame final para o modo de início e fim | URL pública ou data URI em Base64 |
prompt_optimizer | boolean | Refina o prompt automaticamente | true por padrão; recomendado |
Um detalhe importante: a geração de vídeo é assíncrona. Ao enviar um pedido, a API responde com um task_id, e não com o vídeo. Você precisa consultar /v1/tasks/{task_id} a cada 15–30 segundos até o status mudar para "completed". Quando estiver pronto, baixe o vídeo logo: os resultados ficam guardados por 72 horas [1].
Com os parâmetros definidos, você pode se concentrar em escrever um prompt eficaz para aproveitar ao máximo o MiniMax Hailuo 02.
Como escrever prompts eficazes
Um bom prompt é a chave para gerar vídeos de qualidade. Um prompt bem estruturado inclui seis elementos: plano ou movimento de câmera, sujeito e descrição, ação, cenário, iluminação e estilo ou clima. Por exemplo, em vez de uma descrição vaga como "uma mulher andando na cidade", tente algo mais específico: "Plano de acompanhamento: uma mulher de casaco vermelho caminha apressada por uma rua de Manhattan encharcada de chuva ao entardecer, letreiros de neon refletindo na calçada molhada, estilo noir cinematográfico."
Para deixar seus vídeos dinâmicos, descreva o movimento de câmera com palavras simples no início do prompt, como "push in lento", "plano de acompanhamento" ou "plano fixo". A documentação do Hailuo 02 na APIMart não traz uma lista de comandos de câmera entre colchetes; os 15 comandos em chinês entre colchetes apresentados mais adiante neste guia estão documentados para o Hailuo 2.3.
Em cenas complexas, deixe prompt_optimizer como true. Esse recurso refina e amplia sua descrição automaticamente, o que muitas vezes resulta em vídeos mais fluidos e coerentes com pouco esforço [1].
Como criar vídeos cinematográficos com IA no Hailuo 02
Guia passo a passo: gerando vídeos com o MiniMax Hailuo 02

Como fazer um pedido básico de texto-para-vídeo
Com a chave de API e o prompt prontos, enviar o primeiro pedido é fácil. Faça uma chamada POST para https://api.apimart.ai/v1/videos/generations, inclua seu token Bearer no cabeçalho e use um corpo JSON como este:
{
"model": "MiniMax-Hailuo-02",
"prompt": "Tracking shot: a lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
"duration": 5,
"resolution": "1080p"
}
Importante: a resolução 1080p só aceita clipes de 5 segundos. Para um vídeo de 10 segundos, você precisa baixar a resolução para 768p ou 512p. O preço depende da resolução e da duração. Em outubro de 2026, 768p custa US$ 0,04 por segundo e 1080p custa US$ 0,08 por segundo; confira os valores atuais na página do modelo.
Ao enviar o pedido, a API retorna um task_id em data[0].task_id com status submitted. O tempo de renderização depende da resolução, da duração e da carga do momento, então continue consultando até a tarefa terminar.
Como usar o recurso de imagem-para-vídeo
Para pedidos de imagem-para-vídeo, inclua um parâmetro adicional: first_frame_image. Ele pode ser uma URL pública (por exemplo, https://example.com/start.jpg) ou uma string Data URL codificada em Base64. Verifique se a imagem atende aos requisitos de tipo de arquivo, tamanho e proporção.
Seu prompt deve descrever o movimento, e não os detalhes visuais da cena, já que a imagem fornece esse contexto. Por exemplo, se a imagem inicial mostra um produto sobre uma mesa, um prompt como "Slow zoom in. Product rotates gently, soft studio lighting, clean white background" diz ao modelo como animá-lo. A resolução de saída acompanha as dimensões da imagem de entrada, então usar uma fonte de alta qualidade é essencial para resultados nítidos.
Para efeitos mais avançados, você pode incluir um last_frame_image junto com o first_frame_image. Isso cria um vídeo de transição entre duas imagens, perfeito para revelações de produto, comparações de antes e depois ou transições de cena em projetos maiores.
Com o pedido configurado, acompanhe a resposta da API para obter seu vídeo animado. Para projetos que precisam de áudio integrado, considere a API do Veo 3.1, que gera som sincronizado.
Lendo as respostas da API e baixando os resultados
Consulte GET https://api.apimart.ai/v1/tasks/{task_id}. Quando o status da tarefa muda para completed, a URL do vídeo fica em data.result.videos[0].url[0]. Não há ID de arquivo separado nem endpoint de download. Veja o fluxo de status:
| Status | Significado | O que fazer |
|---|---|---|
submitted / pending | Tarefa recebida ou na fila | Aguardar e consultar novamente |
processing | Vídeo em renderização | Aguardar e consultar novamente |
completed | Geração concluída | Ler data.result.videos[0].url[0] e baixar |
failed | A geração falhou | Verificar o campo error e tentar de novo |
Consulte o endpoint /v1/tasks/{task_id} a cada 15–30 segundos até o status mudar para completed. Depois, baixe o vídeo pela URL retornada. Os resultados ficam guardados por 72 horas, então salve o arquivo no seu próprio armazenamento logo [1].
Se você usa Python, pode usar requests.get(video_url).content para baixar o vídeo e salvá-lo como arquivo .mp4, em que video_url é data["result"]["videos"][0]["url"][0] na resposta da tarefa.
Por fim, sempre verifique o campo code na resposta da API. O valor 200 indica que o pedido foi bem-sucedido, mas você ainda precisa acompanhar o status da tarefa para identificar possíveis erros de renderização [1].
Melhorando a qualidade do vídeo e integrando o fluxo de trabalho
Refinando prompts e parâmetros
Para melhorar a qualidade do vídeo, estruture os prompts neste formato: [Sujeito e ação], [elemento físico/ambiental], [movimento de câmera], [iluminação/atmosfera], [descritor de qualidade] [7]. Um exemplo: "Um barista despeja leite fumegante no espresso, o líquido girando em câmera lenta, zoom in lento, luz quente de cafeteria, qualidade cinematográfica." Essa abordagem ajuda o modelo a simular movimento e atmosfera realistas com mais eficácia.
Se você precisa de tags de câmera explícitas, o MiniMax Hailuo 2.3 API na APIMart suporta 15 comandos de câmera em chinês entre colchetes, colocados no início do prompt com os rótulos exatos [3]. Use a tabela abaixo como referência rápida:
| Categoria | Comandos |
|---|---|
| Horizontal | [左移] / [右移] pan para a esquerda / direita (deslocamento lateral), [左摇] / [右摇] rotação para a esquerda / direita |
| Vertical | [上升] / [下降] subir / descer, [上摇] / [下摇] tilt para cima / baixo |
| Profundidade | [推进] / [拉远] push in / pull out, [变焦推近] / [变焦拉远] zoom in / out |
| Especiais | [晃动] tremor, [跟随] acompanhar, [固定] fixo |
O recurso prompt_optimizer vem ativado por padrão e geralmente melhora a qualidade da saída. Mantenha-o ligado, a menos que você precise que o modelo siga um roteiro muito específico. Se a velocidade é prioridade e você aceita um acabamento um pouco menos refinado, defina fast_pretreatment: true para reduzir o tempo de pré-processamento [1][6].
Com prompts e configurações ajustados, integre tudo a um pipeline maior para elevar a qualidade da produção.
Construindo pipelines multimodelo com a APIMart
O Hailuo 02 funciona melhor combinado com ferramentas complementares para áudio e sequências longas. Ele se destaca na criação de B-roll visualmente dinâmico, como água, fogo ou tecido, mas não gera áudio. Para preencher essa lacuna, combine-o na pós-produção com as ferramentas do MiniMax Audio, como o Speech 2.8 para narrações ou o Music 2.6 para trilhas sonoras [8]. Para projetos de marca ou comerciais, comece gerando um frame base com um modelo de imagem e depois envie-o ao Hailuo 02 como first_frame_image para controlar a composição com precisão [7].
Para vídeos com mais de 10 segundos, faça uma captura do último frame de um clipe pronto e use-a como first_frame_image do próximo pedido. Essa técnica ajuda a manter a consistência dos detalhes dos personagens e da iluminação do ambiente entre vários clipes [8].
Tratamento de erros e boas práticas de API
Mesmo com prompts e pipelines bem ajustados, problemas podem surgir. Siga estas boas práticas para solucioná-los e otimizar as respostas da API.
As duas falhas mais comuns no Hailuo 02 envolvem combinações de resolução e duração não suportadas e imagens de entrada inválidas. Verifique sempre se as configurações de resolução e duração são compatíveis [1][6]. Para tarefas de imagem-para-vídeo, a documentação da própria MiniMax recomenda uma imagem de origem com menos de 20 MB, lado menor acima de 300 px e proporção entre 2:5 e 5:2, nos formatos JPG, PNG ou WebP [5].
| Tipo de erro | Detecção | Solução |
|---|---|---|
| Configuração não suportada | Pedido rejeitado ou tarefa que retorna failed | Verificar a compatibilidade entre resolução e duração [1] |
| Imagem inválida | Erro de API em first_frame_image | Verificar formato (JPG/PNG/WebP), tamanho e proporção [5] |
| Saldo insuficiente | HTTP 402 | Recarregar o saldo da APIMart [1] |
| Limite de taxa / timeout | HTTP 429 ou queda de conexão | Aplicar backoff e aumentar o intervalo de polling [4] |
Quando uma tarefa falhar, sempre verifique o campo error na resposta da tarefa. Ele traz detalhes que ajudam a resolver o problema rapidamente. Em produção, mantenha um intervalo de polling moderado e tente de novo com backoff exponencial; isso reduz chamadas desnecessárias à API e mantém seu fluxo de trabalho ágil.
Conclusão: principais pontos
Aqui vai um resumo rápido do que torna o MiniMax Hailuo 02 uma ferramenta de destaque para geração de vídeo.
O MiniMax Hailuo 02 oferece criação de vídeo com qualidade cinematográfica e precisão impressionante. Graças à arquitetura NCR, com 3 vezes mais parâmetros e 4 vezes mais dados de treino que os modelos anteriores [7], ele produz efeitos muito realistas para elementos complexos como água, fogo, fumaça e tecido.
Na APIMart, 768p custa US$ 0,04 e 1080p US$ 0,08 por segundo em outubro de 2026 [2], o que o torna uma escolha prática para tudo, da produção profissional à experimentação criativa.
Os recursos de destaque do modelo incluem:
- Ferramentas de imagem-para-vídeo para controle preciso.
- Direção de câmera no próprio prompt (por exemplo, "plano de acompanhamento", "zoom in lento") para uma cinematografia com cara profissional.
- Continuidade pelo último frame, garantindo transições suaves em sequências longas.
Lembre-se de que, na APIMart, clipes em 1080p são limitados a 5 segundos (o anúncio da MiniMax fala em 6 segundos). Para vídeos mais longos, 768p é uma ótima alternativa, com clipes de 10 segundos por um preço menor [1].
Com esses recursos, o MiniMax Hailuo 02 está pronto para levar seu fluxo de produção de vídeo a outro nível.
Perguntas frequentes
Como fazer clipes com mais de 10 segundos?
O MiniMax Hailuo 02 tem duração máxima de 10 segundos por clipe, e clipes de 10 segundos exigem 768p ou 512p (1080p só aceita 5 segundos). Para vídeos mais longos, gere vários clipes de 10 segundos e encadeie-os, usando o último frame de um clipe como first_frame_image do próximo.
Para um clipe de texto-para-vídeo de 10 segundos, inclua estes parâmetros no pedido:
duration: 10resolution: "768p"model: "MiniMax-Hailuo-02"
Depois de enviar o pedido, consulte a tarefa até ela ficar completed e baixe o vídeo em data.result.videos[0].url[0].
O que fazer se minha tarefa falhar?
Se a tarefa de geração de vídeo não der certo, comece analisando o status HTTP e o objeto error da resposta para identificar o problema. Estes são os casos mais comuns:
- 400: parâmetros inválidos, como uma combinação de resolução e duração não suportada.
- 401: problemas de autenticação com sua chave de API.
- 402: saldo insuficiente na conta.
- 429: você atingiu o limite de taxa.
Para erros de limite de taxa (HTTP 429) ou problemas no servidor (HTTP 5xx), use backoff exponencial, ou seja, aumente progressivamente o intervalo entre as tentativas. Confira também os parâmetros de entrada e garanta que seus prompts evitem conteúdo sensível para não gerar erros de validação.
Como manter os personagens consistentes entre clipes?
Para manter a consistência de personagens no MiniMax Hailuo 02, comece cada clipe com um first_frame_image nítido e bem iluminado do personagem e reutilize o último frame de um clipe como primeiro frame do seguinte. Se estiver trabalhando com vários clipes, inclua detalhes de iluminação iguais nos prompts. Para um fluxo visual mais suave, alinhe os ângulos de câmera entre os planos e considere transições sutis, como fusões ou match cuts, na pós-produção. Essas técnicas ajudam a criar uma narrativa coesa e bem-acabada.
Sobre a equipe APIMart
A equipe APIMart escreve guias de modelos, comparativos e análises de preço para desenvolvedores que constroem com IA. A APIMart oferece uma única API para modelos de chat, imagem e vídeo de vários provedores, para que você compare os modelos citados aqui antes de lançar.
Escolha o modelo que você quer no marketplace
Teste modelos de chat, imagem e vídeo no marketplace da APIMart e experimente rapidamente as capacidades dos modelos com uma API unificada.
