APIMart
APIMart

Tutorial MiniMax Hailuo 2.3: Criação de Vídeo com IA

Guia passo a passo do MiniMax Hailuo 2.3 na APIMart: configure sua chave de API, execute fluxos de texto e imagem para vídeo e reduza custos com o modo Fast.

Tutorial

O MiniMax Hailuo 2.3 é uma ferramenta poderosa para criar vídeos com IA, com movimento realista e efeitos cinematográficos. Ele está disponível na APIMart pela MiniMax Hailuo 2.3 API, com dois fluxos de trabalho: texto-para-vídeo e imagem-para-vídeo a partir de um único primeiro frame. Isso o torna adequado para desenvolvedores, estúdios e educadores. Veja o que você precisa saber:

  • Recursos principais: gere vídeos em 768p ou 1080p, com 6 ou 10 segundos em 768p e 6 segundos em 1080p. Segundo a MiniMax, a versão 2.3 melhora os movimentos corporais e as microexpressões em relação às versões anteriores.
  • Preço: em outubro de 2026, os preços começam em US$ 0,0248 por segundo para o Fast em 768p. O Fast custa cerca da metade do modelo padrão em 768p e cerca de 40% menos em 1080p.
  • Configuração: cadastre-se na APIMart, gere uma chave de API e siga um processo simples de três etapas: enviar a tarefa, consultar o status e baixar o vídeo a partir do resultado da tarefa.
  • Dicas de otimização: use o Fast para rascunhos de imagem-para-vídeo, mude para o Standard quando precisar de texto-para-vídeo ou da renderização final e escreva prompts claros com o framework CCR (Camera, Character, Reaction).

Este guia simplifica o processo de criação de vídeo para garantir resultados de qualidade com custos sob controle.

Principais pontos

  • Na APIMart, o MiniMax Hailuo 2.3 gera clipes em 768p ou 1080p por dois fluxos: texto-para-vídeo e imagem-para-vídeo a partir de um único primeiro frame. Não há entrada de último frame nem de subject reference.
  • Todo fluxo segue o mesmo processo assíncrono de três etapas: enviar uma requisição POST para obter um task_id, consultar GET /v1/tasks/{task_id} a cada 10 segundos até o status ser completed e baixar o MP4 em data.result.videos[0].url[0]; os resultados ficam guardados por 72 horas.
  • Em outubro de 2026, o Hailuo 2.3 custa na APIMart de US$ 0,0248/s para o MiniMax-Hailuo-2.3-Fast em 768p a US$ 0,072/s para o modelo padrão em 1080p.
  • O parâmetro prompt_optimizer é true por padrão; defina como false para manter a redação exata e use os 15 comandos de câmera em chinês entre colchetes, como [推进] (push in), no início do prompt.
  • 768p aceita 6 ou 10 segundos, 1080p é limitado a 6 segundos, os prompts têm limite de 2.000 caracteres, e o modelo Fast exige first_frame_image, mantendo o prompt obrigatório.
  • O Fast custa cerca da metade do Standard em 768p e cerca de 40% menos em 1080p, então crie protótipos de imagem-para-vídeo no Fast em 768p e mude para as configurações necessárias nas renderizações finais.

Configurando o MiniMax Hailuo 2.3 na APIMart

APIMart

Criando e configurando uma conta na APIMart

Para começar, acesse apimart.ai e crie uma conta gratuita. Depois de entrar, vá até a seção "API Key Management" no painel. Gere uma nova chave de API e copie e salve-a imediatamente, pois ela só é exibida uma vez[5].

Em seguida, procure MiniMax-Hailuo-2.3 ou MiniMax-Hailuo-2.3-Fast no painel de modelos ou na documentação da API. Assim você confirma a disponibilidade e revisa os detalhes do endpoint antes de montar sua primeira requisição.

Com a conta pronta e a chave de API protegida, o próximo passo é preparar seu ambiente de desenvolvimento.

Pré-requisitos de desenvolvimento

A API da APIMart suporta várias linguagens, incluindo Python (via requests), JavaScript/TypeScript (via axios) e cURL. As requisições usam formato JSON e exigem um token Bearer para autenticação.

Para manter sua chave de API segura, guarde-a em uma variável de ambiente como os.environ["APIMART_API_KEY"] em vez de colocá-la diretamente nos scripts.

A geração de vídeo é um processo assíncrono. Funciona assim: você envia uma tarefa para POST https://api.apimart.ai/v1/videos/generations, recebe um task_id em data[0].task_id, consulta GET https://api.apimart.ai/v1/tasks/{task_id} e, quando o status for completed, baixa o vídeo em data.result.videos[0].url[0]. A APIMart não divulga um tempo fixo de renderização; ele depende da resolução, da duração e da carga do momento[3].

Com o ambiente configurado e o fluxo bem entendido, você pode se concentrar em gerenciar o orçamento e otimizar o uso.

Acompanhando o orçamento e definindo limites de uso

Estes são os preços por segundo da APIMart para cada variante em outubro de 2026[6]; confira os preços atuais na página do modelo.

VarianteResoluçãoPreço na APIMart
MiniMax-Hailuo-2.3768pUS$ 0,0488/s
MiniMax-Hailuo-2.31080pUS$ 0,072/s
MiniMax-Hailuo-2.3-Fast768pUS$ 0,0248/s
MiniMax-Hailuo-2.3-Fast1080pUS$ 0,0424/s

Por exemplo, gerar um clipe de 6 segundos em 768p com o modelo padrão custa cerca de US$ 0,29, enquanto a variante Fast reduz para cerca de US$ 0,15, mais ou menos a metade. Em 1080p, um clipe de 6 segundos custa cerca de US$ 0,43 no Standard e US$ 0,25 no Fast, cerca de 40% menos. Uma abordagem prática é criar protótipos de imagem-para-vídeo com MiniMax-Hailuo-2.3-Fast em 768p e depois passar para a resolução e o modelo necessários nas renderizações finais. Confira os preços atuais na página do modelo.

O painel Billing da APIMart permite acompanhar os gastos em tempo real, o que ajuda bastante em trabalhos em lote, já que os custos são calculados por segundo de vídeo gerado.

Fluxos principais de geração de vídeo

Fluxo de texto-para-vídeo

Criar vídeos a partir de texto segue um processo simples de três etapas: enviar, consultar e baixar.

  • Criar a tarefa: envie uma requisição POST para https://api.apimart.ai/v1/videos/generations com model, prompt, duration e resolution. O texto-para-vídeo usa o modelo padrão MiniMax-Hailuo-2.3, porque o Fast exige um primeiro frame. Em troca, você recebe um task_id em data[0].task_id.
  • Consultar o status: use o task_id para consultar GET /v1/tasks/{task_id} a cada 10 segundos. Enquanto a tarefa está em andamento, o status é pending ou processing. Quando termina, muda para completed.
  • Baixar o vídeo: leia a URL do vídeo em data.result.videos[0].url[0] e salve o MP4 no seu próprio armazenamento. Os resultados ficam guardados por 72 horas.

Um parâmetro importante aqui é o prompt_optimizer. Por padrão ele é true, o que significa que o modelo vai refinar seu prompt para melhorar a qualidade visual do vídeo. Mas, se você precisa de controle exato, por exemplo em conteúdo de marca em que a redação precisa ser seguida à risca, pode defini-lo como false [3].

Para movimentos de câmera, o Hailuo 2.3 na APIMart suporta 15 comandos em chinês entre colchetes, colocados no início do prompt com os rótulos exatos: [左移] / [右移] (pan para a esquerda / direita, deslocamento lateral), [左摇] / [右摇] (rotação para a esquerda / direita), [推进] / [拉远] (push in / pull out), [上升] / [下降] (subir / descer), [上摇] / [下摇] (tilt para cima / baixo), [变焦推近] / [变焦拉远] (zoom in / out), além de [晃动] (tremor), [跟随] (acompanhar) e [固定] (fixo) [3].

A partir dessa abordagem baseada em texto, o fluxo de imagem-para-vídeo oferece ainda mais controle, ancorando o vídeo em uma imagem inicial específica.

Fluxo de imagem-para-vídeo

O imagem-para-vídeo usa o parâmetro first_frame_image, que aceita uma URL pública ou uma data URI em Base64. Ele funciona com MiniMax-Hailuo-2.3 e MiniMax-Hailuo-2.3-Fast; no Fast, first_frame_image é obrigatório e o prompt continua obrigatório. A documentação da própria MiniMax recomenda arquivos JPG, JPEG, PNG ou WebP com menos de 20 MB, lado menor de pelo menos 300 px e proporção entre 2:5 e 5:2 [2].

Esse fluxo segue a mesma estrutura de três etapas do texto-para-vídeo. A diferença é que a imagem fornecida define o frame inicial, enquanto o prompt de texto determina como a cena evolui. Isso é ideal para marketing ou educação, quando você quer que uma imagem de produto ou um diagrama se transforme em uma sequência animada.

Um truque útil para vídeos mais longos é capturar o último frame de um clipe pronto e usá-lo como first_frame_image da próxima tarefa. Isso ajuda a manter a consistência de personagens e cenário entre vários clipes sem ajustes adicionais [9].

O que o Hailuo 2.3 não suporta na APIMart

O Hailuo 2.3 na APIMart aceita apenas uma entrada de imagem: first_frame_image. Não há last_frame_image nem entrada de subject reference, então transições de primeiro para último frame e fluxos com referência de rosto não estão disponíveis neste modelo [3].

Se você precisar disso, veja outros modelos da MiniMax na APIMart: o MiniMax Hailuo 02 API suporta transições de primeiro para último frame, e o MiniMax H3 API suporta entrada de primeiro/último frame, além de imagens, vídeo e áudio de referência multimodais.

Os dois fluxos do Hailuo 2.3, texto-para-vídeo e imagem-para-vídeo, compartilham o mesmo processo assíncrono de três etapas e a mesma sintaxe de comandos de câmera. Para alternar entre eles, basta adicionar ou remover first_frame_image na requisição POST.

Masterclass de Vídeo com Hailuo AI: Do Iniciante ao Profissional (Guia Completo 2.3)

Melhorando a qualidade do vídeo e reduzindo custos

APIMart
Comparação de Preços e Configuração de Vídeo do MiniMax Hailuo 2.3

Escrevendo prompts eficazes

Um prompt claro e preciso é essencial para gerar vídeos de qualidade. Um método útil para estruturar seus prompts é o framework Camera, Character, Reaction (CCR). Ele divide a cena em três partes: o que a câmera está fazendo, quem está no plano e qual ação acontece. Por exemplo: "[跟随] Camera: plano de acompanhamento lento; Character: um quarterback de camisa azul; Reaction: lançando um passe longo em um jogo noturno com neve em Chicago, as luzes do estádio criando um brilho enevoado."

Adicionar detalhes específicos sobre estilo visual e foco faz muita diferença. Termos como "fotorrealista", "iluminação cinematográfica" ou "estilo anime" guiam o modelo para o visual desejado. Incluir detalhes sutis do personagem, como "uma leve erguida de sobrancelha" ou "um olhar pensativo", permite aproveitar as melhorias em microexpressões que a MiniMax destaca no Hailuo 2.3 [4]. Evite, porém, colocar ações demais em um único prompt, o que pode gerar movimentos estranhos ou com falhas. Com um limite de 2.000 caracteres, procure prompts detalhados, mas enxutos, claros e com propósito [3][7].

Escolhendo a duração e a resolução certas

Ao definir resolução e duração, vale pesar as opções. O Hailuo 2.3 oferece duas resoluções: 768p e 1080p. A principal diferença? Clipes em 1080p são limitados a 6 segundos, enquanto 768p suporta 6 e 10 segundos [3].

ConfiguraçãoModeloDuraçãoResoluçãoCusto (USD, out. de 2026)
Fast (rascunho, exige primeiro frame)MiniMax-Hailuo-2.3-Fast6 s768p~US$ 0,15
Standard (teste)MiniMax-Hailuo-2.36 s768p~US$ 0,29
Standard (longo)MiniMax-Hailuo-2.310 s768p~US$ 0,49
Standard (final)MiniMax-Hailuo-2.36 s1080p~US$ 0,43

Para os primeiros rascunhos, clipes de 6 segundos em 768p são uma escolha prática. São baratos e permitem avaliar movimento e composição sem comprometer muitos recursos. Depois de reduzir as opções, mude para configurações de resolução mais alta no produto final.

Usando um fluxo de trabalho iterativo

Um fluxo iterativo é a chave para equilibrar qualidade e custo. Para imagem-para-vídeo, um processo em duas etapas funciona bem: explore com o modelo Fast e depois refaça a melhor versão com as configurações necessárias para a entrega.

"Gere de 3 a 5 variações do mesmo prompt com o Hailuo 2.3 Fast na fase de conceito. Escolha a melhor e rode exatamente esse prompt de novo no 2.3 Standard ou no 02 em 1080p para a saída final. Você vai gastar menos créditos com experimentos fracassados." - QWE AI Academy [8]

Na APIMart, um clipe de 6 segundos em 768p custa cerca de US$ 0,15 no Fast contra cerca de US$ 0,29 no Standard; ou seja, o Fast custa mais ou menos a metade em 768p e cerca de 40% menos em 1080p. A MiniMax descreve o Fast como mais rápido e econômico para criação em lote [4]. Testando vários rascunhos no Fast, você encontra a versão mais promissora antes de gastar mais na renderização final. Compare os resultados com seus próprios prompts antes de escolher um nível para a entrega.

Integrando vídeos do MiniMax Hailuo 2.3 na produção

APIMart

Gerenciando tarefas assíncronas e arquivos de saída

Gerar vídeo com o Hailuo 2.3 envolve um processo assíncrono de três etapas: primeiro, enviar uma requisição e receber um task_id; depois, consultar GET /v1/tasks/{task_id} até o status ser completed; por fim, ler a URL do vídeo em data.result.videos[0].url[0] e baixá-lo.

Se for usar polling, mantenha um intervalo de 10 segundos para não atingir limites de taxa. Em lotes maiores, coloque os task IDs pendentes em uma fila e consulte-os em um cronograma comum, em vez de abrir um loop intenso para cada tarefa.

Fique de olho no campo status para identificar erros. Se ele mostrar failed, pegue imediatamente o campo error para diagnóstico ou registro. Baixe os arquivos assim que estiverem prontos; os resultados ficam guardados por 72 horas. Para acompanhar as tarefas entre respostas assíncronas, salve cada task_id junto com o seu ID interno de produção, para conseguir associar os resultados às requisições.

Com um sistema eficiente de gestão de tarefas, fica mais fácil controlar custos e escalar a operação.

Orçamento e escala de uso

O Hailuo 2.3 é cobrado por segundo de vídeo gerado, então o cálculo de custos é direto. Por exemplo, em outubro de 2026, 2.400 segundos de saída Fast em 768p (US$ 0,0248/s) custam cerca de US$ 59,52, enquanto o mesmo volume no modelo padrão em 768p custa cerca de US$ 117,12.

Para manter os custos sob controle, use o Fast nas primeiras renderizações de imagem-para-vídeo. Em outubro de 2026 na APIMart, o Fast custa cerca da metade do Standard em 768p e cerca de 40% menos em 1080p. A resposta da consulta da tarefa também inclui um campo cost, então você pode registrar o custo real de cada tarefa sem esperar a fatura mensal.

"O modelo Hailuo 2.3 Fast... gera vídeos mais rápido e por um preço menor, reduzindo em até 50% os custos de criação em lote." - MiniMax News [4]

Ao escalar a produção, escolha a forma de consulta que combina com o seu volume:

RecursoLoop de polling simplesPolling com fila
EndpointGET /v1/tasks/{task_id}GET /v1/tasks/{task_id}
ComplexidadeSimples de configurarExige fila de tarefas e worker
EscalabilidadeUm loop por tarefaUm worker verifica muitas tarefas pendentes
Melhor paraTarefas pequenas ou pontuaisProdução em lote

Se você lida com muitas tarefas simultâneas, um worker baseado em fila é a melhor opção. Um loop de polling simples resolve bem tarefas pequenas ou pontuais.

Conclusão

O MiniMax Hailuo 2.3, disponível na APIMart a partir de US$ 0,0248 por segundo (Fast em 768p, em outubro de 2026), coloca a produção profissional de vídeo com IA ao alcance por uma fração do custo. Por exemplo, um clipe de 6 segundos em 768p custa cerca de US$ 0,15 no Fast e cerca de US$ 0,29 no Standard.

Para começar, configure sua conta na APIMart e escolha o fluxo que combina com seus objetivos criativos: texto-para-vídeo no Standard, ou imagem-para-vídeo no Standard ou no Fast. Refine os resultados com o método CCR (Camera, Character, Reaction)[11]. Em projetos mais longos, mantenha a consistência visual capturando o último frame de cada clipe e usando-o como frame inicial do próximo segmento[9].

O modelo Fast traz uma economia clara: cerca da metade do preço do Standard em 768p e cerca de 40% menos em 1080p. Use-o para rascunhos e lotes, e escolha o modelo e a resolução das renderizações finais depois de comparar os resultados com seus próprios prompts[4].

Essa eficiência de custo não passou despercebida:

"O Hailuo 2.3 mais uma vez estabelece um recorde mundial de custo-benefício para modelos de vídeo... oferecendo 'mais pelo mesmo preço' a empresas e usuários finais." - MiniMax Official News[4]

Para equipes que gerenciam produção de vídeo em grande escala, as estratégias de integração acima são muito valiosas. Polling com fila, o campo cost por tarefa e modelos de prompt facilitam manter um pipeline de produção escalável, com vários clipes por semana.

Perguntas frequentes

Qual a melhor forma de manter personagens consistentes em vários clipes?

O Hailuo 2.3 na APIMart não tem entrada de subject reference, então a consistência vem dos primeiros frames e dos prompts. Comece cada clipe com um first_frame_image de iluminação e ângulos uniformes e reutilize o último frame de um clipe como primeiro frame do seguinte. Seja preciso nos prompts, descrevendo claramente sujeito, ação e estilo. Comece com clipes curtos de seis segundos para testar a consistência antes de partir para vídeos mais longos ou de resolução mais alta.

Como verificar o status de muitos trabalhos de vídeo de uma vez?

Com poucas tarefas, consulte cada uma com GET /v1/tasks/{task_id} a cada 10 segundos, mais ou menos.

Em lotes maiores, coloque os IDs pendentes em uma fila e deixe um worker consultá-los em um cronograma comum, aplicando backoff quando aparecer um HTTP 429. Assim o número de requisições fica previsível e você não estoura os limites de taxa.

Por que eu desativaria o prompt_optimizer?

Quando você quer controle preciso sobre a geração de vídeo, defina o parâmetro prompt_optimizer como false. Assim o sistema deixa de ajustar seus prompts automaticamente, e sua redação e especificações exatas guiam diretamente a saída do modelo.

Tags#MiniMax Hailuo 2.3#vídeo com IA#tutorial#texto-para-vídeo

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.

Pronto para testar?

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.

Modelos de chatModelos de imagemModelos de vídeo
Explorar marketplace