Introdução
Vidu Q4 Preview Extensão de vídeo continua um clipe que você já tem. Envie-o como video_url com 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 Q4 Preview de 3 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 Q4 Preview. O novo segmento roda pelas mesmas rotas, com a mesma faixa de conteúdo e o mesmo preço por segundo do endpoint de imagem para vídeo, e uma geração com falha é reembolsada do mesmo jeito. Isso inclui as recusas: pedidos de nível Muito forte são recusados, e pedidos recusados não são cobrados. Se a geração der certo, mas a junção não puder ser montada, a tarefa falha e a cobrança é reembolsada.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 20.000 caracteres. O que acontece a seguir: a ação seguinte, o movimento de câmera e o som. pelo menos 1 caracteres · no máximo 20000 caracteres |
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 |
resolution | Não | Nitidez do novo segmento gerado: 540p, 720p, 1080p, 2k ou 4k, padrão 720p. |
duration_seconds | Não | Duração do novo segmento: qualquer número inteiro de 3 a 16. O padrão é 5. |
generate_audio | Não | Ativado por padrão, então o novo segmento vem com som gerado. Valor padrão: |
enable_prompt_expansion | Não | Desativado por padrão. Quando ativado, o modelo reescreve e amplia o seu prompt antes de gerar; deixe desativado para instruções literais. Valor padrão: |
seed | Não | De 0 a 2147483647. Mantenha fixa para comparar mudando um campo por vez; retire para ter variedade. |
Preços
Cobrado por segundo do novo segmento, na resolução escolhida; o clipe original que você envia não é cobrado. 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
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
Descreva o próximo momento, não a cena inteira. 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/q4-preview/video-extend",
"input": {
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.
