Introdução
O Vidu Q3 Spicy imagem para vídeo anima um quadro inicial sem censura, com orientação de movimento opcional e áudio gerado na mesma passada.
O Vidu Q3 Spicy é uma versão do Vidu Q3 sem censura ajustada com LoRA, publicada como endpoints de imagem para vídeo e de video-extend; esta página trata o de imagem para vídeo. O quadro inicial que você envia carrega o conteúdo, o prompt é opcional e os clipes duram de 1 a 16 segundos em 540p, 720p ou 1080p.
Recursos e destaques
O que você aprova é o que ganha movimento
A única entrada é uma imagem, então não existe distância entre a cena que você aprovou e o que um prompt de texto aceita gerar. Figurino, corpo, pose e enquadramento vêm da imagem, e o trabalho do modelo é o movimento. Quadros sem censura passam como foram enviados, sem suavização.
Uma imagem sozinha já é uma solicitação completa
O prompt é opcional. Envie só o quadro e o modelo deduz um movimento pequeno e plausível, muitas vezes exatamente o que um loop precisa. Acrescente texto quando quiser um momento específico, como o olhar subindo para a câmera ou uma peça escorregando, e limite-se ao que muda em vez de descrever a imagem de novo.
Clipes verticais de até dezesseis segundos
Não há campo de proporção, então uma imagem 9:16 gera um clipe 9:16 e nada a reenquadra na saída. Com até dezesseis segundos e 1080p, isso cobre um momento vertical completo, com começo e fim, em vez de um fragmento de dois segundos.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Obrigatório. O still que anima — ele decide conteúdo e formato de saída, então acerte-o primeiro. |
prompt | Não | Opcional. Descreva a cena, a câmera e o som; não redescreva o quadro. |
duration_seconds | Não | Segundos inteiros, de 1 a 16. De um a quatro serve a loops; dezesseis cobre uma cena inteira. |
resolution | Não | 540p, 720p ou 1080p. Vem em 720p — peça 1080p quando for entregar. |
movement_amplitude | Não | auto, small, medium ou large. O auto se orienta pelo quadro inicial; aumente quando uma cena parada precisar de mais movimento. |
generate_audio | Não | Ligado por padrão. Ponha false para um loop mudo. Valor padrão: |
bgm | Não | Adiciona música de fundo ao clipe. Ligado por padrão. Valor padrão: |
Preços
| Especificação | Preço |
|---|---|
| $0.0665 / segundo |
| $0.1425 / segundo |
| $0.152 / segundo |
Casos de uso
Clipes sem censura que outras APIs recusam
Quadros são aceitos sem filtro de conteúdo e animados como chegam, então o material que APIs de vídeo hospedadas recusam no filtro de prompts roda aqui. Como o conteúdo está na imagem, o resultado corresponde ao quadro aprovado, não a uma reinterpretação suavizada das suas palavras.
Vídeo de companhia e roleplay
Uma imagem de personagem vira uma série de reações curtas, como um olhar para cima, um sorriso ou um ombro à mostra, mudando só o prompt. O quadro mantém identidade, figurino e cenário estáveis no conjunto inteiro, e é isso que faz um feed de companhia parecer contínuo.
Loops verticais para um feed pago
Uma imagem 9:16 vira um clipe vertical sem reenquadramento, de um a quatro segundos para um loop ou até dezesseis para uma cena. Faça vários rascunhos em 540p e depois gere em 1080p os dois que funcionarem melhor.
Guia de prompt e dicas práticas
Faça o quadro primeiro
Resolva figurino, corpo, pose e enquadramento numa passada de imagem e exporte a imagem no formato que quer entregar, com proporção entre 1:4 e 4:1. Não há campo para corrigir o formato depois; o que estiver na imagem é o que estará no clipe.
Defina quanto a cena se move
movement_amplitude aceita auto, small, medium ou large. auto se baseia no quadro inicial; aumente quando uma cena parada precisa se mexer mais e diminua para um loop em que só a respiração deve mudar. Coloque generate_audio em false para um loop sem som.
Adapte o exemplo incluído
O exemplo publicado usa duration_seconds 5, generate_audio true e resolution 720p.
She finishes pouring, sets the flask down and lifts her eyes to camera with a small smile, steam rising from the cup, the yukata sliding a fraction lower on her shoulder. Paper shoji glow, evening cicadas, very slow push-in.
Uma imagem mais uma nota de movimento: o gesto de servir, o olhar para a câmera e o ombro estão escritos, e tudo o que identifica a pessoa veio do quadro.
Rascunhe barato, finalize uma vez
Gere variações curtas em 540p a partir do mesmo quadro, escolha o movimento que funciona e gere de novo em 1080p com duração maior para a entrega. A resolução padrão é 720p, então peça 1080p explicitamente ao entregar.
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": "vidu/q3-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"movement_amplitude": "auto",
"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.











