Introdução
HunyuanVideo 1.5 Texto para vídeo transforma um prompt escrito em um clipe curto. O HunyuanVideo 1.5 é o modelo de vídeo aberto da Tencent com 8,3 bilhões de parâmetros; este endpoint devolve 5 ou 8 segundos em 480p ou 720p, na horizontal ou na vertical, com prompt negativo para artefatos. A plataforma não adiciona filtro de conteúdo ao prompt nem ao clipe.
Escolha um modo pelo material de partida
| O que você tem | Modo |
|---|---|
| uma descrição escrita | HunyuanVideo 1.5 Texto para vídeo |
| uma foto para animar | HunyuanVideo 1.5 Imagem para vídeo |
Recursos e destaques
Pessoas naturais em um modelo pequeno
O modelo tem 8,3 bilhões de parâmetros, mas, nos nossos testes, rostos, pele, cabelo e tecidos pareciam fotográficos e se moviam sem derreter.
Quatro tamanhos de quadro
aspect_ratio e resolution se combinam em 832 x 480, 480 x 832, 1280 x 720 ou 720 x 1280, de modo que os clipes verticais são compostos para a tela, e não cortados.
Prompt negativo
Liste o que você nunca quer ver. É a correção mais rápida para texto indesejado, mãos deformadas ou desfoque.
Sem censura
Nenhum filtro no prompt nem no resultado. Nos nossos testes, a maioria das sondas de conteúdo saiu como escrita; a mais forte teve parte da cena retida.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Descreva quem está em quadro, o que veste e faz, e o que a câmera faz. Uma ação clara por clipe funciona melhor. pelo menos 1 caracteres |
negative_prompt | Não | Lista opcional do que deve ficar de fora, como "blurry, distorted hands, extra limbs, text, watermark". Não altera o preço. |
aspect_ratio | Não | 16:9 para horizontal (o padrão) ou 9:16 para vertical. O formato não altera o preço. |
resolution | Não | 480p (832 x 480) ou 720p (1280 x 720, o padrão). O 720p custa o dobro por segundo; rascunhe em 480p. |
duration_seconds | Não | 5 ou 8 segundos, cobrados por segundo. |
seed | Não | Mantém as execuções comparáveis enquanto você muda uma coisa de cada vez. Não promete um clipe idêntico quadro a quadro. |
Preços
Cobrado por segundo de saída na resolução escolhida. A proporção não altera o preço.
| Especificação | Preço |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
Casos de uso
Clipes sociais verticais
9:16 em 720 x 1280 para feeds e stories.
Exploração de prompts
Em 480p, um rascunho de cinco segundos é barato, então você pode testar muitos prompts antes de levar a ideia para uma resolução maior.
Clipes sem filtro para a sua plataforma
Sem filtro de conteúdo no prompt nem no clipe, com apenas adultos em cena.
Guia de prompt e dicas práticas
Escreva o plano
Sujeito, figurino, ação, luz, câmera: nessa ordem, em duas a quatro frases.
Uma ação por clipe
Cinco segundos cabem um gesto ou um movimento. Sequências de ações se confundem.
Mantenha cenas de contato simples
Duas pessoas se tocando tendem a embaralhar os membros; movimento lento e um plano mais aberto ajudam.
Rascunhe pequeno
Rode a ideia em 480p com uma seed fixa e depois rode a vencedora de novo em 720p.
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": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
