Como usar o MiniMax H3: cinco caminhos para o mesmo modelo

Não existe um app único do MiniMax H3. É um modelo atrás de cinco portas — este navegador, os apps da própria MiniMax, a API oficial, um revendedor, ou os pesos na sua própria GPU — então como você usa ele depende inteiramente de por qual delas você entra.

As cinco rodam os mesmos pesos e devolvem um MP4 de 4 a 15 segundos a 24 fps, em 768P ou 2K, com som junto da imagem. O que muda é o tempo de preparo, quem paga, e se você está licenciado ou não: os caminhos hospedados estão abertos no mundo inteiro, enquanto rodar os pesos por conta própria não é licenciado nos EUA, na UE, no Reino Unido nem na Coreia do Sul.

Cinco jeitos de começar, ordenados pelo tempo de preparo

Ordenados pelo trabalho exigido antes do seu primeiro clipe, não pela linha que a gente preferiria.

A última coluna é a que mais importa. A licença comunitária da MiniMax põe os EUA, a UE, o Reino Unido e a Coreia do Sul fora do Applicable Territory dela, e a exclusão acompanha as saídas também. Os caminhos hospedados ficam intocados. Então de Londres ou de São Francisco, as linhas um a quatro são suas e a cinco não é — o que já é boa parte da resposta para como usar o MiniMax H3. Um resumo, não aconselhamento jurídico.

Caminho um: num navegador, em cerca de 90 segundos

Escreva uma tomada, aperte gerar. Sem conta, sem e-mail, sem cartão — uma checagem de robô, e depois um clipe em 768P que você pode baixar e guardar, sem marca d'água.

O seu texto não vai direto para os pesos crus. Ele passa pelo pipeline hospedado da MiniMax, que roda os estágios de compreensão do prompt e de 2K que o download não inclui. Texto para vídeo e imagem para vídeo expõem cada parâmetro.

Caminho dois: os apps da própria MiniMax

Qual par você recebe depende de onde você está. No mundo, o Hailuo AI em hailuoai.video e um cliente de desktop em hub.minimax.io; na China continental, hailuoai.com e hub.minimaxi.com. Os dois querem uma conta e cobram nos créditos da própria MiniMax.

Uma armadilha de nome espera ali. Hailuo 3 é este modelo — o próprio título da OpenAPI da MiniMax diz Hailuo-03. Hailuo AI sem número é o app, e Hailuo 2.3 é a geração anterior.

Caminho três: a API oficial

Pegue uma chave em platform.minimax.io, ou em platform.minimaxi.com para uma conta da China, e aponte para a base URL correspondente. O ID do modelo é MiniMax-H3, sensível a maiúsculas. O console monta a chamada; o resto é o que nenhum trecho de código ensina.

Nada aqui é síncrono

A chamada de criação devolve um task_id, não um vídeo. Consulte GET /v2/query/video_generation/{task_id} até o status dizer succeeded, e então leia o arquivo em content.url. Para pular a consulta, use callback_url: a MiniMax manda primeiro uma requisição de verificação com um campo challenge que você tem de devolver em até três segundos.

Dois relógios começam no instante em que dá certo

Dois relógios separados, e quase todo mundo funde os dois. A URL de saída tem prazo, então baixe e re-hospede assim que terminar; a MiniMax não publica nenhum número para isso, e as 24 horas que circulam por aí são de um revendedor. A tarefa continua consultável por sete dias, e depois disso o mesmo task_id devolve invalid.

Cinco coisas que quebram a primeira chamada

A que pega quase todo mundo é ratio — obrigatório em texto para vídeo, e rejeitado se você puser adaptive. Um array de conteúdo sem nenhum item de texto não vazio devolve o erro 2013.

A que custa dinheiro é a última: um pedido com referência e nada anexado não falha. Ele vira um trabalho de texto para vídeo, devolve 200 OK e te cobra.

Caminho quatro: revendedores, com outro vocabulário

Várias plataformas hospedam o H3 atrás dos próprios schemas, com nomes de campo e limites próprios. Código tirado da documentação de um revendedor não roda contra api.minimax.io: quality aqui é resolution, aspect_ratio é ratio, e o ID do modelo não tem hífen. Alguns aceitam só 2K, que é de onde vem aquela afirmação; a API da própria MiniMax aceita os dois.

Context-IR e Regenerate-2K não estão no download

O H3 roda em três estágios e só o do meio é aberto.

• H3-Context-IR reescreve o seu prompt e o seu material de referência numa descrição de tomada estruturada.
• H3-Base gera a imagem em 768P e o áudio dela numa passagem só.
• H3-Regenerate-2K devolve esse resultado ao modelo junto do contexto original, que é por que o texto pequeno sobrevive em vez de ser adivinhado.

Os pesos no Hugging Face são o H3-Base. Os outros dois ficaram hospedados. É por isso que um render local parece mais chapado que o vídeo de lançamento com os seus ajustes perfeitamente certos — você está rodando um estágio de três.

Chame a API hospedada e os três rodam por você. Menos conhecido: os dois estágios fechados podem ser chamados sozinhos. O próprio model card da MiniMax documenta um híbrido — H3-Base na sua instalação de SGLang mais as APIs oficiais de Context-IR e Regenerate-2K — como o jeito de reproduzir o 2K que a API hospedada te dá direto. Rodar por conta própria não é tudo ou nada.

Caminho cinco: a sua própria GPU, e a quem ele serve

Vale a pena se você tem o hardware, a paciência para o preparo e uma licença que te cubra — a tabela acima lista os territórios que ela exclui. A concessão alcança as saídas também: renderize num país permitido, publique num excluído, e você continua fora dela. A MiniMax aceita pedidos em platform.minimax.io/h3-license. A licença, cláusula por cláusula tem o resto. Um resumo, não aconselhamento jurídico.

Se você está tranquilo: o pacote compacto do ComfyUI tem 42,47 GB, não os 498 GB do repositório completo, e o ComfyUI v0.30.0 ou mais recente lê ele sem nós customizados. Rodando no ComfyUI tem o layout dos arquivos; quando uma GPU se paga tem a aritmética.

Dois casos em que você não deveria usar este site. Volume, ou o H3 dentro do seu próprio produto: isso é a API — aqui é uma ferramenta de navegador, não um endpoint que você possa chamar. Arquivos de que você vai precisar mês que vem: guarde as suas próprias cópias; não somos um arquivo.

As perguntas que as pessoas fazem primeiro

Existe um jeito grátis de usar o MiniMax H3? Existe, e você está a um clique dele. O caminho um dá um clipe de cinco segundos em 768P sem conta e sem cartão, atrás de uma checagem de robô. Entrar na conta acrescenta créditos. Grátis não é ilimitado em lugar nenhum: todo segundo de saída é tempo real de GPU, e alguém está sendo medido por ele.

O que é o MiniMax H3? O sistema de geração omnimodal da MiniMax. Ele lê texto, imagem, vídeo e áudio como um contexto só e devolve de 4 a 15 segundos de vídeo a 24 fps em 768P ou 2K, com áudio estéreo de 32 kHz na mesma passagem.

Quando ele foi lançado? Anunciado em 31 de julho de 2026; pesos abertos publicados de 2 a 3 de agosto de 2026. A licença comunitária está datada de 2 de agosto.

MiniMax H3 é a mesma coisa que Hailuo? Em parte. Hailuo 3 é o mesmo modelo. Hailuo AI sem número é o app de consumo, e Hailuo 2.3 é o modelo anterior.

Qual é o ID do modelo na API? MiniMax-H3, sensível a maiúsculas. IDs em minúsculas com hífen são de revendedores, não desta API.

Por que a minha chamada de texto para vídeo está falhando? Na maioria das vezes é ratio, que texto para vídeo exige e que rejeita adaptive. Em seguida vem um array de conteúdo sem nenhum item de texto não vazio, que devolve o erro 2013.

Quanto custa? Aqui, 4 créditos por segundo de saída em 768P e 8 em 2K, mais 2 fixos pelo clipe em si. Essa tarifa é a mesma em todo plano — um plano maior compra volume, concorrência e posição na fila, nunca um segundo mais barato. 21:9 tem faixa própria, a 6 e 12. Vídeo de referência é cobrado pela duração dele por cima; as cinco primeiras imagens de referência e todo o áudio de referência são grátis, e cada imagem depois da quinta são 2. Um segundo em 768P é metade de um em 2K, então rascunho é lá que se faz. A tabela está em preços.