

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.
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

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.
| Variante | Resolução | Preço na APIMart |
|---|---|---|
| MiniMax-Hailuo-2.3 | 768p | US$ 0,0488/s |
| MiniMax-Hailuo-2.3 | 1080p | US$ 0,072/s |
| MiniMax-Hailuo-2.3-Fast | 768p | US$ 0,0248/s |
| MiniMax-Hailuo-2.3-Fast | 1080p | US$ 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/generationscommodel,prompt,durationeresolution. O texto-para-vídeo usa o modelo padrãoMiniMax-Hailuo-2.3, porque o Fast exige um primeiro frame. Em troca, você recebe umtask_idemdata[0].task_id. - Consultar o status: use o
task_idpara consultarGET /v1/tasks/{task_id}a cada 10 segundos. Enquanto a tarefa está em andamento, o status épendingouprocessing. Quando termina, muda paracompleted. - 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

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ção | Modelo | Duração | Resolução | Custo (USD, out. de 2026) |
|---|---|---|---|---|
| Fast (rascunho, exige primeiro frame) | MiniMax-Hailuo-2.3-Fast | 6 s | 768p | ~US$ 0,15 |
| Standard (teste) | MiniMax-Hailuo-2.3 | 6 s | 768p | ~US$ 0,29 |
| Standard (longo) | MiniMax-Hailuo-2.3 | 10 s | 768p | ~US$ 0,49 |
| Standard (final) | MiniMax-Hailuo-2.3 | 6 s | 1080p | ~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

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:
| Recurso | Loop de polling simples | Polling com fila |
|---|---|---|
| Endpoint | GET /v1/tasks/{task_id} | GET /v1/tasks/{task_id} |
| Complexidade | Simples de configurar | Exige fila de tarefas e worker |
| Escalabilidade | Um loop por tarefa | Um worker verifica muitas tarefas pendentes |
| Melhor para | Tarefas pequenas ou pontuais | Produçã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.
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.
