Casa Blog

Como Usar a API MiniMax H3

Capa do blog da API MiniMax H3

Aug 3, 2026

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 Área de reprodução, ler Documentação da API, ou comparar com outros modelos na Catálogo de modelos.

Divulgação: Este artigo foi escrito com assistência de IA e revisado por EmpirioLabs IA.

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.