Introdução
Vidu Q3 Spicy Extensão de vídeo continua um clipe que você já tem. Envie-o como video_url, com ou sem um prompt sobre o que acontece a seguir. O último quadro do seu clipe vira o quadro inicial de uma nova cena de imagem para vídeo do Vidu Q3 Spicy de 1 a 16 segundos, e os dois são unidos em um único MP4: primeiro o seu original, depois a continuação, sem o quadro repetido na emenda. O novo segmento também volta como arquivo próprio, para você continuar estendendo ou editar as partes separadamente.
Recursos e destaques
A continuidade vem do último quadro. Figurino, cenário, luz e a posição de cada pessoa se mantêm porque o novo segmento começa literalmente no seu último quadro. O movimento não se mantém do mesmo jeito: o modelo vê uma imagem parada, não o clipe inteiro. Descreva o movimento que você quer continuar em vez de supor que ele manterá a velocidade ou a direção.
Um arquivo de volta, mais a peça nova separada. O MP4 unido mantém a taxa de quadros e o enquadramento do seu clipe, sem faixas pretas. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em poucos pontos percentuais nas bordas. Se o modelo devolver uma proporção bem diferente, o novo segmento é redimensionado para preencher o seu quadro, centralizado, e o que sobra é cortado. O arquivo é codificado como MP4 H.264 com áudio AAC. O som do seu original permanece, o som gerado para o novo segmento vem em seguida, e um lado mudo é completado com silêncio para que imagem e som continuem em sincronia na emenda. O segundo ativo da saída é o novo segmento sozinho, pronto para outra extensão ou para um editor.
Todo o resto é imagem para vídeo do Vidu Q3 Spicy. O novo segmento roda nas mesmas rotas, com o mesmo alcance de conteúdo e o mesmo preço por segundo do endpoint de imagem para vídeo, e uma geração que falha é reembolsada da mesma forma. Se a geração der certo, mas a emenda em si não puder ser construída, a tarefa falha e a cobrança é reembolsada.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe a continuar: MP4, MOV ou WebM, de até 60 segundos. O último quadro dele vira o quadro inicial do novo segmento, então corte em um quadro limpo e nítido. pelo menos 1 caracteres |
prompt | Não | Opcional. O que acontece a seguir: a ação seguinte, o movimento de câmera e o som. |
duration_seconds | Não | Duração do novo segmento: qualquer número inteiro de 1 a 16. O padrão é 5. |
resolution | Não | Nitidez do novo segmento gerado: 540p, 720p ou 1080p, padrão 720p. |
movement_amplitude | Não | O quanto as coisas se movem no novo segmento: |
generate_audio | Não | Ativado por padrão, então o novo segmento vem com som gerado. Valor padrão: |
bgm | Não | Adiciona uma base de música de fundo ao novo segmento. Ativado por padrão; desative para manter só o som da própria cena. Valor padrão: |
Preços
Cobrado por segundo do novo segmento, na resolução escolhida; o clipe original que você envia não é cobrado.
| Especificação | Preço |
|---|---|
| $0.0665 / segundo |
| $0.1425 / segundo |
| $0.152 / segundo |
Casos de uso
Alongue uma cena que terminou cedo demais: um prato giratório de produto que para antes de o rótulo ficar de frente para a câmera, ou uma caminhada cortada antes de o personagem chegar à porta. Estenda por alguns segundos e descreva só o movimento que falta.
Monte uma sequência mais longa passo a passo. Gere uma primeira cena, estenda e depois estenda o resultado unido de novo enquanto ele ficar dentro do limite de 60 segundos para o original; cada etapa cobra apenas os segundos que acrescenta. Como cada etapa parte de um único quadro, confira cada emenda antes de empilhar a próxima.
Guia de prompt e dicas práticas
Escreva um prompt só quando quiser orientar a continuação; uma linha curta sobre o próximo momento basta. O quadro já define quem e onde, então use o prompt para a ação seguinte, o movimento de câmera e o som. Repita a linguagem de câmera com que o seu clipe terminou, como uma aproximação lenta ou um plano fixo, para a emenda parecer uma única tomada.
Apare antes de estender. O último quadro é a única coisa que o modelo vê, então um final borrado, cortado no meio do movimento ou muito comprimido passa direto para a continuação. Corte primeiro o seu original em um quadro limpo e nítido. Originais de até 60 segundos são aceitos em MP4, MOV ou WebM.
Mantenha a resolução consistente. A resolução define apenas a nitidez com que o novo segmento é gerado, então uma configuração menor deixa a parte nova mais suave que o original. Combine a resolução com a da origem e defina duration_seconds com a duração de que você realmente precisa: a cobrança acompanha apenas o novo segmento.
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/video-extend",
"input": {
"duration_seconds": 5,
"movement_amplitude": "auto",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.




