Introdução
Wan 3.0 Pro Prime Extensão de vídeo continua um clipe que você já tem. Envie-o como video_url e, se quiser, acrescente um prompt com o que acontece depois. O último quadro do clipe vira o quadro inicial de uma nova tomada de imagem para vídeo do Wan 3.0 Pro Prime de 2 a 30 segundos, e as duas partes são unidas 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 herda do mesmo jeito: o modelo vê uma imagem parada, não o clipe inteiro, então descreva o movimento que você quer continuar em vez de supor que ele manterá a velocidade ou a direção.
Você pode escolher o final. last_image_url é um quadro final de destino, opcional: o novo segmento termina exatamente nessa imagem, o que serve para um produto que precisa voltar ao ângulo principal ou para um movimento que precisa pousar em uma composição fixa. Sem ela, o modelo decide como a cena termina.
Os níveis são os do Wan 3.0 Pro Prime imagem para vídeo: 1080p, 2k e 4k. Uma renderização nativa chega no máximo a 1080p, então 2k e 4k são ampliados a partir dela, e não existe nível de 480p nem de 720p.
Você recebe um arquivo e, à parte, o trecho novo sozinho. O resultado unido é um MP4 H.264 com som AAC. Ele mantém a taxa de quadros e o enquadramento do seu clipe, sem barras pretas. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em alguns 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 som do seu original permanece, o som gerado para o novo segmento vem em seguida, e um lado sem som é completado com silêncio para que imagem e som continuem alinhados na emenda. O segundo recurso da saída é só o novo segmento, pronto para outra extensão ou para um editor.
Todo o resto é o Wan 3.0 Pro Prime imagem para vídeo: a mesma margem de conteúdo e o mesmo preço por segundo, e uma geração que falha é reembolsada da mesma forma. Se a geração der certo, mas a união não puder ser construída, a tarefa falha e o valor é reembolsado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional. Descreva o que acontece depois: a ação seguinte e o movimento de câmera. pelo menos 1 caracteres · no máximo 20000 caracteres |
video_url | Sim | O clipe a continuar: MP4, MOV ou WebM, até 60 segundos. O último quadro vira o quadro inicial do novo segmento, então corte-o em um quadro limpo e nítido. pelo menos 1 caracteres |
last_image_url | Não | Quadro final de destino, opcional: o novo segmento termina exatamente nesta imagem, usada como último quadro e não como orientação solta. pelo menos 1 caracteres |
resolution | Não | Nível de resolução do novo segmento: 1080p, 2k ou 4k, padrão 1080p. |
duration_seconds | Não | Duração do novo segmento: qualquer número inteiro de 2 a 30, ou -1 para o modelo escolher; nesse caso 30 segundos ficam reservados antes e a cobrança se ajusta à duração entregue. |
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 | Ativado por padrão. O prompt é expandido antes da geração, o que ajuda descrições curtas e atrapalha as precisas; desative quando o seu prompt já descrever a cena com exatidão. Valor padrão: |
seed | Não | De 0 a 2147483647. Mantenha-o fixo para comparar um campo alterado por vez; retire-o para ter variedade. |
Preços
Cobrado por segundo do novo segmento, no nível de resolução escolhido; o clipe original que você envia não é cobrado. Se o novo segmento for gerado, mas a união não puder ser construída, a tarefa falha e o valor integral é reembolsado.
| Especificação | Preço |
|---|---|
| $0.234 / segundo |
| $0.252 / segundo |
| $0.279 / 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 sujeito 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 de novo o resultado unido; cada passo cobra só os segundos que acrescenta. Como cada passo 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 tempo, não a cena inteira. O quadro já define quem e onde, então use o prompt para a ação seguinte e o movimento de câmera. Repita a linguagem de câmera com que o clipe terminou, como um avanço lento ou um plano fixo, para que a emenda pareça uma única tomada. O prompt é opcional; sem ele, o modelo continua só a partir do quadro.
Corte antes de estender. O último quadro é a única coisa que o modelo vê, então um final borrado, no meio de um corte 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 o nível de acordo com o seu original e defina duration_seconds com a duração de que você realmente precisa: a cobrança acompanha só o novo segmento. Ajuste o movimento em 1080p com um seed fixo antes de pagar por uma renderização em 2k ou 4k.
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": "alibaba/wan-3.0-pro-prime/video-extend",
"input": {
"duration_seconds": 5,
"resolution": "1080p",
"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.





















