API MiniMax H3 para geração de vídeo

Escolha o modelo H3 conforme suas entradas
hailuo_h3: texto, primeiro frame ou primeiro e último frame
hailuo_h3 para texto para vídeo, imagem para vídeo com image_url ou controle de primeiro e último frame com o opcional image_end_url. O prompt é obrigatório e aceita até 7.000 caracteres. Veja o playground e a referência completa de parâmetros.
hailuo_h3_refs: geração guiada por referências
hailuo_h3_refs quando uma única requisição precisar de até 9 imagens, 3 vídeos e 3 áudios de referência. Essa rota passa pelo canal oficial da MiniMax e oferece saída em 768P e 2K. Veja o endpoint de referência para vídeo.
Acesso unificado e independente por API

Parâmetros e limites da API MiniMax H3
Endpoint compartilhado e resposta assíncrona
POST https://api.goenhance.ai/api/v1/videos/generations. A resposta devolve um img_uuid; a geração continua de forma assíncrona.Duração e prompt do hailuo_h3
duration precisa ser um inteiro de 5 a 15 segundos, com padrão 5. Valores não inteiros ou fora da faixa são rejeitados antes do desconto de tokens. prompt é obrigatório e aceita até 7.000 caracteres.Resolução e proporção do hailuo_h3
ratio aceita 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Quando image_url fornece um primeiro frame, a saída segue essa imagem e o parâmetro ratio não é usado.Entradas de frame do hailuo_h3
image_url como primeiro frame e, opcionalmente, image_end_url como último. Esse único ID de modelo cobre texto para vídeo, imagem para vídeo e geração com primeiro e último frame.Entradas de referência do hailuo_h3_refs
ref_imgs, 3 vídeos em ref_videos e 3 áudios em ref_audios. A duração é um inteiro de 5 a 15 segundos, com padrão 5; a resolução é 768P ou 2K.Áudio estéreo nativo
Preço por segundo do MiniMax H3
hailuo_h3 — 480p: $0.030 por segundo
hailuo_h3 — 720p: $0.060 por segundo
hailuo_h3 — 2K: $0.090 por segundo
hailuo_h3_refs — 768P: $0.099 por segundo
hailuo_h3_refs — 2K: $0.143 por segundo
Tokens, reembolsos e concorrência
Integre a API de vídeo MiniMax H3
1. Crie e proteja uma API key
Authorization: Bearer <API key> e não a exponha em código de navegador nem em logs.2. Escolha o modelo e valide a requisição
hailuo_h3 para texto ou controle de frames, ou hailuo_h3_refs para mídia de referência. Antes de enviar, valide duração, resolução, se ratio se aplica, tamanho do prompt e a quantidade de entradas.3. Envie e guarde o img_uuid
https://api.goenhance.ai/api/v1/videos/generations. Guarde o img_uuid retornado no seu próprio registro de tarefa, porque o processamento é assíncrono.4. Consulte ou receba callbacks
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... ou registre uma URL de callback. Quando a tarefa começa a rodar, dispara um callback com status=0; o callback final traz o resultado.5. Trate validação, falhas e concorrência
O que desenvolvedores constroem com o H3
Variações de anúncios programáticas
Pipelines de clipes de produto
Anúncios em vídeo localizados
Sistemas de produção de UGC
Perguntas frequentes sobre a API MiniMax H3
Que duração a API MiniMax H3 aceita?
Tanto hailuo_h3 quanto hailuo_h3_refs aceitam qualquer inteiro de 5 a 15 segundos, com padrão 5. Valores não inteiros ou fora da faixa são rejeitados antes do desconto de tokens.
Por que existem dois IDs de modelo do H3?
A MiniMax trata o controle de frames e a mídia de referência como mutuamente exclusivos. Por isso a GoEnhance expõe hailuo_h3 para fluxos de primeiro e último frame e hailuo_h3_refs para geração guiada por referências, em vez de combinar parâmetros que entram em conflito em tempo de execução.
480p e 720p são níveis de saída oficiais da MiniMax?
Não. Oficialmente a MiniMax entrega apenas 2K. Os níveis 480p e 720p do hailuo_h3 rodam no pipeline próprio da GoEnhance. Eles permitem iterar mais barato e usar 2K só nas tomadas que você mantém.
Por que o hailuo_h3_refs custa mais?
O hailuo_h3_refs passa apenas pelo canal oficial da MiniMax. As resoluções disponíveis são 768P e 2K, com tarifas por segundo de $0.099 e $0.143, respectivamente.
Como funciona a cobrança?
A cobrança é baseada em tokens: $10 compram 500 tokens, ou $0.02 por token. Vídeo é cobrado por segundo na tarifa indicada. Os pontos são descontados uma única vez no envio da tarefa e reembolsados integralmente se a geração falhar.
O MiniMax H3 gera áudio?
Sim. O H3 gera diálogo, efeitos sonoros e som ambiente em estéreo nativo na mesma passada do vídeo, em vez de acrescentar dublagem depois.
Como saber quando o vídeo está pronto?
Guarde o img_uuid retornado e consulte o endpoint de detalhes da tarefa, ou registre uma URL de callback. O callback de início usa status=0; o callback final traz o resultado.
A GoEnhance Open API tem vínculo com a MiniMax ou a Hailuo?
Não. A GoEnhance Open API é uma plataforma de API independente, de terceiros. Ela não é a MiniMax nem a Hailuo, não tem vínculo com a MiniMax e não conta com o endosso dela. Os nomes identificam o modelo e pertencem ao seu titular.
Onde fica o editor MiniMax H3 sem código?
Esta página trata da integração via API REST. Se você procura um editor voltado ao usuário final, acesse a página do modelo de vídeo MiniMax H3.
