Introdução
Vidu Q4 Preview Reference to video constrói uma cena a partir de 1 a 15 imagens de referência e até 3 clipes de voz. O Vidu Q4 Preview é a prévia pública do modelo de vídeo Q4 da Vidu. Os clipes rodam de 3 a 16 segundos, em 540p a 4k, em cinco proporções, com som gerado junto com a imagem. Este endpoint tem filtragem leve: a partir do nível Moderado, a maioria dos pedidos é suavizada ou recusada.
Escolha um modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um quadro para animar | Vidu Q4 Preview Imagem para vídeo |
| pessoas, figurinos, produtos ou lugares em imagens, com clipes de voz opcionais | Vidu Q4 Preview Referência para vídeo |
Recursos e destaques
Até 15 referências
Pessoas, figurinos, produtos e lugares podem entrar juntos. Nas nossas execuções, um rosto, uma peça de roupa e um ambiente voltaram como uma só cena.
Duas pessoas, ambas reconhecíveis
Dois retratos como referências mantiveram os dois rostos no mesmo plano.
Voz de referência
Até 3 clipes de áudio definem a voz. As palavras continuam vindo do prompt, então escreva a fala entre aspas.
Cinco formatos e cinco níveis
aspect_ratio oferece 16:9, 9:16, 1:1, 3:4 e 4:3; resolution vai de 540p a 4k, com o 2k e o 4k em HEVC de 10 bits.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 20.000 caracteres. Descreva a cena e cite as referências pela posição, como "a mulher da primeira imagem". pelo menos 1 caracteres · no máximo 20000 caracteres |
reference_image_urls | Sim | Obrigatório, de 1 a 15 imagens de pessoas, figurinos, produtos ou lugares. Um pedido sem nenhuma é rejeitado. pelo menos 1 itens · no máximo 15 itens |
reference_audio_urls | Não | Opcional, até 3 clipes de voz (a Vidu pede MP3, de 3 a 12 segundos cada). pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | 16:9 (o padrão), 9:16, 1:1, 3:4 ou 4:3. Não altera o preço. |
resolution | Não | 540p, 720p (o padrão), 1080p, 2k ou 4k. Isso define o preço por segundo: o 2k custa mais que o 1080p, e o 4k cerca do dobro do 2k. |
duration_seconds | Não | Segundos inteiros, de 3 a 16, padrão 5. Cobrado por segundo, junto com a resolução. |
generate_audio | Não | Ligado por padrão: diálogos, efeitos e ambiência são gerados junto com a imagem. Desligue para um clipe sem trilha de áudio. Valor padrão: |
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. Som, o número de imagens de referência e o número de clipes de áudio de referência não alteram o preço. Pedidos recusados não são cobrados.
| Especificação | Preço |
|---|---|
| $0.045 / segundo |
| $0.095 / segundo |
| $0.12 / segundo |
| $0.19 / segundo |
| $0.39 / segundo |
Casos de uso
Cenas de moda e de produto
Uma modelo, uma peça e um local em um só clipe.
Planos com duas pessoas
Uma conversa, uma chegada ou um quase-beijo com os dois rostos mantidos.
Personagens com voz
Um retrato, um clipe de voz e uma fala entre aspas.
Guia de prompt e dicas práticas
Cite pela posição
Diga "a mulher da primeira imagem" e "o roupão da segunda imagem".
Escreva a fala
Um clipe de voz não fornece as palavras. Coloque a fala entre aspas e diga que ela está na voz do áudio de referência.
Conheça o filtro
Os pedidos de nível Leve passaram, assim como um dos dois prompts de nível Máximo; a partir do nível Moderado, os demais foram recusados ou suavizados em nossos testes, e recusas não são cobradas. Para cenas além desses limites, use imagem para vídeo a partir de um quadro das pessoas.
Rascunhe em 540p
Teste o prompt em 540p e depois finalize em 1080p. Escolha 2k ou 4k apenas se você aguentar arquivos HEVC.
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/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"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.












