API MiniMax H3 para geração de vídeo
Acesse o MiniMax H3 pela GoEnhance Open API, uma plataforma independente. Envie texto, imagens de frame ou mídia de referência para um fluxo REST assíncrono, receba um img_uuid e depois consulte o resultado ou registre um callback. O H3 gera áudio estéreo nativo — diálogo, efeitos sonoros e som ambiente — na mesma passada em que gera a imagem.
Criar uma API Key
Escolha o modelo H3 conforme suas entradas
hailuo_h3: texto, primeiro frame ou primeiro e último frame
Use 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
Use 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
A GoEnhance Open API é uma plataforma independente de terceiros que oferece acesso unificado a modelos de vídeo e imagem. Ela não é a MiniMax nem a Hailuo, não tem vínculo com a MiniMax e não conta com o endosso dela. MiniMax e Hailuo são marcas de seu titular e aparecem aqui apenas para identificar o modelo.
Valide esses campos antes de enviar para que requisições inválidas sejam rejeitadas antes do desconto de tokens.
Parâmetros e limites da API MiniMax H3
Endpoint compartilhado e resposta assíncrona
Os dois modelos são enviados para <code>POST https://api.goenhance.ai/api/v1/videos/generations</code>. A resposta devolve um <code>img_uuid</code>; a geração continua de forma assíncrona.
Duração e prompt do hailuo_h3
<code>duration</code> 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. <code>prompt</code> é obrigatório e aceita até 7.000 caracteres.
Resolução e proporção do hailuo_h3
Escolha 480p, 720p ou 2K. Apenas em texto para vídeo, <code>ratio</code> aceita 21:9, 16:9, 4:3, 1:1, 3:4 ou 9:16. Quando <code>image_url</code> fornece um primeiro frame, a saída segue essa imagem e o parâmetro ratio não é usado.
Entradas de frame do hailuo_h3
Passe <code>image_url</code> como primeiro frame e, opcionalmente, <code>image_end_url</code> 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
Uma única requisição aceita até 9 imagens em <code>ref_imgs</code>, 3 vídeos em <code>ref_videos</code> e 3 áudios em <code>ref_audios</code>. A duração é um inteiro de 5 a 15 segundos, com padrão 5; a resolução é 768P ou 2K.
Áudio estéreo nativo
O H3 gera diálogo, efeitos sonoros e som ambiente como áudio estéreo nativo na mesma passada da imagem, em vez de dublar o áudio depois.
O custo por chamada é a tarifa por segundo do nível escolhido multiplicada pela duração de saída solicitada. Modelos de vídeo são cobrados por segundo de saída.
Preço por segundo do MiniMax H3
hailuo_h3 — 480p: $0.030 por segundo
Um nível do pipeline próprio da GoEnhance para iterar prompts com custo menor. Não é um nível de saída oficialmente suportado pela MiniMax.
hailuo_h3 — 720p: $0.060 por segundo
Um nível do pipeline próprio da GoEnhance para iterar mais barato antes de escolher as tomadas finais. Não é um nível de saída oficialmente suportado pela MiniMax.
hailuo_h3 — 2K: $0.090 por segundo
Use o nível 2K nas tomadas escolhidas que precisam da resolução de saída oficial da MiniMax.
hailuo_h3_refs — 768P: $0.099 por segundo
A geração guiada por referências passa pelo canal oficial da MiniMax e por isso usa níveis e preços diferentes.
hailuo_h3_refs — 2K: $0.143 por segundo
O nível 2K do canal oficial para requisições guiadas por referências.
Tokens, reembolsos e concorrência
O uso é cobrado em tokens: $10 compram 500 tokens, ou $0.02 por token. Os pontos são descontados uma única vez no envio e reembolsados integralmente se a geração falhar. A concorrência depende do Build Tier da conta e começa em 3 tarefas em andamento ao mesmo tempo. Veja <a href="/billing">os níveis de preço e créditos</a>.
Integre a API de vídeo MiniMax H3
1
1. Crie e proteja uma API key
Crie uma key em /keys. Envie-a como
Authorization: Bearer <API key> e não a exponha em código de navegador nem em logs. 2
2. Escolha o modelo e valide a requisição
Escolha
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
3. Envie e guarde o img_uuid
Faça POST da requisição para
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
4. Consulte ou receba callbacks
Consulte
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
5. Trate validação, falhas e concorrência
Não repita sem alterações uma duração inválida ou uma combinação de entradas incompatível. Gerações que falham são reembolsadas integralmente. Coloque novos envios em fila quando as tarefas em andamento atingirem a concorrência permitida pelo seu Build Tier.
Monte pipelines de mídia repetíveis em torno de tarefas assíncronas, áudio nativo e entradas explícitas de frame ou referência.
O que desenvolvedores constroem com o H3
Variações de anúncios programáticas
Gere lotes de conceitos curtos de campanha a partir de prompts estruturados e mantenha só os resultados aprovados.
Pipelines de clipes de produto
Use uma imagem de produto como primeiro frame e gere clipes curtos cuja proporção segue a imagem enviada.
Anúncios em vídeo localizados
Gere imagem, diálogo, efeitos sonoros e som ambiente em uma única passada e depois leve cada resultado para o seu fluxo de localização e revisão.
Sistemas de produção de UGC
Conecte envios, acompanhamento de tarefas, callbacks, moderação e armazenamento de assets em um pipeline automatizado de conteúdo curto.
Limites, escolha de modelo, cobrança, áudio e relação com a plataforma.