Introdução
Extensão de vídeo com Wan 2.5. Envie o clipe que você quer continuar e descreva o que acontece depois: o último quadro do seu clipe vira o quadro inicial de uma nova cena Wan 2.5 de imagem para vídeo, e o original e o novo trecho voltam unidos em um único MP4. O campo opcional audio_url define apenas o som do novo trecho. Só os segundos novos são cobrados.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
| Desenvolvedora | Alibaba |
| Endpoints publicados | text-to-video, image-to-video, video-extend |
| Duração | 5 ou 10 segundos; padrão 5 |
| Resolução | 480p, 720p, 1080p; padrão 720p |
| Proporções | 16:9, 9:16, 1:1, 4:3, 3:4 no texto para vídeo; imagem para vídeo segue o quadro |
| Áudio | Gerado com a imagem; |
| Cobrança | Por segundo de vídeo, valor conforme a resolução |
Recursos e destaques
Entregue a fala e a boca acompanha
Todos os endpoints aceitam audio_url. Envie uma fala gravada ou uma deixa musical e o clipe gerado ajusta o movimento e o formato dos lábios a esse arquivo, em vez de inventar um ritmo próprio. É o jeito mais simples de fazer uma cena falada cair exatamente no texto já aprovado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional. O que acontece depois: a ação seguinte, o movimento de câmera e uma linha sobre o som. no máximo 1500 caracteres |
negative_prompt | Não | O que não pode aparecer no novo trecho: uma segunda pessoa, legendas, um objeto que o último quadro insiste em trazer. Até 500 caracteres. no máximo 500 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 trecho, então corte em um quadro limpo e nítido. pelo menos 1 caracteres |
resolution | Não | Resolução em que o novo segmento é gerado: 480p, 720p ou 1080p, padrão 720p. Use a resolução do original para não aparecer um salto de nitidez na emenda. |
duration_seconds | Não | Duração do novo trecho: exatamente 5 ou 10 segundos, padrão 5. O seu original entra antes e não é cobrado. |
audio_url | Não | Som para o novo trecho: uma fala ou um sinal musical a seguir, para que fala e batidas caiam onde você espera. WAV ou MP3, de 3 a 30 segundos e até 15 MB. pelo menos 1 caracteres |
enable_prompt_expansion | Não | Desativado por padrão. Ative para uma ideia de uma linha; deixe desligado quando o prompt já descreve uma ação precisa. Valor padrão: |
seed | Não | De 0 a 2147483647. Fixe para comparar resolução ou duração no mesmo clipe; para um sorteio aleatório, omita o campo em vez de enviar 0. |
Preços
Cobrado por segundo do novo trecho na resolução que você escolher; o clipe original que você envia não é cobrado.
| Especificação | Preço |
|---|---|
| $0.045 / segundo |
| $0.09 / segundo |
| $0.135 / segundo |
Casos de uso
Clipes curtos para redes, já com som
Escolha 9:16 no texto para vídeo, mantenha cinco segundos e receba a trilha dentro do arquivo. Não é preciso uma etapa separada de áudio antes de postar, o que torna viável produzir um lote diário de rascunhos.
Cenas faladas a partir de roteiro aprovado
Comece com um retrato em imagem para vídeo e passe a fala gravada como audio_url. O rosto vem do quadro e o ritmo vem do arquivo, então a revisão foca na atuação e não na sincronia labial.
Momentos de produto com uma única foto
Use a foto do produto como quadro inicial e descreva um único movimento de câmera. Rótulo e silhueta já estão fixados pela imagem; o prompt cuida só de luz e movimento, e um render em 1080p deixa folga para recortar.
Guia de prompt e dicas práticas
Escolha pelo material que você tem
Só uma ideia → texto para vídeo, em que
aspect_ratiodefine o formato. Uma imagem que você quer animar → imagem para vídeo, em que o clipe herda as proporções dela. Um clipe que você já tem continua com extensão de vídeo. Durações, resoluções e controles de áudio são iguais em todos.Feche a cena em 5 segundos e 720p
Assunto, uma ação, um movimento de câmera e uma frase sobre o som. Fixe a seed enquanto testa e depois gere de novo o take escolhido com 10 segundos ou em 1080p.
Envie de forma assíncrona
Crie a tarefa com uma Idempotency-Key, guarde o id da tarefa e consulte o status ou registre um callback. O vídeo pronto é servido pelo armazenamento da plataforma.
Introdução
Wan 2.5 Extensão de vídeo continua um clipe que você já tem. Envie-o em video_url e, se quiser, um prompt sobre o que acontece depois. O último quadro do seu clipe vira o quadro inicial de uma nova cena Wan 2.5 de imagem para vídeo de 5 ou 10 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 trecho 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 trecho começa literalmente no seu último quadro. O movimento não passa do mesmo jeito: o modelo vê uma única imagem estática, não o clipe inteiro, então descreva o movimento que você quer continuar em vez de supor que ele manterá velocidade ou direção.
Você recebe um arquivo e, à parte, o trecho novo. O MP4 unido 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 trecho é redimensionado para preencher o seu quadro, centralizado, e o que sobra é cortado. É codificado como MP4 H.264 com som AAC. O som do seu original permanece, o som do novo trecho vem em seguida, e um lado sem som é preenchido com silêncio para que imagem e som fiquem em sincronia na emenda. O segundo arquivo da saída é só o novo trecho, pronto para outra extensão ou para um editor.
Traga o seu próprio som para a parte nova. Passe audio_url e o novo trecho é construído sobre essa faixa, de modo que uma fala ou uma batida caia onde você espera. Ele molda apenas o novo trecho: o seu original mantém o som que tinha, e os dois são unidos como estão.
Todo o resto é Wan 2.5 imagem para vídeo. O novo trecho usa as mesmas rotas, com a mesma margem de conteúdo e o mesmo preço por segundo do endpoint de imagem para vídeo, e uma geração que falha é reembolsada do mesmo jeito. Se a geração der certo mas a emenda não puder ser montada, a tarefa falha e a cobrança é reembolsada.
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 a pessoa 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-a e depois estenda de novo o resultado unido; cada etapa cobra só os segundos que acrescenta. Como cada etapa parte de um único quadro, confira cada emenda antes de empilhar a próxima.
Guia de prompts e dicas
Descreva o próximo momento, não a cena inteira. O quadro já define quem e onde; 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 um avanço lento ou um plano fixo, para a emenda parecer uma única tomada. O prompt é opcional, mas uma linha de ação clara dá um movimento mais firme do que nenhuma.
Corte antes de estender. O último quadro é a única imagem que o modelo vê, então um final borrado, cortado no meio do movimento ou muito comprimido segue direto para a continuação. Corte primeiro o seu original em um quadro limpo e nítido. São aceitos originais de até 60 segundos em MP4, MOV ou WebM.
Combine a resolução com a do original. resolution define apenas a nitidez com que o novo trecho é gerado. Escolha a resolução do original e defina duration_seconds com a duração de que você realmente precisa: a cobrança segue só o novo trecho.
Use apenas material sobre o qual você tem direitos. Não crie conteúdo sexual envolvendo menores, imagens íntimas sem consentimento nem imitação enganosa de pessoas reais.
Direitos, consentimento, privacidade e uso permitido de cada prompt e de cada arquivo enviado são sua responsabilidade.
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-2.5/video-extend",
"input": {
"duration_seconds": 5,
"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.





















