Introdução
MiniMax H3 Max Imagem para vídeo anima um quadro inicial enviado em image_url em um clipe de 5 a 15 segundos inteiros em 480p ou 768p, com som gerado na mesma passada. Um last_image_url opcional fixa também o quadro final. O quadro inicial define o formato da saída, e uma requisição sem duração roda por 8 segundos.
Escolha o modo pelo material inicial
| Material inicial | Modo |
|---|---|
| uma imagem inicial aprovada | MiniMax H3 Max Imagem para vídeo |
| uma cena escrita ou um roteiro | MiniMax H3 Max Texto para vídeo |
Recursos e destaques
A imagem define assunto, figurino e formato
Este endpoint não tem campo de proporção de tela: a imagem que você envia decide o quadro do clipe. No exemplo laundromat-spin, nada sobre o ambiente, o figurino ou a luz chapada das lâmpadas fluorescentes foi escrito, porque o quadro inicial já resolveu tudo isso. O prompt descreve só a máquina entrando na centrifugação e a reação dela.
Fixe as duas pontas do plano
last_image_url acrescenta um quadro final e só pode ser enviado junto com image_url. O exemplo frame-to-frame começa em uma composição e chega a outra em oito segundos, e o clipe entra limpo na edição. O quadro final restringe o desfecho, não o meio, e dois quadros que discordam em luz ou figurino produzem uma negociação visível entre eles.
Mínimo de cinco segundos, duas resoluções
A duração vai de 5 a 15 segundos inteiros, com 8 como padrão. resolution aceita 480p ou 768p, com 768p como padrão; 480p custa menos por segundo e serve para rascunhos. Mesmo a requisição mais curta já é um momento completo: no clipe laundromat-spin cabem a centrifugação, uma risada, o balanço das pernas e um olhar para o tambor, tudo em cinco segundos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | O quadro de abertura. Ele fixa sujeito, figurino e composição, e define o formato de saída. |
last_image_url | Não | Quadro de fechamento opcional. Só válido junto com |
prompt | Sim | Descreva o que muda depois do quadro de abertura — ação, câmera, som — e não o quadro em si. pelo menos 1 caracteres · no máximo 7000 caracteres |
duration_seconds | Não | Segundos inteiros, de 5 a 15. Omitir dá 8. |
resolution | Não | 480p ou 768p; o padrão é 768p. As duas são renderizações nativas e 480p custa menos por segundo. |
enable_prompt_expansion | Não | Desligado por padrão, então o prompt é usado exatamente como foi escrito. Valor padrão: |
Preços
| Especificação | Preço |
|---|---|
| $0.05 / segundo |
| $0.08 / segundo |
Casos de uso
Inclinar a câmera de um objeto para uma pessoa
Um único movimento de câmera sem cortes transforma a ordem da revelação em todo o briefing. O exemplo grimoire-to-bare-shoulder começa em um livro aberto e sobe até a leitora na poltrona de encosto alto, enquanto a luz dos selos que sai das páginas passa pelo ombro dela, durante oito segundos. A imagem fixa a composição de abertura, então o prompt gasta as palavras com o que a câmera encontra e quando.
Terminar um clipe em uma composição conhecida
Quando a edição precisa que um clipe termine em um quadro específico, envie os dois. Prepare a imagem final como continuação da inicial e descreva a ação que liga as duas. Em frame-to-frame, essa ação é uma caminhada em direção à câmera por um corredor de mármore que termina com um olhar direto para a lente, com contraluz duro, máquina de vento e um drone grave de sintetizador.
Dar vida a uma cena de câmera parada
Um plano aberto fixo consegue carregar vários movimentos pequenos ao mesmo tempo. O prompt de laundromat-spin pede câmera travada, um tambor girando atrás do vidro e uma lâmpada fluorescente que pisca uma vez, junto com a reação da personagem, e um zumbido mecânico baixo no áudio.
Guia de prompt e dicas práticas
Descreva a mudança, não o quadro
Escreva o que acontece depois do quadro inicial e deixe a aparência com a imagem. "The washing machine under her shudders into its spin cycle and she bounces slightly with it" só nomeia movimento; nada ali repete o que a imagem já mostra. Se uma oração descreve algo visível no quadro, corte.
Especifique cada detalhe que importa
A expansão de prompt vem desligada, então o prompt é usado como foi escrito; com enable_prompt_expansion ligado, a MiniMax primeiro o expande em uma descrição mais completa do plano, do som e da música, podem aparecer detalhes que você não escreveu e a solicitação é cobrada pela tarifa de expansão de prompt. Nomeie explicitamente o movimento de câmera ("slow tilt, no cut"), a fonte de luz e o som, e mude uma coisa por execução para ver o efeito de cada mudança.
Recorte e combine os quadros antes do upload
Recorte a imagem inicial no formato de entrega, já que a saída a segue. Ao acrescentar um quadro final, mantenha assunto, figurino e luz contínuos entre as duas imagens e escolha uma duração suficiente para a ação que as liga. Em um clipe de 15 segundos o meio pode variar mesmo com as duas pontas fixas.
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-max/image-to-video",
"input": {
"duration_seconds": 8,
"enable_prompt_expansion": false,
"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.

















