Introdução
Wan 2.6 Imagem para vídeo parte do quadro que você envia em image_url e devolve exatamente 5, 10 ou 15 segundos em 720p ou 1080p, com som. O quadro define o sujeito, o figurino, o cenário, a direção da luz e as proporções do clipe. O prompt é opcional e comporta até 1.500 caracteres: uma ação para uma tomada única ou planos numerados para uma edição com vários planos.
Escolha o modo pelo material inicial
| O que você tem no início | Modo |
|---|---|
| uma cena ou um roteiro escrito | Wan 2.6 Texto para vídeo |
| uma imagem inicial aprovada | Wan 2.6 Imagem para vídeo |
| referências separadas de aparência, movimento ou som | Wan 2.6 Referências para vídeo |
Recursos e destaques
O quadro decide formato e aparência
Não existe campo de proporção: o clipe mantém as proporções da imagem que você envia, então uma entrega em 9:16 começa com um recorte em 9:16. O quadro pode ser JPEG, PNG sem transparência, BMP ou WEBP, com 240 a 8.000 pixels em cada lado e no máximo 20 MB. Tudo o que aparece nele já está decidido, o que deixa o prompt livre para descrever o movimento.
Cobertura cortada de um único quadro
Com shot_type em multi, o modelo pode cortar entre ângulos mantendo o visual do quadro inicial, então um clipe de quinze segundos pode trazer um plano de ambientação, um detalhe e um desfecho em vez de um único movimento de câmera à deriva. Uma solicitação multi sempre roda com a expansão do prompt ligada. Fique no single para giros de produto, pessoas falando para a câmera e tudo o que precisa continuar contínuo, porque o multi quebra a continuidade de propósito.
Som gerado ou enviado por você
O clipe volta com áudio gerado na mesma passada que a imagem. Para que a fala ou as batidas da música caiam onde você espera, envie audio_url: WAV ou MP3, de 3 a 30 segundos, até 15 MB. Uma faixa mais longa é cortada na duração do clipe; com uma mais curta, o resto do clipe fica em silêncio.
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. |
prompt | Não | Opcional. Uma ação para tomada contínua ou planos numerados para edição multiplano. pelo menos 1 caracteres · 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. no máximo 500 caracteres |
resolution | Não | 720p ou 1080p; padrão 720p. Define o preço por segundo e o tempo de processamento. |
duration_seconds | Não | Exatamente 5, 10 ou 15. A edição multiplano precisa das durações maiores para funcionar bem. |
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. |
shot_type | Não | single mantém uma tomada contínua; multi deixa o modelo cortar entre planos, bom para histórias curtas, mas sem continuidade. |
enable_prompt_expansion | Não | Desligada por padrão. Ligada, transforma uma ideia de uma linha em lista de planos para multi; deixe desligada se o prompt já for preciso. Valor padrão: |
seed | Não | De 0 a 2147483647. Fixe ao comparar single e multi a partir do mesmo quadro. |
Preços
| Especificação | Preço |
|---|---|
| $0.09 / segundo |
| $0.135 / segundo |
Casos de uso
Um macro de produto que não pode pular
O exemplo do sérum anima uma foto de um frasco conta-gotas por cinco segundos em 1080p com seed fixo. Uma única gota cai da ponta do conta-gotas, anéis se espalham pelo líquido e a faixa de luz no vidro clareia um pouco, tudo em enquadramento macro travado com um leve tilintar de vidro. Ele continua como tomada única porque um plano de produto não deve cortar entre ângulos.
Uma história curta de interior a partir de uma foto
O exemplo do apartamento ao anoitecer tem 15 segundos em 720p, com shot_type em multi e expansão do prompt ligada. Um único quadro de interior rende três planos: o abajur pisca enquanto as luzes da cidade se acendem lá fora, uma manta dobrada escorrega da poltrona e a porta de entrada se abre, espalhando a luz do corredor pelo assoalho, sob o silêncio do ambiente e o trânsito distante.
Um personagem falando a sua própria fala
Combine a imagem de um personagem com uma fala gravada em audio_url para que a voz caia onde você espera, e não como um movimento genérico. Pessoas falando para a câmera ficam no single, e vale conferir a duração inteira: quando a faixa é mais curta que o clipe, o restante toca em silêncio.
Guia de prompt e dicas práticas
Prepare o quadro antes de escrever uma palavra
Recorte no formato de entrega e confira se o quadro já mostra o figurino, o cenário e a luz que você quer, porque nenhum prompt salva um primeiro quadro errado. Tire textos sobrepostos ou um segundo sujeito que você não quer animar, e use negative_prompt, com até 500 caracteres, para o que o quadro insiste em trazer de volta, como um objeto de cena ou texto na tela.
Descreva o movimento, não o que já está visível
Para uma tomada única, escreva uma ação e um movimento de câmera. O prompt do sérum cita a gota, os anéis, a mudança na faixa de luz, o enquadramento e um som, e não diz nada sobre o formato do frasco ou o rótulo, porque o quadro já traz os dois.
A single drop falls from the dropper tip into the bottle and sends slow rings across the liquid surface; the light band on the glass brightens a little. Locked macro framing, soft chime of glass.
Planeje uma edição com vários planos
Escreva planos numerados, cada um com o próprio enquadramento, e escolha 10 ou 15 segundos para que os cortes tenham espaço. Escolher multi liga enable_prompt_expansion naquela solicitação. Na tomada única ele fica desligado por padrão, e um prompt preciso é enviado exatamente como foi escrito.
Compare single e multi a partir do mesmo quadro
Fixe seed, que aceita de 0 a 2147483647, mantenha o quadro e o prompt inalterados e rode a solicitação uma vez como single e outra como multi para ver qual serve melhor ao plano. A resolução define a tarifa por segundo e quanto tempo a tarefa leva, então acerte o texto em 720p antes de renderizar em 1080p. Um seed fixo estabiliza a comparação sem prometer uma repetição idêntica quadro a quadro.
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.6/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "720p",
"shot_type": "single"
}
}'
# 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.




























