Introdução
HunyuanVideo 1.5 Imagem para vídeo anima uma foto em um clipe de 5 ou 8 segundos em 480p ou 720p. O HunyuanVideo 1.5 é o modelo de vídeo aberto da Tencent com 8,3 bilhões de parâmetros. O clipe mantém o formato da sua foto, o prompt é opcional e a plataforma não adiciona filtro de conteúdo.
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
Rostos que resistem ao movimento
Nos nossos testes, as pessoas da foto mantiveram rosto, cabelo e figurino ao longo do clipe.
Qualquer formato
Não há campo de proporção: fotos verticais, quadradas ou widescreen voltam no próprio formato.
Prompt opcional
Envie só a foto e o modelo decide o movimento, ou descreva você mesmo o momento seguinte.
Sem censura
Nenhum filtro na foto, no prompt nem no clipe. 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 | Não | Opcional. Descreva o que a pessoa faz em seguida e o que a câmera faz; deixe em branco para o modelo animar a foto por conta própria. pelo menos 1 caracteres |
image_url | Sim | O quadro de abertura. O clipe parte desta foto e mantém a proporção dela; um link público e que possa ser baixado diretamente. |
resolution | Não | 480p ou 720p (o padrão). O 720p custa o dobro por segundo; o formato segue a sua foto. |
duration_seconds | Não | 5 ou 8 segundos, cobrados por segundo. |
seed | Não | Mantém as execuções comparáveis enquanto você muda o prompt. Não promete um clipe idêntico quadro a quadro. |
Preços
Cobrado por segundo de saída na resolução escolhida. O formato da sua foto não altera o preço.
| Especificação | Preço |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
Casos de uso
Retratos vivos
Um retrato que sorri, canta ou se vira para a câmera.
Fotos de produto e moda
Acrescente movimento de tecido, um deslocamento de câmera ou um giro a uma foto de catálogo.
Animar as imagens dos seus usuários sem filtro
Anime as imagens dos seus próprios usuários sem filtro de conteúdo, somente adultos.
Guia de prompt e dicas práticas
Descreva o momento seguinte
Escreva o que a pessoa faz depois que a foto foi tirada, não o que a foto mostra.
Diga o que deve permanecer
Se uma peça de roupa ou um objeto não pode mudar, diga isso no prompt.
Uma pessoa é mais fácil que duas
Duas pessoas em contato tendem a se embaralhar; mantenha o movimento lento.
Use um link limpo e público
A imagem precisa poder ser baixada diretamente; um link que exige login falha e não é cobrado.
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/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": "720p"
}
}'
# 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.








