Introdução
A API de imagem para vídeo do MiniMax H3 Lite transforma uma imagem estática em um clipe com som de 4 a 15 segundos em 480p ou 768p. Envie um quadro inicial e, se quiser, um final, e teste o movimento em 480p antes de pagar por um render mais nítido. Seu design leve é adequado para testar ideias e produzir várias versões. Cada solicitação gera um único MP4 em que imagem e som saem juntos.
Escolha um modo pelo material de partida
| Seu ponto de partida | Modo a abrir |
|---|---|
| apenas uma ideia | MiniMax H3 Lite Texto para vídeo |
| um quadro para animar, com um quadro final opcional | MiniMax H3 Lite Imagem para vídeo |
| pessoas, figurinos, lugares, clipes de movimento ou vozes | MiniMax H3 Lite Referência para vídeo |
Recursos e destaques
O quadro define o visual
O quadro inicial fixa rostos, roupas, iluminação e composição, então o MiniMax H3 Lite gasta o prompt com o que se move. O clipe segue a forma do seu quadro e não existe campo de proporção, então recorte a imagem em horizontal ou vertical antes de enviá-la.
Quadro final opcional
Envie uma segunda imagem como last_image_url e o clipe termina nela, o que transforma duas fotos em uma transição controlada. Em vez de inventar um final, o modelo planeja o movimento entre as duas imagens, o que ajuda quando uma tomada precisa se ligar à seguinte.
Som incluído
O movimento vem com som correspondente: ondas, passos, uma risada ou uma fala entre aspas, gerados junto com a imagem sem custo extra. Acrescente uma linha Audio: se quiser certo estilo musical ou certo som de ambiente em vez do que a cena sugere.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 7,000 caracteres; um maior que isso é rejeitado. Coloque as falas entre aspas duplas. pelo menos 1 caracteres · no máximo 7000 caracteres |
image_url | Sim | Quadro inicial obrigatório. O clipe mantém a forma. |
last_image_url | Não | Quadro final opcional no qual o clipe termina. Não altera o preço. |
resolution | Não |
|
duration_seconds | Não | Número inteiro de segundos, entre 4 e 15, com 5 por padrão. Cobrado por segundo junto com a resolução. |
Preços
Cada segundo de saída é cobrado pela tarifa da resolução escolhida, 480p ou 768p. A tarifa atual sempre aparece na página do modelo.
| Especificação | Preço |
|---|---|
| $0.025 / segundo |
| $0.04 / segundo |
Casos de uso
Fotos de produto e de moda ganhando movimento
Uma foto de catálogo de uma jaqueta, uma bolsa ou um par de sapatos pode abrir um clipe curto no MiniMax H3 Lite: o modelo anda, gira ou pega o item enquanto a iluminação da sessão original se mantém, o que evita refazer a sessão para movimentos simples.
Dar vida a um retrato
Um único retrato vira um clipe curto com movimento natural e som no MiniMax H3 Lite, sem descrever o visual do zero. Basta um sorriso, um giro de cabeça ou um passo em direção à câmera para dar vida a uma foto de perfil ou a uma ficha de personagem.
Transições controladas
Com um quadro inicial e um final, o MiniMax H3 Lite preenche o movimento entre duas fotos, útil para tomadas de antes e depois, trocas de figurino ou momentos de história em que um personagem começa em uma pose e termina em outra.
Guia de prompt e dicas práticas
Descreva o próximo momento, não a imagem
O quadro já mostra quem e onde. Reserve o prompt para a ação, o movimento de câmera e o som que vêm a seguir, na ordem em que acontecem. Descrever a imagem outra vez costuma congelá-la, enquanto uma primeira ação clara, como ela se virar para a janela, a coloca em movimento.
Use quadros que cabem nos limites
Os quadros devem ter de 256 a 5,760 pixels por lado, com proporção largura-altura de 0.4 a 2.5; recorte panorâmicas extremas antes de enviar. Um quadro nítido e bem iluminado, com o sujeito bem visível, mantém os rostos mais estáveis do que uma imagem pequena ou muito comprimida.
Combine quadros que combinem
Um quadro final funciona melhor quando mostra as mesmas pessoas e o mesmo ambiente do inicial, com uma mudança que o prompt consiga explicar, como uma nova pose, um passo mais perto ou uma expressão diferente. Duas imagens sem relação forçam um salto parecido com um corte.
Cada segundo de saída é cobrado pela tarifa da resolução escolhida, 480p ou 768p. A tarifa atual sempre aparece na página do modelo.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-lite/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
