Introdução
Imagem para vídeo com o MiniMax H3 HighSpeed parte de uma imagem estática que você já tem e a anima em um MP4 de 4 a 15 segundos em 768p, com som. A imagem define o visual; o prompt só precisa dizer o que se move.
Escolha um modo pelo material de partida
| O que você tem | Modo |
|---|---|
| apenas uma ideia | MiniMax H3 HighSpeed Texto para vídeo |
| um quadro para animar, com um quadro final opcional | MiniMax H3 HighSpeed Imagem para vídeo |
| pessoas, figurinos, lugares, clipes de movimento ou vozes | MiniMax H3 HighSpeed Referência para vídeo |
Recursos e destaques
O quadro define o visual
Rostos, roupas, luz e composição vêm do seu quadro inicial. O clipe mantém o formato dele e não há campo de proporção, então corte a imagem no formato que quiser, horizontal ou vertical, antes de enviá-la.
Quadro final opcional
Acrescente last_image_url e o clipe termina nessa segunda imagem, dando a você um movimento controlado entre duas imagens estáticas. Isso ajuda quando uma cena precisa encaixar bem na seguinte.
Som incluído
O movimento chega com som correspondente, como ondas, passos, uma risada ou uma fala entre aspas, sem cobrança extra. Uma linha Audio: no prompt direciona o estilo musical ou o som ambiente do local.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório. Aceita de 1 a 7.000 caracteres e rejeita o que for mais longo. pelo menos 1 caracteres · no máximo 7000 caracteres |
image_url | Sim | Quadro inicial obrigatório; o clipe segue o seu formato. Cada lado deve medir de 256 a 5.760 pixels, com proporção largura-altura entre 0,4 e 2,5. |
last_image_url | Não | Quadro final opcional, no qual o clipe vem a terminar. Não acrescenta nada ao preço. |
resolution | Não |
|
duration_seconds | Não | Um número inteiro de 4 a 15 (padrão 5); cada segundo é cobrado pela tarifa de 768p. Uma solicitação de 4 segundos voltou como um clipe de 3,75 segundos. |
Preços
Você paga cada segundo do clipe pronto em 768p; a tarifa atual está na página do modelo.
| Especificação | Preço |
|---|---|
| $0.072 / segundo |
Casos de uso
Fotos de produto e moda que se movem
Uma foto de catálogo de uma jaqueta, bolsa ou par de sapatos pode abrir um clipe curto em que o item é vestido, girado ou pego, com a iluminação da sessão original.
Dar vida a um retrato
Um único retrato vira um clipe curto com um sorriso, uma virada de cabeça ou um passo em direção à câmera, o que basta 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 modelo preenche o movimento entre eles: cenas de antes e depois, trocas de figurino ou um personagem que 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
Use o prompt para acrescentar uma sequência curta ao quadro: um produto que gira em direção ao rótulo, um retrato que levanta o olhar, a câmera que se aproxima. Coloque primeiro a ação, depois a câmera e por fim o som.
Use quadros que cabem nos limites
Mantenha cada lado entre 256 e 5.760 pixels e a proporção largura-altura entre 0,4 e 2,5. A saída segue o formato do seu quadro em 768p, então confira rostos, rótulos e bordas no resultado antes de publicar.
Combine quadros que combinem
Dê ao quadro inicial e ao final o mesmo enquadramento e a mesma proporção, e planeje uma única transição que caiba em 4 a 15 segundos. Assista ao último segundo para ver se a cena termina no quadro final.
Você paga cada segundo do clipe pronto em 768p; a tarifa atual está 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-highspeed/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.
