Introdução
MiniMax H3 Max Texto para vídeo transforma um prompt escrito em um clipe de 5 a 15 segundos inteiros em 480p ou 768p, com ambiência, foley e música gerados na mesma passada. A MiniMax descreve o H3 Max como a variante de geração rápida do H3. Dois padrões importam antes da primeira execução: a proporção de tela padrão é 1:1 e a duração padrão é 8 segundos, então defina os dois explicitamente se você tem um formato de entrega em mente.
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
Seis formatos, quadrado por padrão
aspect_ratio aceita 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16, com 1:1 como padrão, então um briefing widescreen enviado sem esse campo volta quadrado. O exemplo snow-train-window-hands foi feito para 21:9: um trem que atravessa toda a largura do quadro enquanto duas mãos se encontram dos dois lados do vidro do vagão, uma composição que não sobrevive a um recorte mais quadrado.
480p para rascunhos, 768p para o take final
resolution aceita 480p ou 768p, com 768p como padrão. Não há opção de 720p, 1080p ou 4K, e o schema rejeita esses valores antes de a requisição entrar na fila. 480p custa menos por segundo, então serve para testar texto, duração e enquadramento; o take que você for manter, renderize em 768p.
A expansão de prompt é opcional
enable_prompt_expansion vem desligado, então o prompt é renderizado como foi escrito. Quando ligado, a MiniMax primeiro expande um briefing curto 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. Os exemplos publicados contornam isso com precisão: o prompt de night-train-beckon nomeia veludo verde, latão polido, raiz de nogueira, um único abajur de leitura e o gesto exato que a câmera deve seguir.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Escreva como um plano: sujeito, movimento, câmera, luz, som — na ordem em que acontecem. pelo menos 1 caracteres · no máximo 7000 caracteres |
aspect_ratio | Não | Vem em 1:1. Ponha 21:9 para anamórfico e 9:16 para vertical. |
duration_seconds | Não | Segundos inteiros, de 5 a 15. Omitir dá 8, não 5. |
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
Moda e filmes de campanha
O exemplo silver-corridor é um plano de campanha construído com um parágrafo só: um vestido de prata líquida captando contraluz duro, cabelo movido por máquina de vento e, no fim, um olhar direto para a lente, em 21:9 por cinco segundos, com um drone grave de sintetizador no áudio. O movimento do tecido, a luz e o olhar final estão escritos; nada disso foi enviado como imagem.
Visuais de época pedidos pelo nome
A característica de uma película pode ser pedida diretamente. O exemplo roller-rink pede um visual dos anos 1970 com halation forte, cores desbotadas, granulação grossa e leve oscilação de quadro, e encaixa uma ação em duas partes em cinco segundos: uma volta lenta na pista e depois um deslize de costas em direção à câmera com os braços abertos.
Estudos de material e luz
Cenas em que várias superfícies reagem a uma luz em movimento combinam com um briefing escrito. Em night-train-beckon, as luzes da plataforma varrem com faixas um rosto, o cetim e as pernas enquanto a câmera avança com profundidade de campo muito rasa. Use um briefing assim para conferir se uma ideia de iluminação funciona antes de montar quadros iniciais para o image-to-video.
Guia de prompt e dicas práticas
Escreva o plano em ordem cronológica
Liste assunto, movimento, câmera, luz e som na ordem em que acontecem. O prompt de silver-corridor percorre o plano do primeiro passo até o olhar final, depois acrescenta a qualidade de imagem ("anamorphic 2.39:1, deep blacks, glossy specular highlights") e fecha com o som ("low synth drone").
Escreva os limites além da ação
Se ligar a expansão, escreva o que precisa ficar fixo além do que deve acontecer. O prompt de night-train-beckon termina com restrições claras: a camisola de cetim e as meias continuam no corpo do começo ao fim, e não há texto, logotipo nem outra pessoa no quadro. A prosa deixa figurino, corpo e enquadramento a cargo do modelo; sem esses detalhes por escrito, execuções consecutivas variam.
Passe para o image-to-video para um resultado literal
Quando um take acerta a ideia, mas o assunto não sai exatamente como foi desenhado, gere ou escolha uma imagem e passe para o image-to-video: um quadro inicial é seguido com muito mais fidelidade do que a mesma descrição em um prompt. Defina também a duração de propósito, porque sem ela você recebe 8 segundos, não 5.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "1:1",
"duration_seconds": 8,
"enable_prompt_expansion": false
}
}'
# 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.

















