Introdução
Wan 2.5 Imagem para vídeo transforma a imagem estática que você envia em image_url em um clipe de 5 ou 10 segundos com som. A imagem define sujeito, figurino, cenário, direção da luz e as proporções do clipe; o prompt opcional, com até 1.500 caracteres, descreve o que acontece depois. Este endpoint não tem campo de proporção, então recorte a imagem no formato de entrega antes de enviá-la. Se você só tem uma ideia escrita e nenhuma imagem, use o endpoint baseado em texto.
Escolha o modo do Wan 2.5 pelo material inicial
| O que você tem no início | Modo |
|---|---|
| uma cena ou um roteiro escrito | Wan 2.5 Texto para vídeo |
| uma imagem inicial aprovada | Wan 2.5 Imagem para vídeo |
Recursos e destaques
O quadro inicial define o visual
image_url aceita JPEG, PNG, BMP ou WebP de até 20 MB, com cada lado entre 240 e 8.000 pixels. O que já aparece nesse arquivo (um rótulo, uma silhueta, um figurino) não precisa ser descrito de novo, e o prompt pode gastar as palavras com movimento, câmera e som.
Áudio gerado com a imagem, ou no tempo da sua faixa
Todo clipe volta com som gerado junto com a imagem. Adicione audio_url, um WAV ou MP3 de 3 a 30 segundos e até 15 MB, quando uma fala gravada ou uma deixa musical deve definir o tempo: o rosto vem do quadro e o tempo da boca vem do áudio. Uma faixa mais longa que o clipe é cortada no final; uma mais curta deixa o restante em silêncio.
Duas durações e três resoluções
duration_seconds é exatamente 5 ou 10, e resolution é 480p, 720p (padrão) ou 1080p. Níveis mais altos custam mais por segundo e demoram mais para voltar. Clipes curtos seguram melhor mãos e cabelo, então acerte o movimento em cinco segundos antes de passar para dez.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | O quadro inicial. Assunto, figurino, cenário, direção da luz e proporções do clipe vêm dele, então recorte primeiro. pelo menos 1 caracteres |
prompt | Não | Opcional. O que acontece depois do quadro: uma ação, um comportamento de câmera e uma frase sobre o som. no máximo 1500 caracteres |
negative_prompt | Não | O que não pode aparecer: uma segunda pessoa, legendas, um objeto que a imagem insiste em trazer de volta. Até 500 caracteres; uma lista curta basta. no máximo 500 caracteres |
resolution | Não | 480p, 720p ou 1080p; padrão 720p. Faixas mais altas custam mais por segundo e demoram mais para voltar. |
duration_seconds | Não | Exatamente 5 ou 10. Clipes curtos seguram melhor mãos e cabelo: defina o visual em cinco segundos primeiro. |
audio_url | Não | Uma fala ou deixa musical para acompanhar, para que a voz e as 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 | Desligada por padrão. Ligue para uma ideia de uma linha; deixe desligada se o prompt já descreve uma ação precisa. Valor padrão: |
seed | Não | De 0 a 2147483647. Fixe ao comparar resolução ou duração a partir do mesmo quadro; para um valor aleatório, omita o campo em vez de enviar 0. |
Preços
| Especificação | Preço |
|---|---|
| $0.045 / segundo |
| $0.09 / segundo |
| $0.135 / segundo |
Casos de uso
Movimento de produto a partir de uma única foto
O exemplo publicado do frasco de sérum envia uma foto do produto e pede apenas um arco lento de câmera de um quarto de volta enquanto uma faixa de luz da janela desliza pelo vidro; o frasco em si não se move. Como o quadro já fixa rótulo e silhueta, o prompt carrega só luz e movimento, renderizados em 720p por cinco segundos.
Um retrato que fala uma frase gravada
Envie um retrato aprovado em image_url e a gravação da fala em audio_url. A aparência da pessoa vem da imagem e o tempo da boca vem do arquivo, então a revisão fica na interpretação, não na sincronia labial.
Uma tomada de estúdio mais longa com detalhes protegidos
O exemplo do vestido de alcinha roda dez segundos em 1080p a partir de um retrato de estúdio: uma troca de apoio, um giro em direção à lente e dois passos lentos, com câmera fixa. O prompt negativo, "extra people, text, jewellery changes", impede que as joias mudem ou que surjam mais pessoas ao longo da duração maior.
Chuva, água e outros sons com fonte visível
No exemplo do guarda-chuva, duas pessoas ficam quase paradas enquanto a chuva bate no guarda-chuva acima delas: o movimento é da água e o som tem uma fonte visível. Quando o evento é contínuo assim, cinco segundos costumam bastar.
Guia de prompt e dicas práticas
Prepare o quadro primeiro
Recorte no formato de entrega e confira se a imagem já mostra o figurino, o cenário e a luz que você quer. O clipe mantém as proporções e o visual da imagem, então um erro na foto vai direto para o vídeo.
Descreva só o movimento
O prompt é opcional, mas uma linha de ação clara deixa o movimento bem mais estável. Escreva uma ação, um comportamento de câmera e uma nota sobre o som. O que o quadro insiste em trazer de volta (uma segunda pessoa, legendas, um objeto) vai em negative_prompt. Ligue enable_prompt_expansion para uma ideia de uma linha e deixe desligado quando o prompt já descreve uma ação precisa.
Adapte o exemplo incluído
Comece pelo exemplo publicado com duration_seconds 5 e resolution 720p, usando a sua própria imagem acessível publicamente em image_url.
The camera arcs a slow quarter turn around the dropper bottle while a soft band of window light slides across the glass and the liquid inside catches it. The bottle itself does not move. Quiet room tone, no music.
O quadro fixa o rótulo e a silhueta; o prompt pede apenas um arco de câmera e uma luz em movimento.
Compare tomadas com seed fixo
Fixe seed ao comparar resolução ou duração a partir do mesmo quadro e mude um campo por execução. Para um resultado aleatório, omita o campo em vez de enviar 0. Reproduza o clipe inteiro com som antes da entrega.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "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.




























