Início Blog

Como Usar a API MiniMax H3

Capa do blog da API MiniMax H3

Aug 3, 2026

EmpirioLabs AI

Divulgação: Este artigo foi escrito com auxílio de IA e revisado pela EmpirioLabs AI.

O MiniMax H3 está disponível na EmpirioLabs. É um modelo de vídeo multimodal que recebe texto, imagens, vídeo e áudio em uma única solicitação e retorna um clipe de 4 a 15 segundos a 24 fps em 768p ou 2K, cada um com uma faixa de áudio estéreo nativa.

Quatro maneiras de dirigir

H3 é um modelo com um Modo que é detectado automaticamente pelo que você anexar, então a maioria das requisições não precisa configurá-lo.

  • Texto para vídeo: um prompt por si só.
  • Imagem para vídeo: uma imagem se torna o quadro de abertura.
  • Primeiro e último quadro: fornece uma imagem de abertura e uma de fechamento e o modelo transita entre elas.
  • Referência ao vídeo: até 9 imagens, 3 vídeos e 3 clipes de áudio, totalizando 12 arquivos de referência, para transportar um sujeito ou estilo ao longo da cena.

Os prompts podem ter até 7000 caracteres e descrever ação, trabalho de câmera, diálogos, efeitos sonoros e texto na tela. A proporção de aspecto pode ser definida explicitamente ou deixada adaptativa para seguir seu meio de entrada.

Como chamar o MiniMax H3

A geração de vídeo é assíncrona. Envie a vaga e depois faça uma pesquisa:

curl https://api.empiriolabs.ai/v1/videos/generations \ -H 'Autorização: Portador $EMPIRIOLABS_API_KEY' \ -H 'Tipo-de-Conteúdo: application/json' \ -d '{ "modelo": "minimax-h3", "prompt": "Uma lanterna flutua sobre um porto tranquilo ao anoitecer, avanço lento, gaivotas chamando à distância.", "duração": 6, "resolução": "768p", "aspect_ratio": "16:9" }'

A resposta devolve uma job id e a poll url. Enquete VÁ /v1/jobs/{job_id} até que o status seja completo, e o clipe finalizado chega como uma URL de entrega em data[0].url.

Para animar uma imagem existente, adicione imagem. Para fazer a transição entre dois quadros, adicione last_frame também. Para transportar um sujeito por uma cena, envie várias imagens por baixo Imagens.

Preços

O H3 é cobrado por segundo de vídeo na resolução que você solicitar, com 2K com preço acima de 768p. Dois detalhes valem a pena saber antes de montar:

  • Uma referência Vídeo é anunciado por sua própria duração além do clipe que você gera, então uma referência de 5 segundos usada para fazer um clipe de 6 segundos cobra 11 segundos.
  • As 5 primeiras referências Imagens são incluídas, e cada imagem de referência adicional é cobrada separadamente.

Assista ao vivo página do modelo e página de preços Para as taxas atuais.

Comece a construir

Experimente o MiniMax H3 no Playground, ler Documentação da API, ou comparar com outros modelos na Catálogo de modelos.

Pronto para usar endpoints melhores?

Explore nossos modelos ou entre em contato conosco para consultas de negócios, implantações personalizadas ou qualquer outra coisa.