Introdução
Texto para vídeo com o MiniMax H3 HighSpeed transforma um prompt escrito em um MP4 de 4 a 15 segundos em 768p, com o som gerado na mesma etapa. Não há resolução para escolher, então por clipe você decide a ideia, o formato do quadro e a duração.
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
Som e diálogo em uma só passagem
Cada clipe chega com som. As palavras entre aspas duplas são ditas pelo personagem que você nomear, e o ambiente ou a música seguem o que você descrever, então uma cena curta não precisa de uma etapa de áudio depois.
Seis proporções
Escolha 16:9, 9:16, 1:1, 4:3, 3:4 ou 21:9 a cada solicitação. A tarifa não muda, então o mesmo prompt pode gerar uma versão larga para o feed e uma vertical para Reels ou Shorts.
Uma tarifa fixa
A $0.072 por segundo, um clipe de 6 segundos custa $0.432 e um de 10 segundos, $0.72. Com uma única resolução, dá para calcular o custo de uma fila diária inteira antes de começar.
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 |
aspect_ratio | Não | Formato do quadro: 16:9 por padrão, ou 9:16, 1:1, 4:3, 3:4 ou 21:9. Não afeta o 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
Posts diários para redes sociais
Um clipe 9:16 de 5 a 8 segundos com uma fala curta e algum ambiente vai direto para um post. Mantenha o cenário de um dia para o outro e mude apenas a ação e a fala.
Variações de produto e anúncios
Escreva a mesma cena de produto com um movimento de câmera, um clima ou uma fala diferente em cada prompt e publique as tomadas que funcionarem melhor. Cada uma é um arquivo pronto em 768p.
Entrega rápida para clientes
Quando um cliente ou uma tendência não pode esperar, um clipe em cerca de 22 a 35 segundos (nossos clipes de teste de 4 segundos) é rápido o bastante para revisar e ajustar várias vezes em uma única sessão.
Guia de prompt e dicas práticas
Escreva a cena em ordem
Diga quem está ali, o que faz primeiro e depois, onde fica a câmera e acrescente uma linha Audio: para o som. Uma sequência clara se move melhor que uma lista de adjetivos; nomear a luz, como golden hour ou neon, define o clima rápido.
Mantenha a fala curta
Uma ou duas falas entre aspas cabem em um clipe de 5 a 8 segundos. Nomeie quem fala em cada fala e divida um discurso mais longo entre vários clipes, em vez de comprimi-lo.
Ajuste a duração à ação
Um único gesto funciona bem em 4 a 6 segundos; para clipes mais longos, acrescente um segundo momento para a cena continuar em movimento. No nosso teste, uma solicitação de 4 segundos voltou com 3,75 segundos.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.
